次の方法で共有


AddFontResourceExA 関数 (wingdi.h)

AddFontResourceEx 関数は、指定したファイルからシステムにフォント リソースを追加します。 AddFontResourceEx 関数で追加されたフォントは、プライベートとしてマークでき、列挙可能としてマークすることはできません。

構文

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

パラメーター

[in] name

有効なフォント ファイル名を含む null で終わる文字列へのポインター。 このパラメーターでは、次のいずれかのファイルを指定できます。

ファイル拡張子 意味
.fon
フォント リソース ファイル。
.fnt
生ビットマップ フォント ファイル。
.ttf
Raw TrueType ファイル。
.ttc を する
東アジアの Windows: TrueType フォント コレクション。
.fot を する
TrueType リソース ファイル。
.otf
PostScript OpenType フォント。
.mmm を する
複数のマスター Type1 フォント リソース ファイル。 .pfm ファイルと .pfb ファイルと共に使用する必要があります。
.pfb を する
1 フォント ビット ファイルを入力します。 これは .pfm ファイルと共に使用されます。
.pfm を する
1 フォント メトリック ファイルを入力します。 これは .pfb ファイルと共に使用されます。
 

複数のリソース ファイルから情報を取得するフォントを追加するには、lpszFileName ファイル名が | で区切られた文字列をポイントします。--たとえば、abcxxxxx.pfm |abcxxxxx.pfb。

[in] fl

システムに追加するフォントの特性。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
FR_PRIVATE
AddFontResourceEx 関数を呼び出したプロセスのみがこのフォントを使用できることを指定します。 フォント名がパブリック フォントと一致する場合は、プライベート フォントが選択されます。 プロセスが終了すると、AddFontResourceEx 関数を使用して、プロセスによってインストールされたすべてのフォントが削除されます。
FR_NOT_ENUM
AddFontResourceEx 関数を呼び出したプロセスを含め、このフォントを列挙できないプロセスを指定します。

[in] res

引っ込み思案。 0 にする必要があります。

戻り値

関数が成功した場合、戻り値は追加されたフォントの数を指定します。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報は使用できません。

備考

この関数を使用すると、他のプロセスがフォントにアクセスすることを許可せずに、プロセスでフォントを使用できます。

アプリケーションで、AddFontResourceEx 関数を呼び出して読み込んだフォント リソースが不要になった場合は、RemoveFontResourceEx 関数を呼び出してリソースを削除する必要があります。

この関数は、現在のセッションに対してのみフォントをインストールします。 システムが再起動すると、フォントは表示されません。 システムを再起動した後でもフォントをインストールするには、フォントをレジストリに一覧表示する必要があります。

レジストリに一覧表示され、%windir%\fonts\ フォルダー以外の場所にインストールされているフォントは、セッションに読み込まれている限り、変更、削除、または置換できません。 これらのフォントのいずれかを変更するには、まず RemoveFontResource呼び出して削除し、フォント レジストリ (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) から削除し、システムを再起動する必要があります。 システムを再起動すると、フォントは読み込まれなくなり、変更できます。

手記

wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして AddFontResourceEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h (Windows.h を含む)
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目

フォント関数とテキスト関数

フォントとテキストの概要

RemoveFontResourceEx の

SendMessage を する