GpiQueryFontAction

This function determines whether available fonts have been affected since the last time the function was called.

Syntax

GpiQueryFontAction(anchor, options)

Parameters

anchor (HAB) - input

Anchor-block handle.

options (ULONG) - input

Options.

The following may be OR'ed together if required:

QFA_PUBLIC

Interested in any change of public fonts.

QFA_PRIVATE

Interested in any change of private fonts for the current process.

Return Value

flActions (ULONG) - returns

Actions indicator.

If no error occurs, QFA_PUBLIC and QFA_PRIVATE may be OR'ed together.

QFA_PUBLIC

A change of public fonts has occurred.

QFA_PRIVATE

A change of private fonts affecting the current process has occurred.

QFA_ERROR

Error occurred.

Remarks

This function can be used by a font selection dialog to find out whether its database of font information is still valid. The function returns that both public and private font changes have taken place the first time it is called on a given process.

Errors

Possible returns from WinGetLastError:

PMERR_INV_OR_INCOMPAT_OPTIONS (0x20A9)

An invalid or incompatible (with micro presentation space) options parameter was specified with GpiCreatePS or GpiSetPS.

Example Code

#define INCL_GPILCIDS /* Or use INCL_GPI, INCL_PM, */
#include <os2.h>

HAB   anchor;    /* Anchor-block handle. */
ULONG options;   /* Options. */
ULONG flActions; /* Actions indicator. */

flActions = GpiQueryFontAction(anchor, options);