Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function adds the font resource from the specified file to the operating system's font table. The font can subsequently be used for text output by any application on the device.

Syntax 

int AddFontResource(
  LPCTSTR 
lpszFilename
);

Parameters

lpszFilename

[in] Long pointer to a null-terminated string that contains a valid font file name. The file name can specify a raw TrueType file (.ttf), a TrueType resource file (.fot), a TrueType collection file (.ttc), a raw bitmap font file (.fnt), or a raster resource file (.fon).

Return Value

The number of fonts added indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

Any application that adds or removes fonts from the system font table should notify other applications of the change by sending a WM_FONTCHANGEmessage to all top-level windows in the operating system (OS). The application should send this message by calling the SendMessagefunction and setting the hwndparameter to HWND_BROADCAST.

When an application no longer needs a font resource that the application loaded by calling the AddFontResourcefunction, the application must remove the resource by calling the RemoveFontResourcefunction.

Windows CE 2.0 and later support systems that use either TrueType or raster fonts, but not both. The OEM chooses the font type at system design time, and applications cannot change the font type.

AddFontResource can add raster fonts if the GDI raster font component is built into the system, or TrueType fonts if the GDI TrueType font component is built into the system.

Note that AddFontResourcewill not work for raster fonts if the GDI TrueType font component is added to the system by the OEM, and will not work for TrueType fonts if the GDI raster font component is added to the system by the OEM.

Windows CE 1.0 and 1.01 support only raster fonts.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also