GetDeviceCaps (Compact 2013)
3/28/2014
This function retrieves information about the capabilities of a specified device.
Syntax
int GetDeviceCaps(
HDC hdc,
int nIndex
);
Parameters
- hdc
[in] Handle to the device context.
nIndex
[in] Specifies the item to return.This parameter can be one of the following values.
Value
Description
ASPECTX
Relative width of a device pixel used for line drawing.
ASPECTXY
Diagonal width of the device pixel used for line drawing.
ASPECTY
Relative height of a device pixel used for line drawing.
BITSPIXEL
Number of adjacent color bits for each pixel.
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.
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.
CURVECAPS
Value that indicates the curve capabilities of the device, as shown in the following list:
CC_CHORD
CC_CIRCLES
CC_ELLIPSES
CC_INTERIORS
CC_NONE
CC_PIE
CC_ROUNDRECT
CC_STYLED
CC_WIDE
CC_WIDESTYLED
DRIVERVERSION
The device driver version.
HORZRES
Width, in pixels, of the screen.
HORZSIZE
Width, in millimeters, of the physical screen.
LINECAPS
Value that indicates the line capabilities of the device, as shown in the following list:
LC_INTERIORS
LC_MARKER
LC_NONE
LC_POLYLINE
LC_POLYMARKER
LC_STYLED
LC_WIDE
LC_WIDESTYLED
LOGPIXELSX
Number of pixels per logical inch along the screen width.
In a system with multiple display monitors, this value is the same for all monitors.
LOGPIXELSY
Number of pixels per logical inch along the screen height.
In a system with multiple display monitors, this value is the same for all monitors.
NUMBRUSHES
Number of device-specific brushes.
NUMCOLORS
Number of entries in the device's color table, if the device has a color depth of no more than 8 bits per pixel.
For devices with greater color depths, -1 is returned.
NUMFONTS
Number of device-specific fonts.
NUMPENS
Number of device-specific pens.
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.
PDEVICESIZE
Reserved.
PHYSICALHEIGHT
For printing devices: the height of the physical page, in device units.
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
For printing devices: the distance from the left edge of the physical page to the left edge of the printable area, in device units.
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
For printing devices: the distance from the top edge of the physical page to the top edge of the printable area, in device units.
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.
PHYSICALWIDTH
For printing devices: the width of the physical page, in device units.
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.
PLANES
Number of color planes.
POLYGONALCAPS
Value that indicates the polygon capabilities of the device, as shown in the following list:
PC_INTERIORS
PC_NONE
PC_POLYGON
PC_RECTANGLE
PC_SCANLINE
PC_STYLED
PC_WIDE
PC_WIDESTYLED
PC_WINDPOLYGON
RASTERCAPS
Value that indicates the raster capabilities of the device, as shown in the following list:
RC_BANDING
RC_BITBLT
RC_BITMAP64
RC_DI_BITMAP
RC_DIBTODEV
RC_GDI20_OUTPUT
RC_PALETTE
RC_SCALING
RC_STRETCHBLT
RC_STRETCHDIB
SHADEBLENDCAPS
Value that indicates the shading and blending capabilities of the device. See Remarks for further comments.
SB_CONST_ALPHA
SB_GRAD_RECT
SB_GRAD_TRI
0
SB_PIXEL_ALPHA
SB_PREMULT_ALPHA
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.
TECHNOLOGY
Device technology. It can be any one of the following values.
DT_PLOTTER
DT_RASDISPLAY
DT_RASPRINTER
DT_RASCAMERA
DT_CHARSTREAM
DT_DISPFILE
TEXTCAPS
Value that indicates the text capabilities of the device, as shown in the following list:
TC_CP_STROKE
TC_CR_90
TC_CR_ANY
TC_EA_DOUBLE
TC_IA_ABLE
TC_OP_CHARACTER
TC_OP_STROKE
TC_RA_ABLE
TC_RESERVED
TC_SA_CONTIN
TC_SA_DOUBLE
TC_SA_INTEGER
TC_SCROLLBLT
TC_SF_X_YINDEP
TC_SO_ABLE
TC_UA_ABLE
TC_VA_ABLE
TOUCHCAPS
Type of touch hardware controller supported by the device.
TC_NO_TOUCH
TC_SINGLE_TOUCH
TC_SYMMETRIC_TOUCH
TC_MULTI_TOUCH
VERTRES
Height, in raster lines, of the screen.
VERTSIZE
Height, in millimeters, of the physical screen.
Return Value
Returns the value of the desired item.
Remarks
The following table shows the six indexes that GetDeviceCaps provides in place of printer escapes.
Index |
Printer escape replaced |
|---|---|
PHYSICALWIDTH |
GETPHYSPAGESIZE |
PHYSICALHEIGHT |
GETPHYSPAGESIZE |
PHYSICALOFFSETX |
GETPRINTINGOFFSET |
PHYSICALOFFSETY |
GETPHYSICALOFFSET |
Requirements
Header |
windows.h |
Library |
coredll.lib |