This documentation is archived and is not being maintained.

CDC Members 

Base Class Members

CObject Members

Data Members

m_hAttribDC

The attribute-device context used by this CDC object.

m_hDC

The output-device context used by this CDC object.

Construction

CDC

Constructs a CDC object.

Initialization

Attach

Attaches a Windows device context to this CDC object.

CreateCompatibleDC

Creates a memory-device context that is compatible with another device context. You can use it to prepare images in memory.

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.

DeleteDC

Deletes the Windows device context associated with this CDC object.

DeleteTempMap

Called by the CWinApp idle-time handler to delete any temporary CDC object created by FromHandle. Also detaches the device context.

Detach

Detaches the Windows device context from 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.

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.

GetGraphicsMode

Retrieves the current graphics mode for the specified device context.

GetWindow

Returns the window associated with the display device context.

ReleaseAttribDC

Releases m_hAttribDC, the attribute device context.

ReleaseOutputDC

Releases m_hDC, the output device context.

SetAttribDC

Sets m_hAttribDC, the attribute device context.

SetOutputDC

Sets m_hDC, the output device context.

SetGraphicsMode

Sets the current graphics mode for the specified device context.

Device-Context Functions

GetDeviceCaps

Retrieves a specified kind of device-specific information about a given display device's capabilities.

GetSafeHdc

Returns m_hDC, the output device context.

IsPrinting

Determines whether the device context is being used for printing.

ResetDC

Updates the m_hAttribDC device context.

RestoreDC

Restores the device context to a previous state saved with SaveDC.

SaveDC

Saves the current state of the device context.

Drawing-Tool Functions

EnumObjects

Enumerates the pens and brushes available in a device context.

GetBrushOrg

Retrieves the origin of the current brush.

SetBrushOrg

Specifies the origin for the next brush selected into 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

GetHalftoneBrush

Retrieves a halftone brush.

GetNearestColor

Retrieves the closest logical color to a specified logical color that the given device can represent.

RealizePalette

Maps palette entries in the current logical palette to the system palette.

SelectPalette

Selects the logical 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.

Drawing-Attribute Functions

GetBkColor

Retrieves the current background color.

GetBkMode

Retrieves the background mode.

GetColorAdjustment

Retrieves the color adjustment values for the device context.

GetDCBrushColor

Retrieves the current brush color.

GetDCPenColor

Retrieves the current pen color.

GetPolyFillMode

Retrieves the current polygon-filling mode.

GetROP2

Retrieves the current drawing mode.

GetStretchBltMode

Retrieves the current bitmap-stretching mode.

GetTextColor

Retrieves the current text color.

SetBkColor

Sets the current background color.

SetBkMode

Sets the background mode.

SetColorAdjustment

Sets the color adjustment values for the device context using the specified values.

SetDCBrushColor

Sets the current brush color.

SetDCPenColor

Sets the current pen color.

SetPolyFillMode

Sets the polygon-filling mode.

SetROP2

Sets the current drawing mode.

SetStretchBltMode

Sets the bitmap-stretching mode.

SetTextColor

Sets the text color.

Mapping Functions

GetMapMode

Retrieves the current mapping mode.

GetViewportExt

Retrieves the x- and y-extents of the viewport.

GetViewportOrg

Retrieves the x- and y-coordinates of the viewport origin.

GetWindowExt

Retrieves the x- and y-extents of the associated window.

GetWindowOrg

Retrieves the x- and y-coordinates of the origin of the associated window.

GetWorldTransform

Retrieves the current world-space to page-space transformation.

ModifyWorldTransform

Changes the world transformation for a device context using the specified mode.

OffsetViewportOrg

Modifies the viewport origin relative to the coordinates of the current viewport origin.

OffsetWindowOrg

Modifies the window origin relative to the coordinates of the current window origin.

ScaleViewportExt

Modifies the viewport extent relative to the current values.

ScaleWindowExt

Modifies the window extents relative to the current values.

SetMapMode

Sets the current mapping mode.

SetViewportExt

Sets the x- and y-extents of the viewport.

SetViewportOrg

Sets the viewport origin.

SetWindowExt

Sets the x- and y-extents of the associated window.

SetWindowOrg

Sets the window origin of the device context.

GetWorldTransform

Sets the current world-space to page-space transformation.

Layout Functions

GetLayout

Retrieves the layout of a device context (DC). The layout can be either left to right (default) or right to left (mirrored).

SetLayout

Changes the layout of a device context (DC).

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

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.

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.

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.

SelectClipRgn

Combines the given region with the current clipping region by using the specified mode.

SetBoundsRect

Controls the accumulation of bounding-rectangle information for the specified device context.

Line-Output Functions

AngleArc

Draws a line segment and an arc, and moves the current position to the ending point of the arc.

Arc

Draws an elliptical arc.

ArcTo

Draws an elliptical arc. This function is similar to Arc, except that the current position is updated.

GetArcDirection

Returns the current arc direction for the device context.

GetCurrentPosition

Retrieves the current position of the pen (in logical coordinates).

LineTo

Draws a line from the current position up to, but not including, a point.

MoveTo

Moves the current position.

