OkfGetHandle

Get the handle of a registered font given the pointer of its OKFFONT structure.

int OkfGetHandle( OKFFONT *pFont );

Routine Required Header
OkfGetHandle "okf.h"
 

Libraries

OKLIB.A Oankali's GP32 run-time library
 

Return Value

In case of success OkfGetHandle returns the handle of the OKF Font.

If pFont doesn't point to a valid registered OKF Font structure, the function returns 0.

In case of error it returns -1. Look at okf.lastError for details on what happened.


Parameters

pFont

A pointer to a valid registered OKF Font.


Remarks

The OkfGetHandle function is an uncommon function used to retrieve the handle of a registered font given the address of its OKFFONT structure.

This function can be time consuming, so if it has to be included in a loop, it's preferable to stock the returned handle in a temporal variable, than use this variable instead.


See Also

OKF Font Engine Routines, OKF Font Engine Structures, OKF Font Engine Constants, OkfGetFont, OKFFONT