Gdi::GetDeviceCaps_I (Windows Embedded CE 6.0)

1/6/2010

This method retrieves information about the capabilities of a specified device.

Syntax

static WINGDIAPI int WINAPI GetDeviceCaps_I(
  HDC hdc,
  int nIndex
);

Parameters

• hdc
  [in] Handle to the device context.

• nIndex
  [in] Integer that specifies the item to return.

  The following table shows the possible values.

  Value	Description
  DRIVERVERSION	The device driver version.
  TECHNOLOGY	Device technology. The following shows the possible return values is nIndex is set to TECHNOLOGY.
  	DT_PLOTTER
  	DT_RASDISPLAY
  	DT_RASPRINTER
  	DT_RASCAMERA
  	DT_CHARSTREAM
  	DT_DISPFILE
  HORZSIZE	Width, in millimeters, of the physical screen.
  VERTSIZE	Height, in millimeters, of the physical screen.
  HORZRES	Width, in pixels, of the screen.
  VERTRES	Height, in raster lines, of the screen.
  LOGPIXELSX	Number of pixels per logical inch along the screen width. In a system with multiple screens, this value is the same for all screens.
  LOGPIXELSY	Number of pixels per logical inch along the screen height. In a system with multiple screens, this value is the same for all screens.
  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 color table for the device, if the device has a color depth of no more than 8 bits per pixel. For devices with greater color depths, –1 is returned.
  ASPECTX	Relative width of a device pixel used for line drawing.
  ASPECTY	Relative height of a device pixel used for line drawing.
  ASPECTXY	Diagonal width of the device pixel used for line drawing.
  PDEVICESIZE	Reserved.
  CLIPCAPS	Flag that indicates the clipping capabilities of the device. If the device can clip to a rectangle, it is 1. Otherwise, it is 0.
  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 and is available only if the driver is compatible with 16-bit Windows.
  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 and is available only if the driver is compatible with 16-bit Windows.
  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 and is available only if the driver is compatible with 16-bit Windows.
  PHYSICALWIDTH	The width of the physical page, in device units, for printing devices. For example, a printer set to print at 600 dpi on 8.5"x11" paper has a physical width value of 5100 device units. The physical page is almost always greater than the printable area of the page, and never smaller.
  PHYSICALHEIGHT	The height of the physical page, in device units, for printing devices. For example, a printer set to print at 600 dpi on 8.5"x11" paper has a physical height value of 6600 device units. The physical page is almost always greater than the printable area of the page, and never smaller.
  PHYSICALOFFSETX	The distance from the left edge of the physical page to the left edge of the printable area, in device units, for printing devices. For example, a printer set to print at 600 dpi on 8.5"x11" paper that cannot print on the leftmost 0.25" of paper has a horizontal physical offset of 150 device units.
  PHYSICALOFFSETY	The distance from the top edge of the physical page to the top edge of the printable area, in device units, for printing devices. For example, a printer set to print at 600 dpi on 8.5"x11" paper that cannot print on the topmost 0.5" of paper has a vertical physical offset of 300 device units.
  RASTERCAPS	Value that indicates the raster capabilities of the device. The following shows the possible return values is nIndex is set to RASTERCAPS.
  	RC_BANDING
  	RC_BITBLT
  	RC_BITMAP64
  	RC_DI_BITMAP
  	RC_DIBTODEV
  	RC_GDI20_OUTPUT
  	RC_PALETTE
  	RC_SCALING
  	RC_STRETCHBLT
  	RC_STRETCHDIB
  CURVECAPS	Value that indicates the curve capabilities of the device. The following shows the possible return values is nIndex is set to CURVECAPS.
  	CC_NONE
  	CC_CHORD
  	CC_CIRCLES
  	CC_ELLIPSES
  	CC_INTERIORS
  	CC_PIE
  	CC_ROUNDRECT
  	CC_STYLED
  	CC_WIDE
  	CC_WIDESTYLED
  LINECAPS	Value that indicates the line capabilities of the device. The following shows the possible return values is nIndex is set to LINECAPS.
  	LC_NONE
  	LC_INTERIORS
  	LC_MARKER
  	LC_POLYLINE
  	LC_POLYMARKER
  	LC_STYLED
  	LC_WIDE
  	LC_WIDESTYLED
  POLYGONALCAPS	Value that indicates the polygon capabilities of the device. The following shows the possible return values is nIndex is set to POLYGONALCAPS.
  	PC_NONE
  	PC_INTERIORS
  	PC_POLYGON
  	PC_RECTANGLE
  	PC_SCANLINE
  	PC_STYLED
  	PC_WIDE
  	PC_WIDESTYLED
  	PC_WINDPOLYGON
  TEXTCAPS	Value that indicates the text capabilities of the device. The following shows the possible return values is nIndex is set to TEXTCAPS.
  	TC_OP_CHARACTER
  	TC_OP_STROKE
  	TC_CP_STROKE
  	TC_CR_90
  	TC_CR_ANY
  	TC_SF_X_YINDEP
  	TC_SA_DOUBLE
  	TC_SA_INTEGER
  	TC_SA_CONTIN
  	TC_EA_DOUBLE
  	TC_IA_ABLE
  	TC_UA_ABLE
  	TC_SO_ABLE
  	TC_RA_ABLE
  	TC_VA_ABLE
  	TC_RESERVED
  	TC_SCROLLBLT

Return Value

Returns the value of the desired item.

Remarks

This method is an internal version of the GetDeviceCaps function.

The following table shows the six indexes that Gdi::GetDeviceCaps_I provides in place of printer escapes.

Index	Printer escape replaced
PHYSICALWIDTH	GETPHYSPAGESIZE
PHYSICALHEIGHT	GETPHYSPAGESIZE
PHYSICALOFFSETX	GETPRINTINGOFFSET
PHYSICALOFFSETY	GETPHYSICALOFFSET

Requirements

Header	gdi.hpp
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

Gdi
GetDeviceCaps
Gdi::GetObjectType_I
Gdi::StretchBlt_I