`CDC`-Klasse

Artikel
07/05/2024

Definiert eine Klasse von Gerätekontextobjekten.

Syntax

class CDC : public CObject

Member

Öffentliche Konstruktoren

Name	Beschreibung
`CDC::CDC`	Erstellt ein `CDC`-Objekt.

Öffentliche Methoden

Name	Beschreibung
`CDC::AbortDoc`	Beendet den aktuellen Druckauftrag und löscht alles, was die Anwendung seit dem letzten Aufruf der `StartDoc` Memberfunktion auf das Gerät geschrieben hat.
`CDC::AbortPath`	Schließt alle Pfade im Gerätekontext und verwirft sie.
`CDC::AddMetaFileComment`	Kopiert den Kommentar aus einem Puffer in eine angegebene Metadatei im erweiterten Format.
`CDC::AlphaBlend`	Zeigt Bitmaps mit transparenten oder halbtransparenten Pixeln an.
`CDC::AngleArc`	Zeichnet ein Liniensegment und einen Bogen und verschiebt die aktuelle Position an den Endpunkt des Bogens.
`CDC::Arc`	Zeichnet einen elliptischen Bogen.
`CDC::ArcTo`	Zeichnet einen elliptischen Bogen. Diese Funktion ähnelt `Arc`, mit der Ausnahme, dass die aktuelle Position aktualisiert wird.
`CDC::Attach`	Fügt einen Windows-Gerätekontext an dieses `CDC` Objekt an.
`CDC::BeginPath`	Öffnet eine Pfadklammer im Gerätekontext.
`CDC::BitBlt`	Kopiert eine Bitmap aus einem angegebenen Gerätekontext.
`CDC::Chord`	Zeichnet einen Chor (eine geschlossene Figur, die durch den Schnittpunkt einer Ellipse und eines Liniensegments begrenzt ist).
`CDC::CloseFigure`	Schließt eine geöffnete Abbildung in einem Pfad.
`CDC::CreateCompatibleDC`	Erstellt einen Speichergerätekontext, der mit einem anderen Gerätekontext kompatibel ist. Sie können es verwenden, um Bilder im Arbeitsspeicher vorzubereiten.
`CDC::CreateDC`	Erstellt einen Gerätekontext für ein bestimmtes Gerät.
`CDC::CreateIC`	Erstellt einen Informationskontext für ein bestimmtes Gerät. Dies bietet eine schnelle Möglichkeit, Informationen über das Gerät abzurufen, ohne einen Gerätekontext zu erstellen.
`CDC::DeleteDC`	Löscht den Windows-Gerätekontext, der diesem `CDC` Objekt zugeordnet ist.
`CDC::DeleteTempMap`	Wird vom `CWinApp` Leerlaufzeithandler aufgerufen, um alle temporären `CDC` Objekte zu löschen, die von `FromHandle`. Trennt auch den Gerätekontext.
`CDC::Detach`	Trennt den Windows-Gerätekontext von diesem `CDC` Objekt.
`CDC::DPtoHIMETRIC`	Konvertiert Geräteeinheiten in `HIMETRIC` Einheiten.
`CDC::DPtoLP`	Konvertiert Geräteeinheiten in logische Einheiten.
`CDC::Draw3dRect`	Zeichnet ein dreidimensionales Rechteck.
`CDC::DrawDragRect`	Löscht ein Rechteck, während es gezogen wird.
`CDC::DrawEdge`	Zeichnet die Kanten eines Rechtecks.
`CDC::DrawEscape`	Greift auf Zeichenfunktionen einer Videoanzeige zu, die nicht direkt über die Grafikgeräteschnittstelle (Graphics Device Interface, GDI) verfügbar sind.
`CDC::DrawFocusRect`	Zeichnet ein Rechteck in der Formatvorlage, das verwendet wird, um den Fokus anzugeben.
`CDC::DrawFrameControl`	Zeichnen Sie ein Frame-Steuerelement.
`CDC::DrawIcon`	Zeichnet ein Symbol.
`CDC::DrawState`	Zeigt ein Bild an und wendet einen visuellen Effekt an, um einen Zustand anzuzeigen.
`CDC::DrawText`	Zeichnet formatierten Text im angegebenen Rechteck.
`CDC::DrawTextEx`	Zeichnet formatierten Text im angegebenen Rechteck mit anderen Formaten.
`CDC::Ellipse`	Zeichnet eine Ellipse.
`CDC::EndDoc`	Beendet einen Druckauftrag, der von der `StartDoc` Memberfunktion gestartet wurde.
`CDC::EndPage`	Informiert den Gerätetreiber darüber, dass eine Seite beendet ist.
`CDC::EndPath`	Schließt eine Pfadklammer und wählt den durch die Klammer definierten Pfad in den Gerätekontext aus.
`CDC::EnumObjects`	Listet die Stifte und Pinsel auf, die in einem Gerätekontext verfügbar sind.
`CDC::Escape`	Ermöglicht Anwendungen den Zugriff auf Einrichtungen, die nicht direkt von einem bestimmten Gerät über GDI verfügbar sind. Ermöglicht auch den Zugriff auf Windows-Escapefunktionen. Escapeaufrufe von einer Anwendung werden übersetzt und an den Gerätetreiber gesendet.
`CDC::ExcludeClipRect`	Erstellt einen neuen Beschneidungsbereich, der aus dem vorhandenen Clippingbereich abzüglich des angegebenen Rechtecks besteht.
`CDC::ExcludeUpdateRgn`	Verhindert das Zeichnen innerhalb ungültiger Bereiche eines Fensters, indem ein aktualisierter Bereich im Fenster von einem Beschneidungsbereich ausgeschlossen wird.
`CDC::ExtFloodFill`	Füllt einen Bereich mit dem aktuellen Pinsel aus. Bietet mehr Flexibilität als die `CDC::FloodFill` Memberfunktion.
`CDC::ExtTextOut`	Schreibt eine Zeichenfolge in einem rechteckigen Bereich mithilfe der aktuell ausgewählten Schriftart.
`CDC::FillPath`	Schließt alle geöffneten Figuren im aktuellen Pfad und füllt das Innere des Pfads mithilfe des aktuellen Pinsel- und Polygonfüllmodus aus.
`CDC::FillRect`	Füllt ein bestimmtes Rechteck mithilfe eines bestimmten Pinsels aus.
`CDC::FillRgn`	Füllt einen bestimmten Bereich mit dem angegebenen Pinsel.
`CDC::FillSolidRect`	Füllt ein Rechteck mit einer Volltonfarbe aus.
`CDC::FlattenPath`	Wandelt alle Kurven im ausgewählten Pfad in den aktuellen Gerätekontext um und wandelt jede Kurve in eine Folge von Linien um.
`CDC::FloodFill`	Füllt einen Bereich mit dem aktuellen Pinsel aus.
`CDC::FrameRect`	Zeichnet einen Rahmen um ein Rechteck.
`CDC::FrameRgn`	Zeichnet einen Rahmen um einen bestimmten Bereich mithilfe eines Pinsels.
`CDC::FromHandle`	Gibt einen Zeiger auf ein `CDC` Objekt zurück, wenn ein Handle auf einen Gerätekontext übergeben wird. Wenn ein `CDC` Objekt nicht an das Handle angefügt ist, wird ein temporäres `CDC` Objekt erstellt und angefügt.
`CDC::GetArcDirection`	Gibt die aktuelle Bogenrichtung für den Gerätekontext zurück.
`CDC::GetAspectRatioFilter`	Ruft die Einstellung für den aktuellen Seitenverhältnisfilter ab.
`CDC::GetBkColor`	Ruft die aktuelle Hintergrundfarbe ab.
`CDC::GetBkMode`	Ruft den Hintergrundmodus ab.
`CDC::GetBoundsRect`	Gibt das aktuelle angesammelte Begrenzungsrechteck für den angegebenen Gerätekontext zurück.
`CDC::GetBrushOrg`	Ruft den Ursprung des aktuellen Pinsels ab.
`CDC::GetCharABCWidths`	Ruft die Breite in logischen Einheiten von aufeinander folgenden Zeichen in einem bestimmten Bereich aus der aktuellen Schriftart ab.
`CDC::GetCharABCWidthsI`	Ruft die Breite in logischen Einheiten von aufeinander folgenden Glyphenindizes in einem angegebenen Bereich aus der aktuellen TrueType-Schriftart ab.
`CDC::GetCharacterPlacement`	Ruft verschiedene Typen von Informationen zu einer Zeichenfolge ab.
`CDC::GetCharWidth`	Ruft die Bruchbreiten aufeinander folgender Zeichen in einem bestimmten Bereich aus der aktuellen Schriftart ab.
`CDC::GetCharWidthI`	Ruft die Breite in logischen Koordinaten von aufeinander folgenden Glyphenindizes in einem angegebenen Bereich von der aktuellen Schriftart ab.
`CDC::GetClipBox`	Ruft die Abmessungen des strengsten Begrenzungsrechtecks um die aktuelle Beschneidungsgrenze ab.
`CDC::GetColorAdjustment`	Ruft die Farbanpassungswerte für den Gerätekontext ab.
`CDC::GetCurrentBitmap`	Gibt einen Zeiger auf das aktuell ausgewählte `CBitmap` Objekt zurück.
`CDC::GetCurrentBrush`	Gibt einen Zeiger auf das aktuell ausgewählte `CBrush` Objekt zurück.
`CDC::GetCurrentFont`	Gibt einen Zeiger auf das aktuell ausgewählte `CFont` Objekt zurück.
`CDC::GetCurrentPalette`	Gibt einen Zeiger auf das aktuell ausgewählte `CPalette` Objekt zurück.
`CDC::GetCurrentPen`	Gibt einen Zeiger auf das aktuell ausgewählte `CPen` Objekt zurück.
`CDC::GetCurrentPosition`	Ruft die aktuelle Position des Stifts (in logischen Koordinaten) ab.
`CDC::GetDCBrushColor`	Ruft die aktuelle Pinselfarbe ab.
`CDC::GetDCPenColor`	Ruft die aktuelle Stiftfarbe ab.
`CDC::GetDeviceCaps`	Ruft eine bestimmte Art von gerätespezifischen Informationen zu den Funktionen eines bestimmten Anzeigegeräts ab.
`CDC::GetFontData`	Ruft Schriftmetrikinformationen aus einer skalierbaren Schriftartdatei ab. Die abzurufenden Informationen werden durch Angabe eines Offsets in der Schriftartdatei und der Länge der zurückzugebenden Informationen identifiziert.
`CDC::GetFontLanguageInfo`	Gibt Informationen zur aktuell ausgewählten Schriftart für den angegebenen Anzeigekontext zurück.
`CDC::GetGlyphOutline`	Ruft die Gliederungskurve oder Bitmap für ein Gliederungszeichen in der aktuellen Schriftart ab.
`CDC::GetGraphicsMode`	Ruft den aktuellen Grafikmodus für den angegebenen Gerätekontext ab.
`CDC::GetHalftoneBrush`	Ruft einen Halbtonpinsel ab.
`CDC::GetKerningPairs`	Ruft die Zeichenkerningpaare für die Schriftart ab, die derzeit im angegebenen Gerätekontext ausgewählt ist.
`CDC::GetLayout`	Ruft das Layout eines Gerätekontexts (DC) ab. Das Layout kann entweder von links nach rechts (Standard) oder von rechts nach links (gespiegelt) sein.
`CDC::GetMapMode`	Ruft den aktuellen Zuordnungsmodus ab.
`CDC::GetMiterLimit`	Gibt den Mitergrenzwert für den Gerätekontext zurück.
`CDC::GetNearestColor`	Ruft die nächstgelegene logische Farbe zu einer angegebenen logischen Farbe ab, die das angegebene Gerät darstellen kann.
`CDC::GetOutlineTextMetrics`	Ruft Schriftmetrikinformationen für TrueType-Schriftarten ab.
`CDC::GetOutputCharWidth`	Ruft die Breite einzelner Zeichen in einer aufeinander folgenden Gruppe von Zeichen aus der aktuellen Schriftart mithilfe des Ausgabegerätekontexts ab.
`CDC::GetOutputTabbedTextExtent`	Berechnet die Breite und Höhe einer Zeichenfolge im Ausgabegerätekontext.
`CDC::GetOutputTextExtent`	Berechnet die Breite und Höhe einer Textzeile im Ausgabegerätekontext mithilfe der aktuellen Schriftart, um die Abmessungen zu bestimmen.
`CDC::GetOutputTextMetrics`	Ruft die Metriken für die aktuelle Schriftart aus dem Ausgabegerätekontext ab.
`CDC::GetPath`	Ruft die Koordinaten ab, die die Endpunkte von Linien und die Kontrollpunkte von Kurven definieren, die im Pfad gefunden werden, der im Gerätekontext ausgewählt ist.
`CDC::GetPixel`	Ruft den RGB-Farbwert des Pixels am angegebenen Punkt ab.
`CDC::GetPolyFillMode`	Ruft den aktuellen Polygonfüllmodus ab.
`CDC::GetROP2`	Ruft den aktuellen Zeichnungsmodus ab.
`CDC::GetSafeHdc`	Gibt den Ausgabegerätekontext zurück `CDC::m_hDC`.
`CDC::GetStretchBltMode`	Ruft den aktuellen Bitmapdehnungsmodus ab.
`CDC::GetTabbedTextExtent`	Berechnet die Breite und Höhe einer Zeichenfolge im Attributgerätekontext.
`CDC::GetTextAlign`	Ruft die Textausrichtungskennzeichnungen ab.
`CDC::GetTextCharacterExtra`	Ruft die aktuelle Einstellung für die Menge der Intercharacter-Abstände ab.
`CDC::GetTextColor`	Ruft die aktuelle Textfarbe ab.
`CDC::GetTextExtent`	Berechnet die Breite und Höhe einer Textzeile im Attributgerätekontext mithilfe der aktuellen Schriftart, um die Abmessungen zu bestimmen.
`CDC::GetTextExtentExPointI`	Ruft die Anzahl der Zeichen in einer angegebenen Zeichenfolge ab, die in ein angegebenes Leerzeichen passt, und füllt ein Array mit der Textgröße für jedes dieser Zeichen aus.
`CDC::GetTextExtentPointI`	Ruft die Breite und Höhe des angegebenen Arrays von Glyphenindizes ab.
`CDC::GetTextFace`	Kopiert den Schriftartnamen der aktuellen Schriftart in einen Puffer als null-beendete Zeichenfolge.
`CDC::GetTextMetrics`	Ruft die Metriken für die aktuelle Schriftart aus dem Attributgerätekontext ab.
`CDC::GetViewportExt`	Ruft die x- und y-Erweiterung des Viewports ab.
`CDC::GetViewportOrg`	Ruft die x- und y-Koordinaten des Viewportursprungs ab.
`CDC::GetWindow`	Gibt das Fenster zurück, das dem Anzeigegerätekontext zugeordnet ist.
`CDC::GetWindowExt`	Ruft die x- und y-Erweiterung des zugeordneten Fensters ab.
`CDC::GetWindowOrg`	Ruft die x- und y-Koordinaten des Ursprungs des zugeordneten Fensters ab.
`CDC::GetWorldTransform`	Ruft die aktuelle Weltfläche zur Seitenbereichtransformation ab.
`CDC::GradientFill`	Füllt Rechteck- und Dreiecksstrukturen mit einer Gradierungsfarbe.
`CDC::GrayString`	Zeichnet abgeblendeten (abgeblendeten) Text an der angegebenen Position.
`CDC::HIMETRICtoDP`	Konvertiert HIMETRIC-Einheiten in Geräteeinheiten.
`CDC::HIMETRICtoLP`	Konvertiert HIMETRIC-Einheiten in logische Einheiten.
`CDC::IntersectClipRect`	Erstellt einen neuen Beschneidungsbereich, indem der Schnittpunkt des aktuellen Bereichs und eines Rechtecks gebildet wird.
`CDC::InvertRect`	Umkehrt den Inhalt eines Rechtecks.
`CDC::InvertRgn`	Invertiert die Farben in einem Bereich.
`CDC::IsPrinting`	Bestimmt, ob der Gerätekontext zum Drucken verwendet wird.
`CDC::LineTo`	Zeichnet eine Linie von der aktuellen Position bis zu einem Punkt, aber nicht einschließlich eines Punkts.
`CDC::LPtoDP`	Wandelt logische Einheiten in Geräteeinheiten um.
`CDC::LPtoHIMETRIC`	Wandelt logische Einheiten in HIMETRIC-Einheiten um.
`CDC::MaskBlt`	Kombiniert die Farbdaten für die Quell- und Zielbitmaps mithilfe des angegebenen Masken- und Rastervorgangs.
`CDC::ModifyWorldTransform`	Ändert die Welttransformation für einen Gerätekontext mithilfe des angegebenen Modus.
`CDC::MoveTo`	Verschiebt die aktuelle Position.
`CDC::OffsetClipRgn`	Verschiebt den Clippingbereich des angegebenen Geräts.
`CDC::OffsetViewportOrg`	Ändert den Viewportursprung relativ zu den Koordinaten des aktuellen Viewportursprungs.
`CDC::OffsetWindowOrg`	Ändert den Fensterursprung relativ zu den Koordinaten des aktuellen Fensterursprungs.
`CDC::PaintRgn`	Füllt einen Bereich mit dem ausgewählten Pinsel aus.
`CDC::PatBlt`	Erstellt ein Bitmuster.
`CDC::Pie`	Zeichnet einen kreisförmigen Keil.
`CDC::PlayMetaFile`	Gibt den Inhalt der angegebenen Metadatei auf dem angegebenen Gerät wieder. Die erweiterte Version zeigt `PlayMetaFile` das Bild an, das in der angegebenen Metadatei im erweiterten Format gespeichert ist. Die Metadatei kann beliebig oft wiedergegeben werden.
`CDC::PlgBlt`	Führt eine Bitblockübertragung der Bits von Farbdaten aus dem angegebenen Rechteck im Quellgerätekontext an das angegebene Parallelogramm im angegebenen Gerätekontext aus.
`CDC::PolyBezier`	Zeichnet einen oder mehrere Bzier-Splines. Die aktuelle Position wird nicht verwendet oder aktualisiert.
`CDC::PolyBezierTo`	Zeichnet einen oder mehrere Bzier-Splines und verschiebt die aktuelle Position an den Endpunkt der letzten Bzier-Spline.
`CDC::PolyDraw`	Zeichnet eine Reihe von Liniensegmenten und Bzier-Splines. Diese Funktion aktualisiert die aktuelle Position.
`CDC::Polygon`	Zeichnet ein Polygon, das aus zwei oder mehr Punkten (Scheitelpunkten) besteht, die durch Linien verbunden sind.
`CDC::Polyline`	Zeichnet eine Reihe von Liniensegmenten, die die angegebenen Punkte verbinden.
`CDC::PolylineTo`	Zeichnet eine oder mehrere gerade Linien und verschiebt die aktuelle Position an den Endpunkt der letzten Zeile.
`CDC::PolyPolygon`	Erstellt zwei oder mehr Polygone, die mit dem aktuellen Polygonfüllmodus gefüllt sind. Die Polygone sind möglicherweise nicht zusammenhängend oder überlappend.
`CDC::PolyPolyline`	Zeichnet mehrere Reihen verbundener Liniensegmente. Die aktuelle Position wird von dieser Funktion nicht verwendet oder aktualisiert.
`CDC::PtVisible`	Gibt an, ob sich der angegebene Punkt innerhalb des Beschneidungsbereichs befindet.
`CDC::RealizePalette`	Ordnet Paletteneinträge in der aktuellen logischen Palette der Systempalette zu.
`CDC::Rectangle`	Zeichnet ein Rechteck mit dem aktuellen Stift und füllt es mit dem aktuellen Pinsel aus.
`CDC::RectVisible`	Bestimmt, ob ein Teil des angegebenen Rechtecks innerhalb des Beschneidungsbereichs liegt.
`CDC::ReleaseAttribDC`	Gibt `m_hAttribDC`den Attributgerätekontext frei.
`CDC::ReleaseOutputDC`	Gibt `m_hDC`den Ausgabegerätekontext frei.
`CDC::ResetDC`	Aktualisiert den `m_hAttribDC` Gerätekontext.
`CDC::RestoreDC`	Stellt den Gerätekontext in einem vorherigen Zustand wieder her, der mit `SaveDC`.
`CDC::RoundRect`	Zeichnet ein Rechteck mit abgerundeten Ecken mit dem aktuellen Stift und gefüllt mit dem aktuellen Pinsel.
`CDC::SaveDC`	Speichert den aktuellen Zustand des Gerätekontexts.
`CDC::ScaleViewportExt`	Ändert den Viewport-Umfang relativ zu den aktuellen Werten.
`CDC::ScaleWindowExt`	Ändert die Fensterausdehnung relativ zu den aktuellen Werten.
`CDC::ScrollDC`	Scrollt ein Rechteck von Bits horizontal und vertikal.
`CDC::SelectClipPath`	Wählt den aktuellen Pfad als Clippingbereich für den Gerätekontext aus und kombiniert den neuen Bereich mit einem vorhandenen Clippingbereich mithilfe des angegebenen Modus.
`CDC::SelectClipRgn`	Kombiniert den angegebenen Bereich mit dem aktuellen Clippingbereich mithilfe des angegebenen Modus.
`CDC::SelectObject`	Wählt ein GDI-Zeichnungsobjekt wie einen Stift aus.
`CDC::SelectPalette`	Wählt die logische Palette aus.
`CDC::SelectStockObject`	Wählt einen der vordefinierten Stockstifte, Pinsel oder Schriftarten aus, die von Windows bereitgestellt werden.
`CDC::SetAbortProc`	Legt eine vom Programmierer bereitgestellte Rückruffunktion fest, die Von Windows aufgerufen wird, wenn ein Druckauftrag abgebrochen werden muss.
`CDC::SetArcDirection`	Legt die Zeichnungsrichtung fest, die für Bogen- und Rechteckfunktionen verwendet werden soll.
`CDC::SetAttribDC`	Legt `m_hAttribDC`den Attributgerätekontext fest.
`CDC::SetBkColor`	Legt die aktuelle Hintergrundfarbe fest.
`CDC::SetBkMode`	Legt den Hintergrundmodus fest.
`CDC::SetBoundsRect`	Steuert die Akkumulation von Begrenzungsrechteckinformationen für den angegebenen Gerätekontext.
`CDC::SetBrushOrg`	Gibt den Ursprung für den nächsten Pinsel an, der in einem Gerätekontext ausgewählt ist.
`CDC::SetColorAdjustment`	Legt die Farbanpassungswerte für den Gerätekontext mithilfe der angegebenen Werte fest.
`CDC::SetDCBrushColor`	Legt die aktuelle Pinselfarbe fest.
`CDC::SetDCPenColor`	Legt die aktuelle Stiftfarbe fest.
`CDC::SetGraphicsMode`	Legt den aktuellen Grafikmodus für den angegebenen Gerätekontext fest.
`CDC::SetLayout`	Ändert das Layout eines Gerätekontexts (DC).
`CDC::SetMapMode`	Legt den aktuellen Zuordnungsmodus fest.
`CDC::SetMapperFlags`	Ändert den Algorithmus, den der Schriftartzuordnung verwendet, wenn er logische Schriftarten physischen Schriftarten zuordnet.
`CDC::SetMiterLimit`	Legt den Grenzwert für die Länge der Miter-Verknüpfungen für den Gerätekontext fest.
`CDC::SetOutputDC`	Legt `m_hDC`den Ausgabegerätekontext fest.
`CDC::SetPixel`	Legt das Pixel am angegebenen Punkt auf die näherste Annäherung der angegebenen Farbe fest.
`CDC::SetPixelV`	Legt das Pixel an den angegebenen Koordinaten auf die nächste Annäherung der angegebenen Farbe fest. `SetPixelV` ist schneller, als `SetPixel` weil der Farbwert des gezeichneten Punkts nicht zurückgegeben werden muss.
`CDC::SetPolyFillMode`	Legt den Polygonfüllmodus fest.
`CDC::SetROP2`	Legt den aktuellen Zeichnungsmodus fest.
`CDC::SetStretchBltMode`	Legt den Bitmap-Stretchmodus fest.
`CDC::SetTextAlign`	Legt die Textausrichtungskennzeichnungen fest.
`CDC::SetTextCharacterExtra`	Legt die Menge des Intercharacterabstands fest.
`CDC::SetTextColor`	Legt die Textfarbe fest.
`CDC::SetTextJustification`	Fügt den Umbruchzeichen in einer Zeichenfolge Leerzeichen hinzu.
`CDC::SetViewportExt`	Legt die x- und y-Erweiterung des Viewports fest.
`CDC::SetViewportOrg`	Legt den Viewportursprung fest.
`CDC::SetWindowExt`	Legt die x- und y-Erweiterung des zugeordneten Fensters fest.
`CDC::SetWindowOrg`	Legt den Fensterursprung des Gerätekontexts fest.
`CDC::SetWorldTransform`	Legt den aktuellen Weltbereich auf die Seitenbereichtransformation fest.
`CDC::StartDoc`	Informiert den Gerätetreiber darüber, dass ein neuer Druckauftrag gestartet wird.
`CDC::StartPage`	Informiert den Gerätetreiber darüber, dass eine neue Seite gestartet wird.
`CDC::StretchBlt`	Verschiebt eine Bitmap aus einem Quellrechteck und Gerät in ein Zielrechteck, dehnt oder komprimiert die Bitmap, falls erforderlich, um die Abmessungen des Zielrechtecks anzupassen.
`CDC::StrokeAndFillPath`	Schließt alle geöffneten Figuren in einem Pfad, durchstreicht den Umriss des Pfads mithilfe des aktuellen Stifts und füllt das Innere mithilfe des aktuellen Pinsels.
`CDC::StrokePath`	Rendert den angegebenen Pfad mithilfe des aktuellen Stifts.
`CDC::TabbedTextOut`	Schreibt eine Zeichenfolge an einer angegebenen Position und erweitert Tabstopps auf die werte, die in einem Array von Tabstopppositionen angegeben sind.
`CDC::TextOut`	Schreibt eine Zeichenfolge an einer angegebenen Position mithilfe der aktuell ausgewählten Schriftart.
`CDC::TransparentBlt`	Überträgt einen Bitblock von Farbdaten aus dem angegebenen Quellgerätekontext in einen Zielgerätekontext, wodurch eine angegebene Farbe transparent in der Übertragung gerendert wird.
`CDC::UpdateColors`	Aktualisiert den Clientbereich des Gerätekontexts, indem die aktuellen Farben im Clientbereich der Systempalette auf Pixelbasis zugeordnet werden.
`CDC::WidenPath`	Definiert den aktuellen Pfad als Bereich neu, der gezeichnet würde, wenn der Pfad mit dem aktuell im Gerätekontext ausgewählten Stift striche.

