# Function Reference

# _WinAPI_GetFontName

Retrieves the unique name of the font based on its typeface name, character set, and style

#include <WinAPIGdi.au3>
_WinAPI_GetFontName ( $sFaceName [, $iStyle = $FS_REGULAR [, $iCharSet = $DEFAULT_CHARSET]] )

## Parameters

$sFaceName | The typeface name of the font (not including style). For example, "Arial", "Tahoma", etc.
$iStyle | [optional] The style of the font. It can be one or more of the following values: $FS_REGULAR Default) $FS_BOLD $FS_ITALIC
$iCharSet | [optional] The character set. It can be one of the following values: $ANSI_CHARSET $BALTIC_CHARSET $CHINESEBIG5_CHARSET $DEFAULT_CHARSET (Default) $EASTEUROPE_CHARSET $GB2312_CHARSET $GREEK_CHARSET $HANGEUL_CHARSET $MAC_CHARSET $OEM_CHARSET $RUSSIAN_CHARSET $SHIFTJIS_CHARSET $SYMBOL_CHARSET $TURKISH_CHARSET $VIETNAMESE_CHARSET Korean language edition of Windows: $JOHAB_CHARSET Middle East language edition of Windows: $ARABIC_CHARSET $HEBREW_CHARSET Thai language edition of Windows: $THAI_CHARSET

## Return Value

Success: | The unique name of the font.
Failure: | Empty string and sets the @error flag to non-zero.

## Remarks

This function can be used to get the appropriate font name on different language versions of the OS.
For example, in the english version you can write "Arial Bold", however, for the russian version this font must be specified as "Arial Ïîëóæèðíûé".
Nevertheless, most fonts use only english names and must be specified explicitly.

## Example

    #include <FontConstants.au3>
    #include <WinAPIGdi.au3>

    Local Const $sFaceName = 'Arial'

    ConsoleWrite($sFaceName & ' Regular => ' & _WinAPI_GetFontName($sFaceName, $FS_REGULAR) & @CRLF)
    ConsoleWrite($sFaceName & ' Bold => ' & _WinAPI_GetFontName($sFaceName, $FS_BOLD) & @CRLF)
    ConsoleWrite($sFaceName & ' Italic => ' & _WinAPI_GetFontName($sFaceName, $FS_ITALIC) & @CRLF)
    ConsoleWrite($sFaceName & ' Bold Italic => ' & _WinAPI_GetFontName($sFaceName, BitOR($FS_BOLD, $FS_ITALIC)) & @CRLF)