PfWideTextWidthChars()

Calculate the width of a wchar_t string of Unicode characters

Synopsis:

int PfWideTextWidthChars( const char *font,
                          const wchar_t *str,
                          int len );

Library:

ph

Description:

PfWideTextWidthChars() is a convenience function that calculates the width of the given string in the given font, using the formula:

extent.lr.x - min(extent.ul.x, 0) + 1

The font argument is the name of the desired font. You should use PfGenerateFontName() to create this.

The str argument is a char string of Unicode characters. The len argument gives the number of characters in the string. If len is 0, strlen(str) is assumed.

This function assumes each character is represented by 2 bytes that conform to the ISO/IEC 10646-1 UCS-2 double-byte format.

PfWideTextWidthBytes() is similar, but you pass it the number of bytes in the string, rather than the number of characters.

Returns:

The width of the string, or 0 if an error occurred.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No