La classe `CDC`

Article
04/06/2023

Définit une classe d’objets de contexte de périphérique.

Syntaxe

class CDC : public CObject

Membres

Constructeurs publics

Nom	Description
`CDC::CDC`	Construit un objet `CDC`.

Méthodes publiques

Nom	Description
`CDC::AbortDoc`	Termine le travail d’impression actuel, effançant tout ce que l’application a écrit sur l’appareil depuis le dernier appel de la `StartDoc` fonction membre.
`CDC::AbortPath`	Ferme et ignore tous les chemins d’accès dans le contexte de l’appareil.
`CDC::AddMetaFileComment`	Copie le commentaire d’une mémoire tampon dans un métafichier de format amélioré spécifié.
`CDC::AlphaBlend`	Affiche des bitmaps qui ont des pixels transparents ou semi-transparents.
`CDC::AngleArc`	Dessine un segment de trait et un arc, et déplace la position actuelle vers le point de fin de l’arc.
`CDC::Arc`	Dessine un arc elliptique.
`CDC::ArcTo`	Dessine un arc elliptique. Cette fonction est similaire à `Arc`, sauf que la position actuelle est mise à jour.
`CDC::Attach`	Attache un contexte d’appareil Windows à cet `CDC` objet.
`CDC::BeginPath`	Ouvre un crochet de chemin dans le contexte de l’appareil.
`CDC::BitBlt`	Copie une bitmap à partir d’un contexte d’appareil spécifié.
`CDC::Chord`	Dessine une corde (une figure fermée délimitée par l’intersection d’un ellipse et d’un segment de trait).
`CDC::CloseFigure`	Ferme une figure ouverte dans un chemin d’accès.
`CDC::CreateCompatibleDC`	Crée un contexte de périphérique mémoire compatible avec un autre contexte d’appareil. Vous pouvez l’utiliser pour préparer des images en mémoire.
`CDC::CreateDC`	Crée un contexte d’appareil pour un appareil spécifique.
`CDC::CreateIC`	Crée un contexte d’informations pour un appareil spécifique. Cela permet d’obtenir rapidement des informations sur l’appareil sans créer de contexte d’appareil.
`CDC::DeleteDC`	Supprime le contexte d’appareil Windows associé à cet `CDC` objet.
`CDC::DeleteTempMap`	Appelé par le gestionnaire d’inactivité `CWinApp` pour supprimer tout objet temporaire `CDC` créé par `FromHandle`. Détache également le contexte de l’appareil.
`CDC::Detach`	Détache le contexte de l’appareil Windows de cet `CDC` objet.
`CDC::DPtoHIMETRIC`	Convertit les unités d’appareil en `HIMETRIC` unités.
`CDC::DPtoLP`	Convertit les unités d’appareil en unités logiques.
`CDC::Draw3dRect`	Dessine un rectangle à trois dimensions.
`CDC::DrawDragRect`	Efface et redessine un rectangle au fur et à mesure qu’il est déplacé.
`CDC::DrawEdge`	Dessine les bords d’un rectangle.
`CDC::DrawEscape`	Accède aux fonctionnalités de dessin d’un affichage vidéo qui ne sont pas directement disponibles via l’interface GDI (Graphics Device Interface).
`CDC::DrawFocusRect`	Dessine un rectangle dans le style utilisé pour indiquer le focus.
`CDC::DrawFrameControl`	Dessinez un contrôle frame.
`CDC::DrawIcon`	Dessine une icône.
`CDC::DrawState`	Affiche une image et applique un effet visuel pour indiquer un état.
`CDC::DrawText`	Dessine le texte mis en forme dans le rectangle spécifié.
`CDC::DrawTextEx`	Dessine le texte mis en forme dans le rectangle spécifié à l’aide d’autres formats.
`CDC::Ellipse`	Dessine une ellipse.
`CDC::EndDoc`	Termine un travail d’impression démarré par la `StartDoc` fonction membre.
`CDC::EndPage`	Informe le pilote de périphérique qu’une page se termine.
`CDC::EndPath`	Ferme un crochet de chemin et sélectionne le chemin défini par le crochet dans le contexte de l’appareil.
`CDC::EnumObjects`	Énumère les stylos et pinceaux disponibles dans un contexte d’appareil.
`CDC::Escape`	Permet aux applications d’accéder aux installations qui ne sont pas directement disponibles à partir d’un appareil particulier via GDI. Autorise également l’accès aux fonctions d’échappement Windows. Les appels d’échappement effectués par une application sont traduits et envoyés au pilote de périphérique.
`CDC::ExcludeClipRect`	Crée une région de découpage qui se compose de la région de découpage existante moins le rectangle spécifié.
`CDC::ExcludeUpdateRgn`	Empêche le dessin dans des zones non valides d’une fenêtre en excluant une région mise à jour dans la fenêtre d’une région de découpage.
`CDC::ExtFloodFill`	Remplit une zone avec le pinceau actuel. Offre plus de flexibilité que la `CDC::FloodFill` fonction membre.
`CDC::ExtTextOut`	Écrit une chaîne de caractères dans une région rectangulaire à l’aide de la police actuellement sélectionnée.
`CDC::FillPath`	Ferme toutes les figures ouvertes dans le chemin actuel et remplit l’intérieur du chemin à l’aide du mode de remplissage actuel du pinceau et du polygone.
`CDC::FillRect`	Remplit un rectangle donné à l’aide d’un pinceau spécifique.
`CDC::FillRgn`	Remplit une région spécifique avec le pinceau spécifié.
`CDC::FillSolidRect`	Remplit un rectangle avec une couleur unie.
`CDC::FlattenPath`	Transforme toutes les courbes du chemin sélectionné dans le contexte actuel de l’appareil et transforme chaque courbe en une séquence de lignes.
`CDC::FloodFill`	Remplit une zone avec le pinceau actuel.
`CDC::FrameRect`	Dessine une bordure autour d’un rectangle.
`CDC::FrameRgn`	Dessine une bordure autour d’une région spécifique à l’aide d’un pinceau.
`CDC::FromHandle`	Retourne un pointeur vers un `CDC` objet lorsqu’un handle est donné à un contexte d’appareil. Si un `CDC` objet n’est pas attaché au handle, un objet temporaire `CDC` est créé et attaché.
`CDC::GetArcDirection`	Retourne la direction actuelle de l’arc pour le contexte de l’appareil.
`CDC::GetAspectRatioFilter`	Récupère le paramètre du filtre de rapport d’aspect actuel.
`CDC::GetBkColor`	Récupère la couleur d’arrière-plan actuelle.
`CDC::GetBkMode`	Récupère le mode d’arrière-plan.
`CDC::GetBoundsRect`	Retourne le rectangle englobant cumulé actuel pour le contexte d’appareil spécifié.
`CDC::GetBrushOrg`	Récupère l’origine du pinceau actuel.
`CDC::GetCharABCWidths`	Récupère les largeurs, en unités logiques, de caractères consécutifs dans une plage donnée à partir de la police actuelle.
`CDC::GetCharABCWidthsI`	Récupère les largeurs, en unités logiques, des index de glyphe consécutifs dans une plage spécifiée à partir de la police TrueType actuelle.
`CDC::GetCharacterPlacement`	Récupère différents types d’informations sur une chaîne de caractères.
`CDC::GetCharWidth`	Récupère les largeurs fractionnaires de caractères consécutifs dans une plage donnée à partir de la police actuelle.
`CDC::GetCharWidthI`	Récupère les largeurs, en coordonnées logiques, des index de glyphe consécutifs dans une plage spécifiée à partir de la police actuelle.
`CDC::GetClipBox`	Récupère les dimensions du rectangle englobant le plus serré autour de la limite de découpage actuelle.
`CDC::GetColorAdjustment`	Récupère les valeurs d’ajustement des couleurs pour le contexte de l’appareil.
`CDC::GetCurrentBitmap`	Retourne un pointeur vers l’objet actuellement sélectionné `CBitmap` .
`CDC::GetCurrentBrush`	Retourne un pointeur vers l’objet actuellement sélectionné `CBrush` .
`CDC::GetCurrentFont`	Retourne un pointeur vers l’objet actuellement sélectionné `CFont` .
`CDC::GetCurrentPalette`	Retourne un pointeur vers l’objet actuellement sélectionné `CPalette` .
`CDC::GetCurrentPen`	Retourne un pointeur vers l’objet actuellement sélectionné `CPen` .
`CDC::GetCurrentPosition`	Récupère la position actuelle du stylet (en coordonnées logiques).
`CDC::GetDCBrushColor`	Récupère la couleur actuelle du pinceau.
`CDC::GetDCPenColor`	Récupère la couleur actuelle du stylet.
`CDC::GetDeviceCaps`	Récupère un type spécifié d’informations spécifiques à l’appareil sur les fonctionnalités d’un appareil d’affichage donné.
`CDC::GetFontData`	Récupère les informations de métrique de police à partir d’un fichier de police évolutif. Les informations à récupérer sont identifiées en spécifiant un décalage dans le fichier de police et la longueur des informations à retourner.
`CDC::GetFontLanguageInfo`	Retourne des informations sur la police actuellement sélectionnée pour le contexte d’affichage spécifié.
`CDC::GetGlyphOutline`	Récupère la courbe de contour ou la bitmap d’un caractère de plan dans la police actuelle.
`CDC::GetGraphicsMode`	Récupère le mode graphique actuel pour le contexte d’appareil spécifié.
`CDC::GetHalftoneBrush`	Récupère un pinceau demi-teinte.
`CDC::GetKerningPairs`	Récupère les paires de crénages de caractères pour la police actuellement sélectionnée dans le contexte d’appareil spécifié.
`CDC::GetLayout`	Récupère la disposition d’un contexte d’appareil (DC). La disposition peut être de gauche à droite (par défaut) ou de droite à gauche (mise en miroir).
`CDC::GetMapMode`	Récupère le mode de mappage actuel.
`CDC::GetMiterLimit`	Retourne la limite de mitreur pour le contexte de l’appareil.
`CDC::GetNearestColor`	Récupère la couleur logique la plus proche d’une couleur logique spécifiée que l’appareil donné peut représenter.
`CDC::GetOutlineTextMetrics`	Récupère les informations de métrique de police pour les polices TrueType.
`CDC::GetOutputCharWidth`	Récupère les largeurs des caractères individuels dans un groupe consécutif de caractères de la police actuelle à l’aide du contexte de l’appareil de sortie.
`CDC::GetOutputTabbedTextExtent`	Calcule la largeur et la hauteur d’une chaîne de caractères sur le contexte de l’appareil de sortie.
`CDC::GetOutputTextExtent`	Calcule la largeur et la hauteur d’une ligne de texte sur le contexte de l’appareil de sortie à l’aide de la police actuelle pour déterminer les dimensions.
`CDC::GetOutputTextMetrics`	Récupère les métriques de la police actuelle à partir du contexte de l’appareil de sortie.
`CDC::GetPath`	Récupère les coordonnées définissant les points de terminaison des lignes et les points de contrôle des courbes trouvés dans le chemin d’accès sélectionné dans le contexte de l’appareil.
`CDC::GetPixel`	Récupère la valeur de couleur RVB du pixel au point spécifié.
`CDC::GetPolyFillMode`	Récupère le mode de remplissage de polygone actuel.
`CDC::GetROP2`	Récupère le mode de dessin actuel.
`CDC::GetSafeHdc`	Retourne `CDC::m_hDC`, le contexte de l’appareil de sortie.
`CDC::GetStretchBltMode`	Récupère le mode d’étirement bitmap actuel.
`CDC::GetTabbedTextExtent`	Calcule la largeur et la hauteur d’une chaîne de caractères sur le contexte de l’appareil d’attribut.
`CDC::GetTextAlign`	Récupère les indicateurs d’alignement du texte.
`CDC::GetTextCharacterExtra`	Récupère le paramètre actuel de l’espacement intercharacteur.
`CDC::GetTextColor`	Récupère la couleur de texte actuelle.
`CDC::GetTextExtent`	Calcule la largeur et la hauteur d’une ligne de texte sur le contexte de l’appareil d’attribut à l’aide de la police actuelle pour déterminer les dimensions.
`CDC::GetTextExtentExPointI`	Récupère le nombre de caractères d’une chaîne spécifiée qui s’intègre dans un espace spécifié et remplit un tableau avec l’étendue du texte pour chacun de ces caractères.
`CDC::GetTextExtentPointI`	Récupère la largeur et la hauteur du tableau spécifié d’indices de glyphe.
`CDC::GetTextFace`	Copie le nom de police de la police actuelle dans une mémoire tampon sous forme de chaîne terminée par null.
`CDC::GetTextMetrics`	Récupère les métriques de la police actuelle à partir du contexte de l’appareil d’attribut.
`CDC::GetViewportExt`	Récupère les étendues x et y de la fenêtre d’affichage.
`CDC::GetViewportOrg`	Récupère les coordonnées x et y de l’origine de la fenêtre d’affichage.
`CDC::GetWindow`	Retourne la fenêtre associée au contexte de l’appareil d’affichage.
`CDC::GetWindowExt`	Récupère les étendues x et y de la fenêtre associée.
`CDC::GetWindowOrg`	Récupère les coordonnées x et y de l’origine de la fenêtre associée.
`CDC::GetWorldTransform`	Récupère l’espace mondial actuel à la transformation de l’espace de page.
`CDC::GradientFill`	Remplit des structures rectangle et triangle avec une couleur gradante.
`CDC::GrayString`	Dessine le texte grisé (grisé) à l’emplacement donné.
`CDC::HIMETRICtoDP`	Convertit les unités HIMETRIC en unités d’appareil.
`CDC::HIMETRICtoLP`	Convertit les unités HIMETRIC en unités logiques.
`CDC::IntersectClipRect`	Crée une zone de découpage en formant l’intersection de la région actuelle et d’un rectangle.
`CDC::InvertRect`	Inverse le contenu d’un rectangle.
`CDC::InvertRgn`	Inverse les couleurs d’une région.
`CDC::IsPrinting`	Détermine si le contexte de l’appareil est utilisé pour l’impression.
`CDC::LineTo`	Dessine une ligne de la position actuelle jusqu’à, mais pas compris, un point.
`CDC::LPtoDP`	Convertit les unités logiques en unités d’appareil.
`CDC::LPtoHIMETRIC`	Convertit les unités logiques en unités HIMETRIC.
`CDC::MaskBlt`	Combine les données de couleur pour les bitmaps source et de destination à l’aide de l’opération de masque et de raster donnée.
`CDC::ModifyWorldTransform`	Modifie la transformation mondiale d’un contexte d’appareil à l’aide du mode spécifié.
`CDC::MoveTo`	Déplace la position actuelle.
`CDC::OffsetClipRgn`	Déplace la région de découpage de l’appareil donné.
`CDC::OffsetViewportOrg`	Modifie l’origine de la fenêtre d’affichage par rapport aux coordonnées de l’origine de la fenêtre d’affichage actuelle.
`CDC::OffsetWindowOrg`	Modifie l’origine de la fenêtre par rapport aux coordonnées de l’origine de la fenêtre active.
`CDC::PaintRgn`	Remplit une région avec le pinceau sélectionné.
`CDC::PatBlt`	Crée un modèle de bits.
`CDC::Pie`	Dessine un coin en forme de tarte.
`CDC::PlayMetaFile`	Lit le contenu du métafichier spécifié sur l’appareil donné. La version améliorée des affichages de `PlayMetaFile` l’image stockée dans le métafichier de format amélioré donné. Le métafichier peut être lu n’importe quel nombre de fois.
`CDC::PlgBlt`	Effectue un transfert de bloc de bits des bits de données de couleur du rectangle spécifié dans le contexte de l’appareil source vers le parallélisme spécifié dans le contexte de l’appareil donné.
`CDC::PolyBezier`	Dessine une ou plusieurs splines Bzier. La position actuelle n’est pas utilisée ou mise à jour.
`CDC::PolyBezierTo`	Dessine une ou plusieurs splines Bzier et déplace la position actuelle vers le point de fin du dernier spline Bzier.
`CDC::PolyDraw`	Dessine un ensemble de segments de ligne et de splines Bzier. Cette fonction met à jour la position actuelle.
`CDC::Polygon`	Dessine un polygone composé de deux points ou plus (sommets) connectés par des lignes.
`CDC::Polyline`	Dessine un ensemble de segments de ligne qui connectent les points spécifiés.
`CDC::PolylineTo`	Dessine une ou plusieurs lignes droites et déplace la position actuelle vers le point de fin de la dernière ligne.
`CDC::PolyPolygon`	Crée deux polygones ou plus remplis à l’aide du mode de remplissage de polygones actuel. Les polygones peuvent être disjoints ou ils peuvent se chevaucher.
`CDC::PolyPolyline`	Dessine plusieurs séries de segments de ligne connectés. La position actuelle n’est pas utilisée ou mise à jour par cette fonction.
`CDC::PtVisible`	Spécifie si le point donné se trouve dans la région de découpage.
`CDC::RealizePalette`	Mappe les entrées de palette dans la palette logique actuelle à la palette système.
`CDC::Rectangle`	Dessine un rectangle à l’aide du stylet actuel et le remplit à l’aide du pinceau actuel.
`CDC::RectVisible`	Détermine si une partie du rectangle donné se trouve dans la région de découpage.
`CDC::ReleaseAttribDC`	`m_hAttribDC`Libère , le contexte de l’appareil d’attribut.
`CDC::ReleaseOutputDC`	`m_hDC`Libère , le contexte de l’appareil de sortie.
`CDC::ResetDC`	Met à jour le contexte de l’appareil `m_hAttribDC` .
`CDC::RestoreDC`	Restaure le contexte de l’appareil dans un état précédent enregistré avec `SaveDC`.
`CDC::RoundRect`	Dessine un rectangle avec des angles arrondis à l’aide du stylet actuel et rempli à l’aide du pinceau actuel.
`CDC::SaveDC`	Enregistre l’état actuel du contexte de l’appareil.
`CDC::ScaleViewportExt`	Modifie l’étendue de la fenêtre d’affichage par rapport aux valeurs actuelles.
`CDC::ScaleWindowExt`	Modifie les étendues de fenêtre par rapport aux valeurs actuelles.
`CDC::ScrollDC`	Fait défiler un rectangle de bits horizontalement et verticalement.
`CDC::SelectClipPath`	Sélectionne le chemin actuel en tant que région de découpage pour le contexte de l’appareil, en combinant la nouvelle région avec n’importe quelle région de découpage existante à l’aide du mode spécifié.
`CDC::SelectClipRgn`	Combine la région donnée avec la région de découpage actuelle à l’aide du mode spécifié.
`CDC::SelectObject`	Sélectionne un objet de dessin GDI tel qu’un stylet.
`CDC::SelectPalette`	Sélectionne la palette logique.
`CDC::SelectStockObject`	Sélectionne l’un des stylos, pinceaux ou polices de stock prédéfinis fournis par Windows.
`CDC::SetAbortProc`	Définit une fonction de rappel fournie par le programmeur que Windows appelle si un travail d’impression doit être abandonné.
`CDC::SetArcDirection`	Définit la direction du dessin à utiliser pour les fonctions arc et rectangle.
`CDC::SetAttribDC`	Définit `m_hAttribDC`, le contexte de l’appareil d’attribut.
`CDC::SetBkColor`	Définit la couleur d’arrière-plan actuelle.
`CDC::SetBkMode`	Définit le mode d’arrière-plan.
`CDC::SetBoundsRect`	Contrôle l’accumulation d’informations de rectangle englobant pour le contexte d’appareil spécifié.
`CDC::SetBrushOrg`	Spécifie l’origine du pinceau suivant sélectionné dans un contexte d’appareil.
`CDC::SetColorAdjustment`	Définit les valeurs d’ajustement des couleurs pour le contexte de l’appareil à l’aide des valeurs spécifiées.
`CDC::SetDCBrushColor`	Définit la couleur actuelle du pinceau.
`CDC::SetDCPenColor`	Définit la couleur de stylet actuelle.
`CDC::SetGraphicsMode`	Définit le mode graphique actuel pour le contexte d’appareil spécifié.
`CDC::SetLayout`	Modifie la disposition d’un contexte d’appareil (DC).
`CDC::SetMapMode`	Définit le mode de mappage actuel.
`CDC::SetMapperFlags`	Modifie l’algorithme utilisé par le mappeur de polices lorsqu’il mappe les polices logiques aux polices physiques.
`CDC::SetMiterLimit`	Définit la limite pour la longueur des jointures mitreuse pour le contexte de l’appareil.
`CDC::SetOutputDC`	Définit `m_hDC`le contexte de l’appareil de sortie.
`CDC::SetPixel`	Définit le pixel au point spécifié sur l’approximation la plus proche de la couleur spécifiée.
`CDC::SetPixelV`	Définit le pixel aux coordonnées spécifiées à l’approximation la plus proche de la couleur spécifiée. `SetPixelV` est plus rapide que `SetPixel` parce qu’il n’a pas besoin de retourner la valeur de couleur du point peint.
`CDC::SetPolyFillMode`	Définit le mode de remplissage des polygones.
`CDC::SetROP2`	Définit le mode de dessin actuel.
`CDC::SetStretchBltMode`	Définit le mode d’étirement bitmap.
`CDC::SetTextAlign`	Définit les indicateurs d’alignement du texte.
`CDC::SetTextCharacterExtra`	Définit la quantité d’espacement intercharacteur.
`CDC::SetTextColor`	Définit la couleur du texte.
`CDC::SetTextJustification`	Ajoute de l’espace aux caractères de saut dans une chaîne.
`CDC::SetViewportExt`	Définit les étendues x et y de la fenêtre d’affichage.
`CDC::SetViewportOrg`	Définit l’origine de la fenêtre d’affichage.
`CDC::SetWindowExt`	Définit les étendues x et y de la fenêtre associée.
`CDC::SetWindowOrg`	Définit l’origine de la fenêtre du contexte de l’appareil.
`CDC::SetWorldTransform`	Définit l’espace mondial actuel sur la transformation de l’espace de page.
`CDC::StartDoc`	Informe le pilote de périphérique qu’une nouvelle tâche d’impression démarre.
`CDC::StartPage`	Informe le pilote de périphérique qu’une nouvelle page démarre.
`CDC::StretchBlt`	Déplace une bitmap d’un rectangle source et d’un appareil dans un rectangle de destination, étirement ou compression de l’image bitmap si nécessaire pour ajuster les dimensions du rectangle de destination.
`CDC::StrokeAndFillPath`	Ferme toutes les figures ouvertes dans un chemin, frappe le contour du chemin à l’aide du stylet actuel et remplit son intérieur à l’aide du pinceau actuel.
`CDC::StrokePath`	Affiche le chemin spécifié à l’aide du stylet actuel.
`CDC::TabbedTextOut`	Écrit une chaîne de caractères à un emplacement spécifié, en développant les onglets dans les valeurs spécifiées dans un tableau de positions de taquet de tabulation.
`CDC::TextOut`	Écrit une chaîne de caractères à un emplacement spécifié à l’aide de la police actuellement sélectionnée.
`CDC::TransparentBlt`	Transfère un bloc de bits de données de couleur du contexte d’appareil source spécifié dans un contexte d’appareil de destination, rendant une couleur spécifiée transparente dans le transfert.
`CDC::UpdateColors`	Met à jour la zone cliente du contexte de l’appareil en faisant correspondre les couleurs actuelles de la zone cliente à la palette système en pixels par pixels.
`CDC::WidenPath`	Redéfinit le chemin actuel comme zone qui serait peinte si le chemin d’accès a été tracé à l’aide du stylet actuellement sélectionné dans le contexte de l’appareil.

