get_text_face


int get_text_face(handle device,
                  int size=0,
                  character* buffer=0)

This function obtains the type face name of the currently selected font.

Parameters

handle device

The handle of the device context.

int size

The length of the buffer specified by the next parameter.

character* buffer

A pointer to a buffer to hold the type face name. If null is specified, the required buffer size is returned.

Return

int

Zero The call failed.
Other The number of characters copied to the buffer or the required buffer size. The required buffer size (in characters) is inclusive of the null-terminator.

Notes

The type face name is copied as a string.

If the string does not fit the specified buffer, it is truncated.