GreDeviceQueryFontAttributes
GreDeviceQueryFontAttributes stores the metrics of the currently selected font at the location addressed by pfmMetrics. Note that the handling routine must transform device coordinates to world coordinates before returning the results to the calling routine. This transformation can be done by using GreConvert.
This function must be supported by the presentation driver.
- Simulation support
- None. This function is mandatory for all drivers.
Syntax
GreDeviceQueryFontAttributes(hdc, cMetrics, pfmMetrics, pInstance, lFunction)
Parameters
- hdc (HDC) - input
- Device context handle.
- cMetrics (ULONG) - input
- Size of FONTMETRICS structure.
- pfmMetrics (PFONTMETRICS) - input
- Pointer to FONTMETRICS structure.
- pInstance (PVOID) - input
- Pointer to instance data.
- lFunction (ULONG) - input
- High-order WORD=flags; low-order WORD=NGreDeviceQueryFontAttributes.
Return Code
- rc (BOOL) - returns
- Return Codes.
- On completion, the handling routine must return a BOOLEAN value to indicate success or an error.
- TRUE Successful
- FALSE Error
- Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:
- PMERR_DEV_FUNC_NOT_INSTALLED
- PMERR_INV_HDC
- Refer to the "Error Explanations" section in the Presentation Manager Programming Reference for further explanation.
Remarks
GreDeviceQueryFontAttributes is called from the graphics engine internal function GreQueryFontAttributes in response to an application calling one of the GpiQueryFontxxx() APIs. This call can be handled by bit-map simulation.