Opérateurs publics

Nom	Description
`CDC::operator HDC`	Récupère le handle du contexte de l’appareil.

Membres de données publics

Nom	Description
`CDC::m_hAttribDC`	Contexte d’attribut-appareil utilisé par cet `CDC` objet.
`CDC::m_hDC`	Contexte d’appareil de sortie utilisé par cet `CDC` objet.

Notes

L’objet CDC fournit des fonctions membres pour l’utilisation d’un contexte d’appareil, telles qu’un affichage ou une imprimante, et les membres pour travailler avec un contexte d’affichage associé à la zone cliente d’une fenêtre.

Effectuez tout le dessin à travers les fonctions membres d’un CDC objet. La classe fournit des fonctions membres pour les opérations de contexte d’appareil, l’utilisation d’outils de dessin, la sélection d’objets GDI (Type Safe Device Interface) et l’utilisation de couleurs et de palettes. Il fournit également des fonctions membres pour obtenir et définir des attributs de dessin, le mappage, l’utilisation de la fenêtre, l’extension de la fenêtre, la conversion des coordonnées, l’utilisation de régions, de découpage, de traits de dessin et de dessin de formes simples, de points de suspension et de polygones. Les fonctions membres sont également fournies pour dessiner du texte, utiliser des polices, utiliser des échappements d’imprimante, faire défiler et lire des métafichiers.

