Home Library Learn Downloads Support Community
Sign in | United States - English | |
2 out of 2 rated this helpful Rate this topic

AddFontResource function

The AddFontResource function adds the font resource from the specified file to the system font table. The font can subsequently be used for text output by any application.

To mark a font as private or not enumerable, use the AddFontResourceEx function.

Syntax

Copy 
int AddFontResource(
  __in  LPCTSTR lpszFilename
);

Parameters

lpszFilename [in]

A pointer to a null-terminated character string that contains a valid font file name. This parameter can specify any of the following files.

File ExtensionMeaning
.fon

Font resource file.

.fnt

Raw bitmap font file.

.ttf

Raw TrueType file.

.ttc

East Asian Windows: TrueType font collection.

.fot

TrueType resource file.

.otf

PostScript OpenType font.

.mmm

Multiple master Type1 font resource file. It must be used with .pfm and .pfb files.

.pfb

Type 1 font bits file. It is used with a .pfm file.

.pfm

Type 1 font metrics file. It is used with a .pfb file.

 

To add a font whose information comes from several resource files, have lpszFileName point to a string with the file names separated by a "|" --for example, abcxxxxx.pfm | abcxxxxx.pfb.

Return value

If the function succeeds, the return value specifies the number of fonts added.

If the function fails, the return value is zero. No extended error information is available.

Remarks

Any application that adds or removes fonts from the system font table should notify other windows of the change by sending a WM_FONTCHANGE message to all top-level windows in the operating system. The application should send this message by calling the SendMessage function and setting the hwnd parameter to HWND_BROADCAST.

When an application no longer needs a font resource that it loaded by calling the AddFontResource function, it must remove that resource by calling the RemoveFontResource function.

This function installs the font only for the current session. When the system restarts, the font will not be present. To have the font installed even after restarting the system, the font must be listed in the registry.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header
Wingdi.h (include Windows.h)

Library
Gdi32.lib

DLL
Gdi32.dll

Unicode and ANSI names

AddFontResourceW (Unicode) and AddFontResourceA (ANSI)

See also

Fonts and Text Overview
Font and Text Functions
AddFontResourceEx
RemoveFontResource
SendMessage

 

 

Send comments about this topic to Microsoft

Build date: 9/7/2011

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Community Responses
While the question might be best served to be answered in those forums, the answer itself, once found, should be included here as well.
History
registry path

which path in registry to set the name of the font file for it to persist in the system even after restart ?

[tfl - 14 11 09] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio  : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell     : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&
History