次の方法で共有

CreateScalableFontResourceA 関数 (wingdi.h)

  • [アーティクル]

[CreateScalableFontResource 関数は、[要件] セクションで指定したオペレーティング システムで使用できます。 次の場合があります。

以降のバージョンでは変更または使用できません。]

CreateScalableFontResource 関数は、スケーラブルなフォントのフォント リソース ファイルを作成します。

構文

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

パラメーター

[in] fdwHidden

フォントが読み取り専用フォントかどうかを指定します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
0
 フォントには読み取り/書き込みアクセス許可があります。
1
 フォントには読み取り専用のアクセス許可があり、システム内の他のアプリケーションから非表示にする必要があります。 このフラグが設定されている場合、フォントは EnumFonts または enumFontFamilies 関数 列挙されません。

[in] lpszFont

作成するフォント リソース ファイルの名前を指定する null で終わる文字列へのポインター。 このパラメーターで既存のフォント リソース ファイルを指定すると、関数は失敗します。

[in] lpszFile

この関数がフォント リソース ファイルの作成に使用するスケーラブルなフォント ファイルの名前を指定する null で終わる文字列へのポインター。

[in] lpszPath

スケーラブルなフォント ファイルへのパスを指定する null で終わる文字列へのポインター。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。

lpszFontRes 既存のフォント ファイルを指定した場合、GetLastError はERROR_FILE_EXISTS

備考

CreateScalableFontResource 関数は、TrueType フォントをインストールするアプリケーションで使用されます。 アプリケーションは、CreateScalableFontResource 関数を使用してフォント リソース ファイル (通常は .fot ファイル名拡張子を持つ) を作成し、AddFontResource 関数を使用してフォントをインストールします。 AddFontResource 関数で使用するには、TrueType フォント ファイル (通常は.ttfファイル名拡張子を持つ) が Windows ディレクトリの System サブディレクトリに存在する必要があります。

CreateScalableFontResource 関数は現在、TrueType テクノロジのスケーラブルなフォントのみをサポートしています。

lpszFontFile パラメーターでファイル名と拡張子のみを指定する場合は、lpszCurrentPath パラメーター パスを指定する必要があります。 lpszFontFile パラメーターで完全なパスを指定する場合、lpszCurrentPath パラメーターは NULL または nullへのポインター する必要があります。

lpszFontFile パラメーターでファイル名と拡張子のみを指定し、lpszCurrentPath パラメーターにパスを指定すると、lpszFontFile 内の文字列は、このリソースに属する.ttf ファイルとして .fot ファイルにコピーされます。 AddFontResource 関数が呼び出されると、オペレーティング システムは、.ttf ファイルがシステム ディレクトリ (またはネットワーク インストールの場合はメイン Windows ディレクトリ) にコピーされていることを前提としています。 lpszCurrentPath パラメーターにディレクトリ情報が含まれているため、CreateScalableFontResource 関数を呼び出すときは、.ttf ファイルをこのディレクトリに含める必要はありません。 この方法で作成されたリソースには絶対パス情報が含まれていないので、どのインストールでも使用できます。

lpszFontFile パラメーターにパスを指定し、lpszCurrentPath パラメーターに NULL 指定すると、lpszFontFile の文字列が .fot ファイルにコピーされます。 この場合、AddFontResource 関数が呼び出されると、.ttf ファイルは、CreateScalableFontResource 関数が呼び出されたときに、lpszFontFile パラメーターで指定された場所にある必要があります。lpszCurrentPath パラメーターは必要ありません。 この方法で作成されたリソースには、パスとドライブへの絶対参照が含まれており、.ttf ファイルが別の場所に移動された場合は機能しません。

手記

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

必要条件

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

関連項目

AddFontResource の

EnumFontFamilies の

EnumFonts の

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

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