Pour utiliser un CDC objet, construisez-le, puis appelez ses fonctions membres qui utilisent des contextes d’appareil en parallèle.

Remarque

Sous Windows 95/98, toutes les coordonnées de l’écran sont limitées à 16 bits. Par conséquent, une int CDC fonction membre transmise doit être comprise entre -32768 et 32767.

Pour des utilisations spécifiques, la bibliothèque de classes Microsoft Foundation fournit plusieurs classes dérivées de CDC . CPaintDC encapsule les appels à BeginPaint et EndPaint. CClientDC gère un contexte d’affichage associé à la zone cliente d’une fenêtre. CWindowDC gère un contexte d’affichage associé à une fenêtre entière, y compris son cadre et ses contrôles. CMetaFileDC associe un contexte d’appareil à un métafichier.

CDC fournit deux fonctions membres et GetLayout SetLayout, pour inverser la disposition d’un contexte d’appareil, qui n’hérite pas de sa disposition d’une fenêtre. Une telle orientation de droite à gauche est nécessaire pour les applications écrites pour les cultures, telles que l’arabe ou l’hébreu, où la disposition des caractères n’est pas la norme européenne.

CDC contient deux contextes d’appareil et m_hDC m_hAttribDC, lors de la création d’un CDC objet, font référence au même appareil. CDC dirige tous les appels GDI de sortie vers m_hDC et la plupart des appels GDI d’attribut vers m_hAttribDC. (Un exemple d’appel d’attribut est GetTextColor, tandis qu’il SetTextColor s’agit d’un appel de sortie.)