Öffentliche Operatoren

Name	Beschreibung
`CDC::operator HDC`	Ruft das Handle des Gerätekontexts ab.

Öffentliche Datenmember

Name	Beschreibung
`CDC::m_hAttribDC`	Der von diesem `CDC` Objekt verwendete Attributgerätekontext.
`CDC::m_hDC`	Der von diesem `CDC` Objekt verwendete Ausgabegerätekontext.

Hinweise

Das CDC Objekt stellt Memberfunktionen zum Arbeiten mit einem Gerätekontext bereit, z. B. eine Anzeige oder einen Drucker, und Member zum Arbeiten mit einem Anzeigekontext, der dem Clientbereich eines Fensters zugeordnet ist.

Führen Sie alle Zeichnungen über die Memberfunktionen eines CDC Objekts aus. Die Klasse stellt Memberfunktionen für Gerätekontextvorgänge bereit, arbeitet mit Zeichentools, typsicherer Grafikgeräteschnittstelle (GDI)-Objektauswahl und Arbeiten mit Farben und Paletten. Darüber hinaus bietet es Memberfunktionen zum Abrufen und Festlegen von Zeichnungsattributen, Zuordnungen, Arbeiten mit dem Viewport, Arbeiten mit dem Fensterumfang, Konvertieren von Koordinaten, Arbeiten mit Bereichen, Clipping, Zeichnen von Linien und Zeichnen einfacher Formen, Auslassungspunkte und Polygone. Memberfunktionen werden auch zum Zeichnen von Text bereitgestellt, zum Arbeiten mit Schriftarten, zum Verwenden von Drucker-Escapes, Bildlauf und Wiedergeben von Metadateien.

