ExtCreateFontIndirect

  HFONT ExtCreateFontIndirect(pExtLogFont)    
  LPEXTLOGFONT pExtLogFont;    

The ExtCreateFontIndirect function creates a logical font. This function is an extension of CreateFont and CreateFontIndirect. More information can be specified in this call.

A font handle is returned to the caller. This font handle is indistinguishable from handles returned by CreateFont or CreateFontIndirect.

Parameters

pExtLogFont

Points to an EXTLOGFONT structure that defines the characteristics of the logical font. The EXTLOGFONT structure has the following form:

typedef struct tagEXTLOGFONT {

LOGFONT elfLogFont;

BYTE elfFullName[LF_FULLFACESIZE];

BYTE elfStyle[LF_FACESIZE];

DWORD elfVersion;

DWORD elfCulture;

PANOSE elfPanose;

BYTE elfVendorId[ELF_VENDOR_SIZE];

DWORD iMatch;

} EXTLOGFONT;

Return Value

If the function is successful it returns a valid handle to a logical font, otherwise NULL is returned.

Comments

The ExtCreateFontIndirect function creates a logical font that has all the specified characteristics. When the font is selected by using the SelectObject function, GDI's font mapper attempts to match the logical font with an existing physical font. If it fails to find an exact match, it provides an alternate whose characteristics match as many of the requested characteristics as possible.

See Also

EXTLOGFONT HFONT LOGFONT CreateFont CreateFontIndirect SelectObject