Jump to content

GpiQueryNumberSetIds

From EDM2
Revision as of 21:31, 6 April 2025 by Iturbide (talk | contribs) (Created page with "This function returns the number of local identifiers (lcids) currently in use, referring to fonts or bit maps. ==Syntax== GpiQueryNumberSetIds(hps) ==Parameters== ; hps (HPS) - input : Presentation-space handle. ==Return Value== ; lCount (LONG) - returns : Number of lcids. :; >=0 :: Number of lcids in use :; GPI_ALTERROR :: Error. ==Remarks== LCID_DEFAULT is included if the default font has been changed (see GpiCreateLogFont). The information returned b...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This function returns the number of local identifiers (lcids) currently in use, referring to fonts or bit maps.

Syntax

GpiQueryNumberSetIds(hps)

Parameters

hps (HPS) - input
Presentation-space handle.

Return Value

lCount (LONG) - returns
Number of lcids.
>=0
Number of lcids in use
GPI_ALTERROR
Error.

Remarks

LCID_DEFAULT is included if the default font has been changed (see GpiCreateLogFont). The information returned by this call can be used to perform a subsequent GpiQuerySetIds request.

Errors

Possible returns from WinGetLastError:

PMERR_INV_HPS (0x207F)
An invalid presentation-space handle was specified.
PMERR_PS_BUSY (0x20F4)
An attempt was made to access the presentation space from more than one thread simultaneously.

Example Code

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

HPS     hps;    /* Presentation-space handle. */
LONG    lCount; /* Number of lcids. */

lCount = GpiQueryNumberSetIds(hps);

This example uses GpiQueryNumberSetIds to return the number of local identifiers in use (font and bit map).

#define INCL_GPILCIDS /* Font functions */
#include <os2.h>

LONG lCount; /* number of lcid's */
HPS hps; /* Presentation-space handle */

lCount = GpiQueryNumberSetIds(hps);