Um ein CDC Objekt zu verwenden, erstellen Sie es, und rufen Sie dann die Memberfunktionen auf, die parallele Windows-Funktionen verwenden, die Gerätekontexte verwenden.

Hinweis

Unter Windows 95/98 sind alle Bildschirmkoordinaten auf 16 Bit beschränkt. Daher muss eine int an eine CDC Memberfunktion übergebene Funktion im Bereich -32768 bis 32767 liegen.

Für bestimmte Verwendungen stellt die Microsoft Foundation Class Library mehrere Klassen bereit, die von CDC . CPaintDC Kapselt Aufrufe an BeginPaint und EndPaint. CClientDC verwaltet einen Anzeigekontext, der dem Clientbereich eines Fensters zugeordnet ist. CWindowDC verwaltet einen Anzeigekontext, der einem gesamten Fenster zugeordnet ist, einschließlich des Rahmens und der Steuerelemente. CMetaFileDC ordnet einen Gerätekontext einer Metadatei zu.

CDC stellt zwei Memberfunktionen GetLayout bereit, und SetLayoutzum Umkehren des Layouts eines Gerätekontexts, der sein Layout nicht von einem Fenster erbt. Eine solche Rechts-nach-links-Ausrichtung ist für Anwendungen erforderlich, die für Kulturen geschrieben wurden, z. B. Arabisch oder Hebräisch, wobei das Zeichenlayout nicht der europäische Standard ist.

