GreQueryFontAttributes

GreQueryFontAttributes returns the metrics of the current font at the location addressed by pfmMetrics.

This function is supported by the graphics engine.

Syntax

GreQueryFontAttributes(hdc, cbMetrics, pfmMetrics, pInstance, lFunction)

Parameters

hdc (HDC) - input

Device context handle.

cbMetrics (LONG) - input

Size in bytes of the font metrics buffer.

pfmMetrics (PFONTMETRICS) - input

Pointer.

Pointer to font metric block where the information is to be returned.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreQueryFontAttributes.

Returns

fSuccess (BOOL) - returns

Return codes.

On completion, the handling routine must return BOOLEAN (fSuccess).

• TRUE Successful
• FALSE Error

Possible Errors Detected

When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:

• PMERR_COORDINATE_OVERFLOW
• PMERR_DEV_FUNC_NOT_INSTALLED
• PMERR_HDC_BUSY
• PMERR_INV_COORD_SPACE
• PMERR_INV_HDC
• PMERR_INV_LENGTH_OR_COUNT
• PMERR_INV_SETID

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Sample

#define INCL_GRE_FONTS
#include <os2.h>

HDC             hdc;         /*  Device context handle. */
LONG            cbMetrics;   /*  Size in bytes of the font metrics buffer. */
PFONTMETRICS    pfmMetrics;  /*  Pointer. */
PVOID           pInstance;   /*  Pointer to instance data. */
ULONG           lFunction;   /*  High-order WORD=flags; low-order WORD=NGreQueryFontAttributes. */
BOOL            fSuccess;    /*  Return codes. */

fSuccess = GreQueryFontAttributes(hdc, cbMetrics,
             pfmMetrics, pInstance, lFunction);