AddFontResourceA 関数 (wingdi.h)
AddFontResource 関数は、指定したファイルからシステム フォント テーブルにフォント リソースを追加します。 フォントは、その後、任意のアプリケーションでテキスト出力に使用できます。
フォントをプライベートまたは列挙可能としてマークするには、AddFontResourceEx 関数を使用します。
構文
int AddFontResourceA(
[in] LPCSTR unnamedParam1
);
パラメーター
[in] unnamedParam1
有効なフォント ファイル名を含む null で終わる文字列へのポインター。 このパラメーターでは、次のいずれかのファイルを指定できます。
複数のリソース ファイルから情報を取得するフォントを追加するには、lpszFileName
戻り値
関数が成功した場合、戻り値は追加されたフォントの数を指定します。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報は使用できません。
備考
システム フォント テーブルにフォントを追加または削除するアプリケーションは、オペレーティング システムのすべての最上位ウィンドウに WM_FONTCHANGE メッセージを送信して、変更を他のウィンドウに通知する必要があります。 アプリケーションは、SendMessage 関数を呼び出し、hwnd パラメーターをHWND_BROADCASTに設定することで、このメッセージを送信する必要があります。
アプリケーションで、AddFontResource 関数を呼び出して読み込んだフォント リソースが不要になった場合は、RemoveFontResource 関数を呼び出して、そのリソースを削除する必要があります。
この関数は、現在のセッションに対してのみフォントをインストールします。 システムが再起動すると、フォントは表示されません。 システムを再起動した後でもフォントをインストールするには、フォントをレジストリに一覧表示する必要があります。
レジストリに一覧表示され、%windir%\fonts\ フォルダー以外の場所にインストールされているフォントは、セッションに読み込まれている限り、変更、削除、または置換できません。 これらのフォントのいずれかを変更するには、まず RemoveFontResource
手記
wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして AddFontResource を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wingdi.h (Windows.h を含む) |
| ライブラリ | Gdi32.lib |
| DLL | Gdi32.dll |
関連項目
AddFontResourceEx の
RemoveFontResource の
SendMessage を