CDC enthält zwei Gerätekontexte und m_hDC m_hAttribDC, die beim Erstellen eines CDC Objekts auf dasselbe Gerät verweisen. CDC leitet alle GDI-Ausgabeaufrufe an m_hDC und die meisten Attribut-GDI-Aufrufe an m_hAttribDC. (Ein Beispiel für einen Attributaufruf ist GetTextColor, während SetTextColor es sich um einen Ausgabeaufruf handelt.)

Das Framework verwendet beispielsweise diese beiden Gerätekontexte, um ein CMetaFileDC Objekt zu implementieren, das die Ausgabe an eine Metadatei sendet, während Attribute von einem physischen Gerät gelesen werden. Die Seitenansicht wird im Framework auf ähnliche Weise implementiert. Sie können auch die beiden Gerätekontexte auf ähnliche Weise in Ihrem anwendungsspezifischen Code verwenden.

Es gibt Situationen, in denen Sie möglicherweise Textmetrikinformationen sowohl aus dem m_hDC Kontext m_hAttribDC als auch aus dem Gerätekontext benötigen. Die folgenden Funktionspaare stellen diese Funktion bereit:

Verwendet m_hAttribDC	Verwendet m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

Weitere Informationen CDCfinden Sie unter "Gerätekontexte".

Vererbungshierarchie

