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);