###User Defined Function###
_WinAPI_CreateFontEx

###Description###
Creates a logical font with the specified characteristics.

###Syntax###
#include <WinAPIGdi.au3>
_WinAPI_CreateFontEx ( $iHeight [, $iWidth = 0 [, $iEscapement = 0 [, $iOrientation = 0 [, $iWeight = 400 [, $fItalic = 0 [, $fUnderline = 0 [, $fStrikeOut = 0 [, $iCharSet = 1 [, $iOutPrecision = 0 [, $iClipPrecision = 0 [, $iQuality = 0 [, $iPitchAndFamily = 0 [, $sFaceName = '' [, $iStyle = 0]]]]]]]]]]]]]] )


###Parameters###
@@ParamTable@@
$iHeight
	The height of the font's character cell or character, in logical units.
$iWidth
	[optional] The average width, in logical units. Default is 0.
$iEscapement
	[optional] The angle, in tenths of degrees, between the escapement vector and the x-axis of the device. Default is 0
$iOrientation
	[optional] The angle, in tenths of degrees, between each character's base line and the x-axis of the device. Default is 0
$iWeight
	[optional] The weight of the font in the range 0 through 1000, or one of the following values.
		$FW_DONTCARE
		$FW_THIN
		$FW_EXTRALIGHT
		$FW_ULTRALIGHT
		$FW_LIGHT
		$FW_NORMAL (Default)
		$FW_REGULAR
		$FW_MEDIUM
		$FW_SEMIBOLD
		$FW_DEMIBOLD
		$FW_BOLD
		$FW_EXTRABOLD
		$FW_ULTRABOLD
		$FW_HEAVY
		$FW_BLACK
$fItalic
	[optional] Specifies whether to set italic font attribute, valid values:
		True  - The attribute is set.
		False - The attribute is not set (Default).
$fUnderline
	[optional] Specifies whether to set underlined font attribute, valid values:
		True  - The attribute is set.
		False - The attribute is not set (Default).
$fStrikeOut
	[optional] Specifies whether to set strikeout font attribute, valid values:
		True  - The attribute is set.
		False - The attribute is not set (Default).
$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
$iOutPrecision
	[optional] The output precision. It can be one of the following values.
		$OUT_CHARACTER_PRECIS
		$OUT_DEFAULT_PRECIS (Default)
		$OUT_DEVICE_PRECIS
		$OUT_OUTLINE_PRECIS
		$OUT_PS_ONLY_PRECIS
		$OUT_RASTER_PRECIS
		$OUT_STRING_PRECIS
		$OUT_STROKE_PRECIS
		$OUT_TT_ONLY_PRECIS
		$OUT_TT_PRECIS
$iClipPrecision
	[optional] The clipping precision. It can be one or more of the following values.
		$CLIP_CHARACTER_PRECIS
		$CLIP_DEFAULT_PRECIS (Default)
		$CLIP_DFA_DISABLE
		$CLIP_EMBEDDED
		$CLIP_LH_ANGLES
		$CLIP_DFA_OVERRIDE
		$CLIP_STROKE_PRECIS
$iQuality
	[optional] The output quality. It can be one of the following values.
		$ANTIALIASED_QUALITY
		$CLEARTYPE_QUALITY
		$DEFAULT_QUALITY (Default)
		$DRAFT_QUALITY
		$NONANTIALIASED_QUALITY
		$PROOF_QUALITY
$iPitchAndFamily
	[optional] The pitch and family of the font. The two low-order bits specify the pitch of the font and can be one of the following values.
		$DEFAULT_PITCH (Default
		$FIXED_PITCH
		$VARIABLE_PITCH
	The four high-order bits specify the font family and can be one of the following values.
		$FF_DECORATIVE
		$FF_DONTCARE
		$FF_MODERN
		$FF_ROMAN
		$FF_SCRIPT
		$FF_SWISS
$sFaceName
	[optional] 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
@@End@@

###ReturnValue###
@@ReturnTable@@
Success 	A handle to a logical font.
Failure 	0.
@@End@@


###Remarks###
If you request a font name that is not available on the system, the font mapper will substitute a font that has similar attributes but a different name.

When you no longer need the font, call the <a href="_WinAPI_DeleteObject.htm">_WinAPI_DeleteObject()</a> function to delete it.


###Related###
_WinAPI_DeleteObject


###See Also###
@@MsdnLink@@ CreateFont