CObject

CDC

Anforderungen

Header: afxwin.h

`CDC::AbortDoc`

Beendet den aktuellen Druckauftrag und löscht alles, was die Anwendung seit dem letzten Aufruf der StartDoc Memberfunktion auf das Gerät geschrieben hat.

int AbortDoc();

Rückgabewert

Ein Wert größer oder gleich 0, wenn dies erfolgreich war, oder ein negativer Wert, wenn ein Fehler aufgetreten ist. Die folgende Liste zeigt allgemeine Fehlerwerte und deren Bedeutungen:

SP_ERROR Allgemeiner Fehler.
SP_OUTOFDISK Nicht genügend Speicherplatz ist zurzeit für Spooling verfügbar, und es wird kein mehr Speicherplatz zur Verfügung gestellt.
SP_OUTOFMEMORY Nicht genügend Arbeitsspeicher ist für das Spooling verfügbar.
SP_USERABORT Der Benutzer hat den Auftrag über den Druck-Manager beendet.

Hinweise

Diese Memberfunktion ersetzt das ABORTDOC Drucker-Escapezeichen.

AbortDoc sollte verwendet werden, um Folgendes zu beenden:

Druckvorgänge, die keine Abgebrochene Funktion angeben.SetAbortProc
Druckvorgänge, die ihren ersten NEWFRAME oder NEXTBAND Escapeanruf noch nicht erreicht haben.