PolyBezier

Draws one or more Bzier splines. The current position is neither used nor updated.

PolyBezierTo

Draws one or more Bzier splines, and moves the current position to the ending point of the last Bzier spline.

PolyDraw

Draws a set of line segments and Bzier splines. This function updates the current position.

Polyline

Draws a set of line segments connecting the specified points.

PolylineTo

Draws one or more straight lines and moves the current position to the ending point of the last line.

PolyPolyline

Draws multiple series of connected line segments. The current position is neither used nor updated by this function.

SetArcDirection

Sets the drawing direction to be used for arc and rectangle functions.

Simple Drawing Functions

Draw3dRect

Draws a three-dimensional rectangle.

DrawDragRect

Erases and redraws a rectangle as it is dragged.

DrawEdge

Draws the edges of a rectangle.

DrawFrameControl

Draw a frame control.

DrawIcon

Draws an icon.

DrawState

Displays an image and applies a visual effect to indicate a state.

FillRect

Fills a given rectangle by using a specific brush.

FillSolidRect

Fills a rectangle with a solid color.

FrameRect

Draws a border around a rectangle.

InvertRect

Inverts the contents of a rectangle.

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.

Polyline

Draws a polygon consisting of a set of line segments connecting specified points.

PolyPolygon

Creates two or more polygons that are filled using the current polygon-filling mode. The polygons may be disjoint or they may overlap.

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

AlphaBlend

Displays bitmaps that have transparent or semitransparent pixels.

BitBlt

Copies a bitmap from a specified device context.

ExtFloodFill

Fills an area with the current brush. Provides more flexibility than the FloodFill member function.

FloodFill

Fills an area with the current brush.

GetPixel

Retrieves the RGB color value of the pixel at the specified point.

GradientFill

Fills rectangle and triangle structures with a gradating color.

MaskBlt

Combines the color data for the source and destination bitmaps using the given mask and raster operation.

PatBlt

Creates a bit pattern.

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.

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.

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.

TransparentBlt

Transfers a bit-block of color data from the specified source device context into a destination device context, rendering a specified color transparent in the transfer.

Text Functions

DrawText

Draws formatted text in the specified rectangle.

DrawTextEx

Draws formatted text in the specified rectangle using additional formats.

ExtTextOut

Writes a character string within a rectangular region using the currently selected font.

GetCharABCWidthsI

Retrieves the widths, in logical units, of consecutive glyph indices in a specified range from the current TrueType font.

GetCharacterPlacement

Retrieves various types of information on a character string.

GetCharWidthI

Retrieves the widths, in logical coordinates, of consecutive glyph indices in a specified range from the current font.

GetOutputTabbedTextExtent

Computes the width and height of a character string on the output device context.

GetOutputTextExtent

Computes the width and height of a line of text on the output device context using the current font to determine the dimensions.

GetOutputTextMetrics

Retrieves the metrics for the current font from the output device context.

GetTabbedTextExtent

Computes the width and height of a character string on the attribute device context.

GetTextAlign

Retrieves the text-alignment flags.

GetTextCharacterExtra

Retrieves the current setting for the amount of intercharacter spacing.

GetTextExtent

Computes the width and height of a line of text on the attribute device context using the current font to determine the dimensions.

GetTextExtentExPointI

Retrieves the number of characters in a specified string that will fit within a specified space and fills an array with the text extent for each of those characters.

GetTextExtentPointI

Retrieves the width and height of the specified array of glyph indices.

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.

GrayString

Draws dimmed (grayed) text at the given location.

SetTextAlign

Sets the text-alignment flags.

SetTextCharacterExtra

Sets the amount of intercharacter spacing.

SetTextJustification

Adds space to the break characters in a string.

TabbedTextOut

Writes a character string at a specified location, expanding tabs to the values specified in an array of tab-stop positions.

TextOut

Writes a character string at a specified location using the currently selected font.

Font Functions

GetAspectRatioFilter

Retrieves the setting for the current aspect-ratio filter.

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.

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.

GetFontLanguageInfo

Returns information about the currently selected font for the specified display context.

GetGlyphOutline

Retrieves the outline curve or bitmap for an outline character in the current font.

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.

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.

Printer Escape Functions

AbortDoc

Terminates the current print job, erasing everything the application has written to the device since the last call of the StartDoc member function.

DrawEscape

Accesses drawing capabilities of a video display that are not directly available through the graphics device interface (GDI).

EndDoc

Ends a print job started by the StartDoc member function.

EndPage

Informs the device driver that a page is ending.

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.

QueryAbort

Calls the AbortProc callback function for a printing application and queries whether the printing should be terminated.

SetAbortProc

Sets a programmer-supplied callback function that Windows calls if a print job must be aborted.

StartDoc

Informs the device driver that a new print job is starting.

StartPage

Informs the device driver that a new page is starting.

Scrolling Functions

ScrollDC

Scrolls a rectangle of bits horizontally and vertically.

Metafile Functions

AddMetaFileComment

Copies the comment from a buffer into a specified enhanced-format metafile.

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.

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.

Operators

operator HDC

Retrieves the handle of the device context.

See Also

Show: