CreateScalableFontResourceA 関数 (wingdi.h)
[ CreateScalableFontResource 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、次の場合があります。
以降のバージョンでは変更または使用できません。]
CreateScalableFontResource 関数は、スケーラブルなフォントのフォント リソース ファイルを作成します。
構文
BOOL CreateScalableFontResourceA(
[in] DWORD fdwHidden,
[in] LPCSTR lpszFont,
[in] LPCSTR lpszFile,
[in] LPCSTR lpszPath
);
パラメーター
[in] fdwHidden
フォントが読み取り専用フォントかどうかを指定します。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
フォントには読み取り/書き込みアクセス許可があります。 |
|
フォントには読み取り専用のアクセス許可があり、システム内の他のアプリケーションから非表示にする必要があります。 このフラグが設定されている場合、フォントは EnumFonts または EnumFontFamilies 関数によって列挙されません。 |
[in] lpszFont
作成するフォント リソース ファイルの名前を指定する null で終わる文字列へのポインター。 このパラメーターで既存のフォント リソース ファイルを指定すると、関数は失敗します。
[in] lpszFile
この関数がフォント リソース ファイルの作成に使用するスケーラブルなフォント ファイルの名前を指定する、null で終わる文字列へのポインター。
[in] lpszPath
スケーラブルなフォント ファイルへのパスを指定する null で終わる文字列へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
lpszFontRes で既存のフォント ファイルが指定されている場合、GetLastError はERROR_FILE_EXISTSを返します。
解説
CreateScalableFontResource 関数は、TrueType フォントをインストールするアプリケーションで使用されます。 アプリケーションでは 、CreateScalableFontResource 関数を使用してフォント リソース ファイル (通常は .fot ファイル名拡張子) を作成し、 AddFontResource 関数を使用してフォントをインストールします。 TrueType フォント ファイル (通常は .ttf ファイル名拡張子を持つ) は、 AddFontResource 関数で使用される Windows ディレクトリの System サブディレクトリに存在する必要があります。
CreateScalableFontResource 関数は現在、TrueType テクノロジのスケーラブルなフォントのみをサポートしています。
lpszFontFile パラメーターでファイル名と拡張子のみを指定する場合、lpszCurrentPath パラメーターはパスを指定する必要があります。 lpszFontFile パラメーターで完全なパスを指定する場合、lpszCurrentPath パラメーターは NULL または NULL へのポインターである必要があります。
lpszFontFile パラメーターでファイル名と拡張子のみを指定し、lpszCurrentPath パラメーターにパスを指定すると、lpszFontFile 内の文字列は、このリソースに属する .ttf ファイルとして .fot ファイルにコピーされます。 AddFontResource 関数が呼び出されると、オペレーティング システムは 、.ttf ファイルがシステム ディレクトリ (ネットワーク インストールの場合は windows ディレクトリメイン) にコピーされていることを前提としています。 createScalableFontResource 関数を呼び出すときに、lpszCurrentPath パラメーターにディレクトリ情報が含まれているため、.ttf ファイルはこのディレクトリ内に存在する必要はありません。 この方法で作成されたリソースには絶対パス情報が含まれていないので、任意のインストールで使用できます。
lpszFontFile パラメーターにパスを指定し、lpszCurrentPath パラメーターに NULL を指定すると、lpszFontFile 内の文字列が .fot ファイルにコピーされます。 この場合、AddFontResource 関数が呼び出されると、CreateScalableFontResource 関数が呼び出されたときに、lpszFontFile パラメーターで指定された場所に .ttf ファイルが存在する必要があります。lpszCurrentPath パラメーターは必要ありません。 この方法で作成されたリソースには、パスとドライブへの絶対参照が含まれており、.ttf ファイルが別の場所に移動された場合は機能しません。
Note
wingdi.h ヘッダーは、CreateScalableFontResource をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示