Wenn bei einer Anwendung ein Druckfehler oder ein abgebrochener Druckvorgang auftritt, darf es nicht versuchen, den Vorgang mithilfe der EndDoc Klassenfunktionen CDCoder AbortDoc Memberfunktionen zu beenden. GDI beendet den Vorgang automatisch, bevor der Fehlerwert zurückgegeben wird.

Wenn die Anwendung ein Dialogfeld anzeigt, damit der Benutzer den Druckvorgang abbrechen kann, muss er aufgerufen AbortDoc werden, bevor das Dialogfeld zerstört wird.

Wenn der Druck-Manager zum Starten des Druckauftrags verwendet wurde, löscht der Aufruf AbortDoc den gesamten Spoolauftrag – der Drucker erhält nichts. Wenn der Druck-Manager nicht zum Starten des Druckauftrags verwendet wurde, wurden die Daten möglicherweise vor AbortDoc dem Aufruf an den Drucker gesendet. In diesem Fall hätte der Druckertreiber den Drucker (sofern möglich) zurückgesetzt und den Druckauftrag geschlossen.

Beispiel

Ein Beispiel hierfür finden Sie unter CDC::StartDoc.

`CDC::AbortPath`

Schließt alle Pfade im Gerätekontext und verwirft sie.

BOOL AbortPath();