Par exemple, l’infrastructure utilise ces deux contextes d’appareil pour implémenter un CMetaFileDC objet qui envoie la sortie à un métafichier lors de la lecture d’attributs à partir d’un appareil physique. L’aperçu avant impression est implémenté dans l’infrastructure de manière similaire. Vous pouvez également utiliser les deux contextes d’appareil de manière similaire dans votre code spécifique à l’application.

Il existe des moments où vous pouvez avoir besoin d’informations de métrique de texte à partir des contextes de l’appareil et m_hAttribDC des m_hDC contextes d’appareil. Les paires de fonctions suivantes fournissent cette fonctionnalité :

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

Pour plus d’informations sur CDC, consultez Contextes de l’appareil.

Hiérarchie d'héritage

CObject

CDC

Spécifications

En-tête : afxwin.h

`CDC::AbortDoc`

Met fin au travail d’impression actuel et efface tout ce que l’application a écrit sur l’appareil depuis le dernier appel à la StartDoc fonction membre.

int AbortDoc();

Valeur de retour

Valeur supérieure ou égale à 0 si elle réussit ou une valeur négative si une erreur s’est produite. La liste suivante présente les valeurs d’erreur courantes et leurs significations :

SP_ERROR Erreur générale.
SP_OUTOFDISK L’espace disque insuffisant est actuellement disponible pour lepooling, et aucun espace supplémentaire ne sera disponible.
SP_OUTOFMEMORY La mémoire insuffisante est disponible pour lepooling.
SP_USERABORT L’utilisateur a terminé le travail via le Gestionnaire d’impression.

Notes

Cette fonction membre remplace l’échappement de l’imprimante ABORTDOC .

AbortDoc doit être utilisé pour terminer les opérations suivantes :

Opérations d’impression qui ne spécifient pas de fonction d’abandon à l’aide SetAbortProcde .
Opérations d’impression qui n’ont pas encore atteint leur premier NEWFRAME appel ou NEXTBAND appel d’échappement.

Si une application rencontre une erreur d’impression ou une opération d’impression annulée, elle ne doit pas tenter de mettre fin à l’opération à l’aide des fonctions membres ou AbortDoc de la EndDoc classe CDC. GDI met automatiquement fin à l’opération avant de retourner la valeur d’erreur.

Si l’application affiche une boîte de dialogue pour permettre à l’utilisateur d’annuler l’opération d’impression, elle doit appeler AbortDoc avant de détruire la boîte de dialogue.

Si le Gestionnaire d’impression a été utilisé pour démarrer la tâche d’impression, l’appel AbortDoc efface l’intégralité du travail de spoulage : l’imprimante ne reçoit rien. Si le Gestionnaire d’impression n’a pas été utilisé pour démarrer le travail d’impression, les données ont peut-être été envoyées à l’imprimante avant AbortDoc d’être appelées. Dans ce cas, le pilote d’imprimante aurait réinitialisé l’imprimante (le cas échéant) et fermé le travail d’impression.

Exemple

Consultez l’exemple pour CDC::StartDoc.

`CDC::AbortPath`

Ferme et ignore tous les chemins d’accès dans le contexte de l’appareil.

BOOL AbortPath();

Valeur de retour

Une valeur différente de zéro si la fonction réussit ; sinon, 0.

Notes

S’il existe un crochet de chemin ouvert dans le contexte de l’appareil, le crochet de chemin est fermé et le chemin est ignoré. S’il existe un chemin fermé dans le contexte de l’appareil, le chemin est ignoré.

`CDC::AddMetaFileComment`

Copie le commentaire d’une mémoire tampon dans un métafichier de format amélioré spécifié.

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

Paramètres

nDataSize
Spécifie la longueur de la mémoire tampon de commentaire, en octets.

pCommentData
Pointe vers la mémoire tampon qui contient le commentaire.

Valeur de retour

Une valeur différente de zéro si la fonction réussit ; sinon, 0.

Notes

Un commentaire peut inclure des informations privées , par exemple la source de l’image et la date à laquelle elle a été créée. Un commentaire doit commencer par une signature d’application, suivi des données. Les commentaires ne doivent pas contenir de données spécifiques à la position. Les données spécifiques à la position spécifient l’emplacement d’un enregistrement et ne doivent pas être incluses, car un métafichier peut être incorporé dans un autre métafichier. Cette fonction ne peut être utilisée qu’avec des métafichiers améliorés.

