Share via


CDC::GetDeviceCapsĀ 

intGetDeviceCaps(intnIndex**)const;**

Return Value

The value of the requested capability if the function is successful.

Parameters

nIndex

Specifies the type of information to return. It can be any one of the following values:

  • DRIVERVERSION   Version number; for example, 0x100 for 1.0.

  • TECHNOLOGY   Device technology. It can be any one of the following:

Value Meaning
DT_PLOTTER Vector plotter
DT_RASDISPLAY Raster display
DT_RASPRINTER Raster printer
DT_RASCAMERA Raster camera
DT_CHARSTREAM Character stream
DT_METAFILE Metafile
DT_DISPFILE Display file
  • HORZSIZE   Width of the physical display (in millimeters).

  • VERTSIZE   Height of the physical display (in millimeters).

  • HORZRES   Width of the display (in pixels).

  • VERTRES   Height of the display (in raster lines).

  • LOGPIXELSX   Number of pixels per logical inch along the display width.

  • LOGPIXELSY   Number of pixels per logical inch along the display height.

  • BITSPIXEL   Number of adjacent color bits for each pixel.

  • PLANES   Number of color planes.

  • NUMBRUSHES   Number of device-specific brushes.

  • NUMPENS   Number of device-specific pens.

  • NUMFONTS   Number of device-specific fonts.

  • NUMCOLORS   Number of entries in the deviceā€™s color table.

  • ASPECTX   Relative width of a device pixel as used for line drawing.

  • ASPECTY   Relative height of a device pixel as used for line drawing.

  • ASPECTXY   Diagonal width of the device pixel as used for line drawing.

  • PDEVICESIZE   Size of the PDEVICE internal data structure.

  • CLIPCAPS   Clipping capabilities of the device. It can be one of the following:

Value Meaning
CP_NONE Output is not clipped.
CP_RECTANGLE Output is clipped to rectangles.
CP_REGION Output is clipped to regions.
  • SIZEPALETTE   Number of entries in the system palette. This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index.

  • NUMRESERVED   Number of reserved entries in the system palette. This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index.

  • COLORRES   Actual color resolution of the device in bits per pixel. This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index.

  • RASTERCAPS   Value that indicates the raster capabilities of the device. It can be a combination of the following:

Value Meaning
RC_BANDING Requires banding support.
RC_BIGFONT Supports fonts larger than 64K.
RC_BITBLT Capable of transferring bitmaps.
RC_BITMAP64 Supports bitmaps larger than 64K.
RC_DEVBITS Supports device bitmaps.
RC_DI_BITMAP Capable of supporting the SetDIBits and GetDIBits Windows functions.
RC_DIBTODEV Capable of supporting the SetDIBitsToDevice Windows function.
RC_FLOODFILL Capable of performing flood fills.
RC_GDI20_OUTPUT Capable of supporting Windows version 2.0 features.
RC_GDI20_STATE Includes a state block in the device context.
RC_NONE Supports no raster operations.
RC_OP_DX_OUTPUT Supports dev opaque and DX array.
RC_PALETTE Specifies a palette-based device.
RC_SAVEBITMAP Capable of saving bitmaps locally.
RC_SCALING Capable of scaling.
RC_STRETCHBLT Capable of performing the StretchBlt member function.
RC_STRETCHDIB Capable of performing the StretchDIBits Windows function.
  • CURVECAPS   The curve capabilities of the device. It can be a combination of the following:
Value Meaning
CC_NONE Supports curves.
CC_CIRCLES Supports circles.
CC_PIE Supports pie wedges.
CC_CHORD Supports chords.
CC_ELLIPSES Supports ellipses.
CC_WIDE Supports wide borders.
CC_STYLED Supports styled borders.
CC_WIDESTYLED Supports wide, styled borders.
CC_INTERIORS Supports interiors.
CC_ROUNDRECT Supports rectangles with rounded corners.
  • LINECAPS   Line capabilities the device supports. It can be a combination of the following:
Value Meaning
LC_NONE Supports no lines.
LC_POLYLINE Supports polylines.
LC_MARKER Supports markers.
LC_POLYMARKER Supports polymarkers.
LC_WIDE Supports wide lines.
LC_STYLED Supports styled lines.
LC_WIDESTYLED Supports wide, styled lines.
LC_INTERIORS Supports interiors.
  • POLYGONALCAPS   Polygonal capabilities the device supports. It can be a combination of the following:
Value Meaning
PC_NONE Supports no polygons.
PC_POLYGON Supports alternate fill polygons.
PC_RECTANGLE Supports rectangles.
PC_WINDPOLYGON Supports winding number fill polygons.
PC_SCANLINE Supports scan lines.
PC_WIDE Supports wide borders.
PC_STYLED Supports styled borders.
PC_WIDESTYLED Supports wide, styled borders.
PC_INTERIORS Supports interiors.
  • TEXTCAPS   Text capabilities the device supports. It can be a combination of the following:
Value Meaning
TC_OP_CHARACTER Supports character output precision, which indicates the device can place device fonts at any pixel location. This is required for any device with device fonts.
TC_OP_STROKE Supports stroke output precision, which indicates the device can omit any stroke of a device font.
TC_CP_STROKE Supports stroke clip precision, which indicates the device can clip device fonts to a pixel boundary.
TC_CR_90 Supports 90-degree character rotation, which indicates the device can rotate characters only 90 degrees at a time.
TC_CR_ANY Supports character rotation at any degree, which indicates the device can rotate device fonts through any angle.
TC_SF_X_YINDEP Supports scaling independent of x and y directions, which indicates the device can scale device fonts separately in x and y directions.
TC_SA_DOUBLE Supports doubled characters for scaling, which indicates the device can double the size of device fonts.
TC_SA_INTEGER Supports integer multiples for scaling, which indicates the device can scale the size of device fonts in any integer multiple.
TC_SA_CONTIN Supports any multiples for exact scaling, which indicates the device can scale device fonts by any amount but still preserve the x and y ratios.
TC_EA_DOUBLE Supports double-weight characters, which indicates the device can make device fonts bold. If this bit is not set for printer drivers, GDI attempts to create bold device fonts by printing them twice.
TC_IA_ABLE Supports italics, which indicates the device can make device fonts italic. If this bit is not set, GDI assumes italics are not available.
TC_UA_ABLE Supports underlining, which indicates the device can underline device fonts. If this bit is not set, GDI creates underlines for device fonts.
TC_SO_ABLE Supports strikeouts, which indicates the device can strikeout device fonts. If this bit is not set, GDI creates strikeouts for device fonts.
TC_RA_ABLE Supports raster fonts, which indicates that GDI should enumerate any raster or TrueType fonts available for this device in response to a call to the EnumFonts or EnumFontFamilies Windows functions. If this bit is not set, GDI-supplied raster or TrueType fonts are not enumerated when these functions are called.
TC_VA_ABLE Supports vector fonts, which indicates that GDI should enumerate any vector fonts available for this device in response to a call to the EnumFonts or EnumFontFamilies Windows functions. This is significant for vector devices only (that is, for plotters). Display drivers (which must be able to use raster fonts) and raster printer drivers always enumerate vector fonts, because GDI rasterizes vector fonts before sending them to the driver.
TC_RESERVED Reserved; must be 0.

Remarks

Retrieves a wide range of device-specific information about the display device.

Example

See the example for CPrintDialog::GetDefaults.

CDC OverviewClass MembersHierarchy Chart

See Also