Rückgabewert

Ist ungleich null (0), wenn die Funktion erfolgreich ausgeführt wird, andernfalls null (0).

Hinweise

Wenn im Gerätekontext eine offene Pfadklammer vorhanden ist, wird die Pfadklammer geschlossen, und der Pfad wird verworfen. Wenn im Gerätekontext ein geschlossener Pfad vorhanden ist, wird der Pfad verworfen.

`CDC::AddMetaFileComment`

Kopiert den Kommentar aus einem Puffer in eine angegebene Metadatei im erweiterten Format.

BOOL AddMetaFileComment(
    UINT nDataSize,
    const BYTE* pCommentData);

Parameter

nDataSize
Gibt die Länge des Kommentarpuffers in Bytes an.

pCommentData
Verweist auf den Puffer, der den Kommentar enthält.

Rückgabewert

Ist ungleich null (0), wenn die Funktion erfolgreich ausgeführt wird, andernfalls null (0).

Hinweise

Ein Kommentar kann private Informationen enthalten, z. B. die Quelle des Bilds und das Erstellungsdatum. Ein Kommentar sollte mit einer Anwendungssignatur beginnen, gefolgt von den Daten. Kommentare sollten keine positionsspezifischen Daten enthalten. Positionsspezifische Daten geben den Speicherort eines Datensatzes an und sollten nicht einbezogen werden, da eine Metadatei möglicherweise in eine andere Metadatei eingebettet werden kann. Diese Funktion kann nur mit erweiterten Metadateien verwendet werden.

`CDC::AlphaBlend`

Rufen Sie diese Memberfunktion auf, um Bitmaps mit transparenten oder halbtransparenten Pixeln anzuzeigen.

BOOL AlphaBlend(
    int xDest,
    int yDest,
    int nDestWidth,
    int nDestHeight,
    CDC* pSrcDC,
    int xSrc,
    int ySrc,
    int nSrcWidth,
    int nSrcHeight,
    BLENDFUNCTION blend);

Parameter

xDest
Gibt die x-Koordinate in logischen Einheiten der oberen linken Ecke des Zielrechtecks an.

yDest
Gibt die y-Koordinate in logischen Einheiten der oberen linken Ecke des Zielrechtecks an.

nDestWidth
Gibt die Breite des Zielrechtecks in logischen Einheiten an.

nDestHeight
Gibt die Höhe des Zielrechtecks in logischen Einheiten an.

pSrcDC
Ein Zeiger auf den Quellgerätekontext.

xSrc
Gibt die x-Koordinate in logischen Einheiten der oberen linken Ecke des Quellrechtecks an.

ySrc
Gibt die y-Koordinate in logischen Einheiten der oberen linken Ecke des Quellrechtecks an.

nSrcWidth
Gibt die Breite des Quellrechtecks in logischen Einheiten an.

nSrcHeight
Gibt die Höhe des Quellrechtecks in logischen Einheiten an.

blend
Gibt eine BLENDFUNCTION Struktur an.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Weitere Informationen finden Sie AlphaBlend im Windows SDK.

`CDC::AngleArc`

Zeichnet ein Liniensegment und einen Bogen.

BOOL AngleArc(
    int x,
    int y,
    int nRadius,
    float fStartAngle,
    float fSweepAngle);

Parameter

x
Gibt die logische x-Koordinate des Kreismittelpunkts an.

y
Gibt die logische y-Koordinate des Kreismittelpunkts an.

nRadius
Gibt den Radius des Kreises in logischen Einheiten an. Dieser Wert muss positiv sein.

fStartAngle
Gibt den Anfangswinkel in Grad relativ zur X-Achse an.

fSweepAngle
Gibt den Aufräumwinkel in Grad relativ zum Anfangswinkel an.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Das Liniensegment wird von der aktuellen Position bis zum Anfang des Bogens gezeichnet. Der Bogen wird entlang des Umkreises eines Kreises mit dem angegebenen Radius und Mittelpunkt gezeichnet. Die Länge des Bogens wird durch den angegebenen Anfangs- und Aufräumenwinkel definiert.