`CDC::AlphaBlend`

Appelez cette fonction membre pour afficher des bitmaps qui ont des pixels transparents ou semi-transparents.

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

Paramètres

xDest
Spécifie la coordonnée x, en unités logiques, du coin supérieur gauche du rectangle de destination.

yDest
Spécifie la coordonnée y, en unités logiques, du coin supérieur gauche du rectangle de destination.

nDestWidth
Spécifie la largeur, en unités logiques, du rectangle de destination.

nDestHeight
Spécifie la hauteur, en unités logiques, du rectangle de destination.

pSrcDC
Pointeur vers le contexte de l’appareil source.

xSrc
Spécifie la coordonnée x, en unités logiques, du coin supérieur gauche du rectangle source.

ySrc
Spécifie la coordonnée y, en unités logiques, du coin supérieur gauche du rectangle source.

nSrcWidth
Spécifie la largeur, en unités logiques, du rectangle source.

nSrcHeight
Spécifie la hauteur, en unités logiques, du rectangle source.

blend
Spécifie une BLENDFUNCTION structure.

Valeur de retour

TRUE en cas de réussite ; sinon, FALSE.

Notes

Pour plus d’informations, consultez AlphaBlend le Kit de développement logiciel (SDK) Windows.

`CDC::AngleArc`

