CDC Class Members
Data Members
Construction/Destruction
Initialization
Device-Context Functions
Drawing-Tool Functions
Type-Safe Selection. Helpers
Color and Color Palette Functions
Drawing-Attribute Functions
Mapping Functions
Coordinate Functions
Region Functions
Clipping Functions
Line-Output Functions
Simple Drawing Functions
Ellipse and Polygon Functions
Bitmap Functions
Text Functions
Font Functions
Printer Escape Functions
Scrolling Functions
Metafile Functions
Path Functions
Data Members
| m_hDC | The output-device context used by this CDC object. |
| m_hAttribDC | The attribute-device context used by this CDC object. |
Construction
| CDC | Constructs a CDC object. |
Initialization
| CreateDC | Creates a device context for a specific device. |
| CreateIC | Creates an information context for a specific device. This provides a fast way to get information about the device without creating a device context. |
| CreateCompatibleDC | Creates a memory-device context that is compatible with another device context. You can use it to prepare images in memory. |
| DeleteDC | Deletes the Windows device context associated with this CDC object. |
| FromHandle | Returns a pointer to a CDC object when given a handle to a device context. If a CDC object is not attached to the handle, a temporary CDC object is created and attached. |
| DeleteTempMap | Called by the CWinApp idle-time handler to delete any temporary CDC object created by FromHandle. Also detaches the device context. |
| Attach | Attaches a Windows device context to this CDC object. |
| Detach | Detaches the Windows device context from this CDC object. |
| SetAttribDC | Sets m_hAttribDC, the attribute device context. |
| SetOutputDC | Sets m_hDC, the output device context. |
| ReleaseAttribDC | Releases m_hAttribDC, the attribute device context. |
| ReleaseOutputDC | Releases m_hDC, the output device context. |
| GetCurrentBitmap | Returns a pointer to the currently selected CBitmap object. |
| GetCurrentBrush | Returns a pointer to the currently selected CBrush object. |
| GetCurrentFont | Returns a pointer to the currently selected CFont object. |
| GetCurrentPalette | Returns a pointer to the currently selected CPalette object. |
| GetCurrentPen | Returns a pointer to the currently selected CPen object. |
| GetWindow | Returns the window associated with the display device context. |
Device-Context Functions
| GetSafeHdc | Returns m_hDC, the output device context. |
| SaveDC | Saves the current state of the device context. |
| RestoreDC | Restores the device context to a previous state saved with SaveDC. |
| ResetDC | Updates the m_hAttribDC device context. |
| GetDeviceCaps | Retrieves a specified kind of device-specific information about a given display device’s capabilities. |
| IsPrinting | Determines whether the device context is being used for printing. |
Drawing-Tool Functions
| GetBrushOrg | Retrieves the origin of the current brush. |
| SetBrushOrg | Specifies the origin for the next brush selected into a device context. |
| EnumObjects | Enumerates the pens and brushes available in a device context. |
Type-Safe Selection Helpers
| SelectObject | Selects a GDI drawing object such as a pen. |
| SelectStockObject | Selects one of the predefined stock pens, brushes, or fonts provided by Windows. |
Color and Color Palette Functions
| GetNearestColor | Retrieves the closest logical color to a specified logical color that the given device can represent. |
| SelectPalette | Selects the logical palette. |
| RealizePalette | Maps palette entries in the current logical palette to the system palette. |
| UpdateColors | Updates the client area of the device context by matching the current colors in the client area to the system palette on a pixel-by-pixel basis. |
| GetHalftoneBrush | Retrieves a halftone brush. |
Drawing-Attribute Functions
| GetBkColor | Retrieves the current background color. |
| SetBkColor | Sets the current background color. |
| GetBkMode | Retrieves the background mode. |
| SetBkMode | Sets the background mode. |
| GetPolyFillMode | Retrieves the current polygon-filling mode. |
| SetPolyFillMode | Sets the polygon-filling mode. |
| GetROP2 | Retrieves the current drawing mode. |
| SetROP2 | Sets the current drawing mode. |
| GetStretchBltMode | Retrieves the current bitmap-stretching mode. |
| SetStretchBltMode | Sets the bitmap-stretching mode. |
| GetTextColor | Retrieves the current text color. |
| SetTextColor | Sets the text color. |
| GetColorAdjustment | Retrieves the color adjustment values for the device context. |
| SetColorAdjustment | Sets the color adjustment values for the device context using the specified values. |
Mapping Functions
| GetMapMode | Retrieves the current mapping mode. |
| SetMapMode | Sets the current mapping mode. |
| GetViewportOrg | Retrieves the x- and y-coordinates of the viewport origin. |
| SetViewportOrg | Sets the viewport origin. |
| OffsetViewportOrg | Modifies the viewport origin relative to the coordinates of the current viewport origin. |
| GetViewportExt | Retrieves the x- and y-extents of the viewport. |
| SetViewportExt | Sets the x- and y-extents of the viewport. |
| ScaleViewportExt | Modifies the viewport extent relative to the current values. |
| GetWindowOrg | Retrieves the x- and y-coordinates of the origin of the associated window. |
| SetWindowOrg | Sets the window origin of the device context. |
| OffsetWindowOrg | Modifies the window origin relative to the coordinates of the current window origin. |
| GetWindowExt | Retrieves the x- and y-extents of the associated window. |
| SetWindowExt | Sets the x- and y-extents of the associated window. |
| ScaleWindowExt | Modifies the window extents relative to the current values. |
Coordinate Functions
| DPtoHIMETRIC | Converts device units into HIMETRIC units. |
| DPtoLP | Converts device units into logical units. |
| HIMETRICtoDP | Converts HIMETRIC units into device units. |
| HIMETRICtoLP | Converts HIMETRIC units into logical units. |
| LPtoDP | Converts logical units into device units. |
| LPtoHIMETRIC | Converts logical units into HIMETRIC units. |
Region Functions
| FillRgn | Fills a specific region with the specified brush. |
| FrameRgn | Draws a border around a specific region using a brush. |
| InvertRgn | Inverts the colors in a region. |
| PaintRgn | Fills a region with the selected brush. |
Clipping Functions
| SetBoundsRect | Controls the accumulation of bounding-rectangle information for the specified device context. |
| GetBoundsRect | Returns the current accumulated bounding rectangle for the specified device context. |
| GetClipBox | Retrieves the dimensions of the tightest bounding rectangle around the current clipping boundary. |
| SelectClipRgn | Combines the given region with the current clipping region by using the specified mode. |
| ExcludeClipRect | Creates a new clipping region that consists of the existing clipping region minus the specified rectangle. |
| ExcludeUpdateRgn | Prevents drawing within invalid areas of a window by excluding an updated region in the window from a clipping region. |
| IntersectClipRect | Creates a new clipping region by forming the intersection of the current region and a rectangle. |
| OffsetClipRgn | Moves the clipping region of the given device. |
| PtVisible | Specifies whether the given point is within the clipping region. |
| RectVisible | Determines whether any part of the given rectangle lies within the clipping region. |
Line-Output Functions
| GetCurrentPosition | Retrieves the current position of the pen (in logical coordinates). |
| MoveTo | Moves the current position. |
| LineTo | Draws a line from the current position up to, but not including, a point. |
| Arc | Draws an elliptical arc. |
| ArcTo | Draws an elliptical arc. This function is similar to Arc, except that the current position is updated. |
| AngleArc | Draws a line segment and an arc, and moves the current position to the ending point of the arc. |
| GetArcDirection | Returns the current arc direction for the device context. |
| SetArcDirection | Sets the drawing direction to be used for arc and rectangle functions. |
| PolyDraw | Draws a set of line segments and Bézier splines. This function updates the current position. |
| Polyline | Draws a set of line segments connecting the specified points. |
| PolyPolyline | Draws multiple series of connected line segments. The current position is neither used nor updated by this function. |
| PolylineTo | Draws one or more straight lines and moves the current position to the ending point of the last line. |
| PolyBezier | Draws one or more Bézier splines. The current position is neither used nor updated. |
| PolyBezierTo | Draws one or more Bézier splines, and moves the current position to the ending point of the last Bézier spline. |
Simple Drawing Functions
| FillRect | Fills a given rectangle by using a specific brush. |
| FrameRect | Draws a border around a rectangle. |
| InvertRect | Inverts the contents of a rectangle. |
| DrawIcon | Draws an icon. |
| DrawDragRect | Erases and redraws a rectangle as it is dragged. |
| FillSolidRect | Fills a rectangle with a solid color. |
| Draw3dRect | Draws a three-dimensional rectangle. |
| DrawEdge | Draws the edges of a rectangle. |
| DrawFrameControl | Draw a frame control. |
| DrawState | Displays an image and applies a visual effect to indicate a state. |
Ellipse and Polygon Functions
| Chord | Draws a chord (a closed figure bounded by the intersection of an ellipse and a line segment). |
| DrawFocusRect | Draws a rectangle in the style used to indicate focus. |
| Ellipse | Draws an ellipse. |
| Pie | Draws a pie-shaped wedge. |
| Polygon | Draws a polygon consisting of two or more points (vertices) connected by lines. |
| PolyPolygon | Creates two or more polygons that are filled using the current polygon-filling mode. The polygons may be disjoint or they may overlap. |
| Polyline | Draws a polygon consisting of a set of line segments connecting specified points. |
| Rectangle | Draws a rectangle using the current pen and fills it using the current brush. |
| RoundRect | Draws a rectangle with rounded corners using the current pen and filled using the current brush. |
Bitmap Functions
| PatBlt | Creates a bit pattern. |
| BitBlt | Copies a bitmap from a specified device context. |
| StretchBlt | Moves a bitmap from a source rectangle and device into a destination rectangle, stretching or compressing the bitmap if necessary to fit the dimensions of the destination rectangle. |
| GetPixel | Retrieves the RGB color value of the pixel at the specified point. |
| SetPixel | Sets the pixel at the specified point to the closest approximation of the specified color. |
| SetPixelV | Sets the pixel at the specified coordinates to the closest approximation of the specified color. SetPixelV is faster than SetPixel because it does not need to return the color value of the point actually painted. |
| FloodFill | Fills an area with the current brush. |
| ExtFloodFill | Fills an area with the current brush. Provides more flexibility than the FloodFill member function. |
| MaskBlt | Combines the color data for the source and destination bitmaps using the given mask and raster operation. |
| PlgBlt | Performs a bit-block transfer of the bits of color data from the specified rectangle in the source device context to the specified parallelogram in the given device context. |
Text Functions
| TextOut | Writes a character string at a specified location using the currently selected font. |
| ExtTextOut | Writes a character string within a rectangular region using the currently selected font. |
| TabbedTextOut | Writes a character string at a specified location, expanding tabs to the values specified in an array of tab-stop positions. |
| DrawText | Draws formatted text in the specified rectangle. |
| GetTextExtent | Computes the width and height of a line of text on the attribute device context using the current font to determine the dimensions. |
| GetOutputTextExtent | Computes the width and height of a line of text on the output device context using the current font to determine the dimensions. |
| GetTabbedTextExtent | Computes the width and height of a character string on the attribute device context. |
| GetOutputTabbedTextExtent | Computes the width and height of a character string on the output device context. |
| GrayString | Draws dimmed (grayed) text at the given location. |
| GetTextAlign | Retrieves the text-alignment flags. |
| SetTextAlign | Sets the text-alignment flags. |
| GetTextFace | Copies the typeface name of the current font into a buffer as a null-terminated string. |
| GetTextMetrics | Retrieves the metrics for the current font from the attribute device context. |
| GetOutputTextMetrics | Retrieves the metrics for the current font from the output device context. |
| SetTextJustification | Adds space to the break characters in a string. |
| GetTextCharacterExtra | Retrieves the current setting for the amount of intercharacter spacing. |
| SetTextCharacterExtra | Sets the amount of intercharacter spacing. |
Font Functions
| GetFontData | Retrieves font metric information from a scalable font file. The information to retrieve is identified by specifying an offset into the font file and the length of the information to return. |
| GetKerningPairs | Retrieves the character kerning pairs for the font that is currently selected in the specified device context. |
| GetOutlineTextMetrics | Retrieves font metric information for TrueType fonts. |
| GetGlyphOutline | Retrieves the outline curve or bitmap for an outline character in the current font. |
| GetCharABCWidths | Retrieves the widths, in logical units, of consecutive characters in a given range from the current font. |
| GetCharWidth | Retrieves the fractional widths of consecutive characters in a given range from the current font. |
| GetOutputCharWidth | Retrieves the widths of individual characters in a consecutive group of characters from the current font using the output device context. |
| SetMapperFlags | Alters the algorithm that the font mapper uses when it maps logical fonts to physical fonts. |
| GetAspectRatioFilter | Retrieves the setting for the current aspect-ratio filter. |
Printer Escape Functions
| QueryAbort | Calls the callback function for a printing application and queries whether the printing should be terminated. |
| Escape | Allows applications to access facilities that are not directly available from a particular device through GDI. Also allows access to Windows escape functions. Escape calls made by an application are translated and sent to the device driver. |
| DrawEscape | Accesses drawing capabilities of a video display that are not directly available through the graphics device interface (GDI). |
| StartDoc | Informs the device driver that a new print job is starting. |
| StartPage | Informs the device driver that a new page is starting. |
| EndPage | Informs the device driver that a page is ending. |
| SetAbortProc | Sets a programmer-supplied callback function that Windows calls if a print job must be aborted. |
| AbortDoc | Terminates the current print job, erasing everything the application has written to the device since the last call of the StartDoc member function. |
| EndDoc | Ends a print job started by the StartDoc member function. |
Scrolling Functions
| ScrollDC | Scrolls a rectangle of bits horizontally and vertically. |
Metafile Functions
| PlayMetaFile | Plays the contents of the specified metafile on the given device. The enhanced version of PlayMetaFile displays the picture stored in the given enhanced-format metafile. The metafile can be played any number of times. |
| AddMetaFileComment | Copies the comment from a buffer into a specified enhanced-format metafile. |
Path Functions
| AbortPath | Closes and discards any paths in the device context. |
| BeginPath | Opens a path bracket in the device context. |
| CloseFigure | Closes an open figure in a path. |
| EndPath | Closes a path bracket and selects the path defined by the bracket into the device context. |
| FillPath | Closes any open figures in the current path and fills the path’s interior by using the current brush and polygon-filling mode. |
| FlattenPath | Transforms any curves in the path selected into the current device context, and turns each curve into a sequence of lines. |
| GetMiterLimit | Returns the miter limit for the device context. |
| GetPath | Retrieves the coordinates defining the endpoints of lines and the control points of curves found in the path that is selected into the device context. |
| SelectClipPath | Selects the current path as a clipping region for the device context, combining the new region with any existing clipping region by using the specified mode. |
| SetMiterLimit | Sets the limit for the length of miter joins for the device context. |
| StrokeAndFillPath | Closes any open figures in a path, strikes the outline of the path by using the current pen, and fills its interior by using the current brush. |
| StrokePath | Renders the specified path by using the current pen. |
| WidenPath | Redefines the current path as the area that would be painted if the path were stroked using the pen currently selected into the device context. |