GreQueryFontAttributes

From EDM2
Revision as of 03:42, 16 January 2020 by Martini (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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