Dessine un segment de trait et un arc.

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

Paramètres

x
Spécifie la coordonnée x logique du centre du cercle.

y
Spécifie la coordonnée y logique du centre du cercle.

nRadius
Spécifie le rayon du cercle en unités logiques. Cette valeur doit être positive.

fStartAngle
Spécifie l’angle de départ en degrés par rapport à l’axe x.

fSweepAngle
Spécifie l’angle de balayage en degrés par rapport à l’angle de départ.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Le segment de trait est dessiné de la position actuelle au début de l’arc. L’arc est dessiné le long du périmètre d’un cercle avec le rayon et le centre donnés. La longueur de l’arc est définie par le début et les angles de balayage donnés.

AngleArc déplace la position actuelle vers le point de fin de l’arc. L’arc dessiné par cette fonction peut sembler elliptique, en fonction de la transformation actuelle et du mode de mappage. Avant de dessiner l’arc, cette fonction dessine le segment de trait de la position actuelle jusqu’au début de l’arc. L’arc est dessiné en construisant un cercle imaginaire avec le rayon spécifié autour du point central spécifié. Le point de départ de l’arc est déterminé en mesurant le sens inverse à partir de l’axe x du cercle par le nombre de degrés dans l’angle de début. Le point de terminaison se trouve de la même façon en mesurant le point de départ à partir du point de départ par le nombre de degrés dans l’angle de balayage.

Si l’angle de balayage est supérieur à 360 degrés, l’arc est balayé plusieurs fois. Cette fonction dessine des lignes à l’aide du stylet actuel. La figure n’est pas remplie.

`CDC::Arc`

Dessine un arc elliptique.

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);

Paramètres

x1
Spécifie la coordonnée x du coin supérieur gauche du rectangle englobant (en unités logiques).

y1
Spécifie la coordonnée y du coin supérieur gauche du rectangle englobant (en unités logiques).

x2
Spécifie la coordonnée x du coin inférieur droit du rectangle englobant (en unités logiques).

y2
Spécifie la coordonnée y du coin inférieur droit du rectangle englobant (en unités logiques).

x3
Spécifie la coordonnée x du point qui définit le point de départ de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc.

y3
Spécifie la coordonnée y du point qui définit le point de départ de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc.

x4
Spécifie la coordonnée x du point qui définit le point de terminaison de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc.

y4
Spécifie la coordonnée y du point qui définit le point de terminaison de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc.

lpRect
Spécifie le rectangle englobant (en unités logiques). Vous pouvez passer un LPRECT ou un CRect objet pour ce paramètre.

ptStart
Spécifie les coordonnées x et y du point qui définit le point de départ de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc. Vous pouvez passer une POINT structure ou un CPoint objet pour ce paramètre.

ptEnd
Spécifie les coordonnées x et y du point qui définit le point de fin de l’arc (en unités logiques). Ce point n’a pas à mentir exactement sur l’arc. Vous pouvez passer une POINT structure ou un CPoint objet pour ce paramètre.

Valeur de retour

Une valeur différente de zéro si la fonction réussit ; sinon, 0.

Notes

L’arc dessiné à l’aide de la fonction est un segment de l’ellipse défini par le rectangle englobant spécifié.

Le point de départ réel de l’arc est le point auquel un rayon dessiné à partir du centre du rectangle englobant à travers le point de départ spécifié croise l’ellipse. Le point de fin réel de l’arc est le point auquel un rayon dessiné à partir du centre du rectangle englobant à travers le point de fin spécifié croise l’ellipse. L’arc est dessiné dans un sens inverse. Étant donné qu’un arc n’est pas une figure fermée, il n’est pas rempli. La largeur et la hauteur du rectangle doivent être supérieures à 2 unités et inférieures à 32 767 unités.

Exemple

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`

Dessine un arc elliptique.

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);