AngleArc verschiebt die aktuelle Position an den Endpunkt des Bogens. Der von dieser Funktion gezeichnete Bogen kann je nach der aktuellen Transformation und dem Zuordnungsmodus als auslassungslos erscheinen. Vor dem Zeichnen des Bogens zeichnet diese Funktion das Liniensegment von der aktuellen Position bis zum Anfang des Bogens. Der Bogen wird gezeichnet, indem ein imaginärer Kreis mit dem angegebenen Radius um den angegebenen Mittelpunkt erstellt wird. Der Ausgangspunkt des Bogens wird durch Messung gegen den Uhrzeigersinn von der X-Achse des Kreises um die Anzahl der Grad im Anfangswinkel bestimmt. Der Endpunkt befindet sich ähnlich, indem der Gegenzeigersinn vom Ausgangspunkt um die Gradzahl im Aufräumwinkel gemessen wird.

Wenn der Aufräumwinkel größer als 360 Grad ist, wird der Bogen mehrmals geschwemmt. Diese Funktion zeichnet Linien mithilfe des aktuellen Stifts. Die Abbildung ist nicht ausgefüllt.

`CDC::Arc`

Zeichnet einen elliptischen Bogen.

BOOL Arc(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL Arc(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);

Parameter

x1
Gibt die X-Koordinate der oberen linken Ecke des umgebenden Rechtecks (in logischen Einheiten) an.

y1
Gibt die y-Koordinate der oberen linken Ecke des umgebenden Rechtecks (in logischen Einheiten) an.

x2
Gibt die x-Koordinate der unteren rechten Ecke des umgebenden Rechtecks (in logischen Einheiten) an.

y2
Gibt die y-Koordinate der unteren rechten Ecke des umgebenden Rechtecks (in logischen Einheiten) an.

x3
Gibt die x-Koordinate des Punkts an, der den Anfangspunkt des Bogens (in logischen Einheiten) definiert. Dieser Punkt muss nicht genau auf dem Bogen liegen.

y3
Gibt die y-Koordinate des Punkts an, der den Anfangspunkt des Bogens (in logischen Einheiten) definiert. Dieser Punkt muss nicht genau auf dem Bogen liegen.

x4
Gibt die x-Koordinate des Punkts an, der den Endpunkt des Bogens (in logischen Einheiten) definiert. Dieser Punkt muss nicht genau auf dem Bogen liegen.

y4
Gibt die y-Koordinate des Punkts an, der den Endpunkt des Bogens definiert (in logischen Einheiten). Dieser Punkt muss nicht genau auf dem Bogen liegen.

lpRect
Gibt das umgebende Rechteck (in logischen Einheiten) an. Sie können entweder ein LPRECT Objekt oder ein CRect Objekt für diesen Parameter übergeben.

ptStart
Gibt die x- und y-Koordinaten des Punkts an, der den Ausgangspunkt des Bogens (in logischen Einheiten) definiert. Dieser Punkt muss nicht genau auf dem Bogen liegen. Sie können entweder eine POINT Struktur oder ein CPoint Objekt für diesen Parameter übergeben.

ptEnd
Gibt die x- und y-Koordinaten des Punkts an, der den Endpunkt des Bogens (in logischen Einheiten) definiert. Dieser Punkt muss nicht genau auf dem Bogen liegen. Sie können entweder eine POINT Struktur oder ein CPoint Objekt für diesen Parameter übergeben.

Rückgabewert

Ist ungleich null (0), wenn die Funktion erfolgreich ausgeführt wird, andernfalls null (0).

Hinweise

Der mit der Funktion gezeichnete Bogen ist ein Segment der durch das angegebene Begrenzungsrechteck definierten Auslassungspunkte.

Der tatsächliche Ausgangspunkt des Bogens ist der Punkt, an dem ein Strahl aus der Mitte des umgebenden Rechtecks durch den angegebenen Ausgangspunkt die Auslassungspunkte überschneidet. Der tatsächliche Endpunkt des Bogens ist der Punkt, an dem ein Strahl aus der Mitte des umgebenden Rechtecks durch den angegebenen Endpunkt die Auslassungspunkte überschneidet. Der Bogen wird in gegen den Uhrzeigersinn gezeichnet. Da ein Bogen keine geschlossene Figur ist, ist er nicht gefüllt. Sowohl die Breite als auch die Höhe des Rechtecks müssen größer als 2 Einheiten und weniger als 32.767 Einheiten sein.

Beispiel

void CDCView::DrawArc(CDC *pDC)
{
   // Fill the client area with a thin circle. The circle's
   // interior is not filled. The circle's perimeter is
   // blue from 6 o'clock to 3 o'clock and red from 3
   // o'clock to 6 o'clock.

   // Get the client area.
   CRect rectClient;
   GetClientRect(rectClient);

   // Make a couple of pens.
   CPen penBlue;
   CPen penRed;
   CPen *pOldPen;

   penBlue.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(0, 0, 255));
   penRed.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(255, 0, 0));

   // Draw from 3 o'clock to 6 o'clock, counterclockwise,
   // in a blue pen.

   pOldPen = pDC->SelectObject(&penBlue);

   pDC->Arc(rectClient,
            CPoint(rectClient.right, rectClient.CenterPoint().y),
            CPoint(rectClient.CenterPoint().x, rectClient.right));

   // Draw from 6 o'clock to 3 o'clock, counterclockwise,
   // in a red pen.
   pDC->SelectObject(&penRed);

   // Keep the same parameters, but reverse start
   // and end points.
   pDC->Arc(rectClient,
            CPoint(rectClient.CenterPoint().x, rectClient.right),
            CPoint(rectClient.right, rectClient.CenterPoint().y));

   // Restore the previous pen.
   pDC->SelectObject(pOldPen);
}

`CDC::ArcTo`

Zeichnet einen elliptischen Bogen.

BOOL ArcTo(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL ArcTo(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);