TTEmbedFont 関数 (t2embapi.h)

  • [アーティクル]

サブセット化されたワイド文字 (16 ビット) フォントを含むフォント構造を作成します。 デバイス コンテキスト (hDC) の現在のフォントは、フォント情報を提供します。

この関数は、ドキュメント ストリームに挿入するために、クライアント定義のコールバック ルーチンにデータを渡します。

構文

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

パラメーター

[in] hDC

デバイス コンテキスト ハンドル。

[in] ulFlags

埋め込み要求を指定するフラグ。 このフラグには、次の値を 0 個以上指定できます。

値 意味
TTEMBED_EMBEDEUDC
 関連付けられている EUDC フォント ファイル データをフォント構造に含めます。
TTEMBED_RAW
 圧縮されていない完全な文字セットを含むフォント構造を返します。 これは、関数の既定の動作です。
TTEMBED_SUBSET
 pusCharCodeSet パラメーターまたは pulCharCodeSet パラメーターによって示されるグリフのみを含むサブセット化されたフォントを返します。 これらの文字コードは、パラメーターに応じて、16 ビットまたは UCS-4 文字として示す必要があります。
TTEMBED_TTCOMPRESSED
 圧縮フォント構造を返します。

[in] ulCharSet

埋め込むフォントの文字セットを指定するフラグ。 このフラグには、次のいずれかの値を指定できます。

値 意味
CHARSET_UNICODE
 Unicode 文字セット。16 ビット文字エンコードが必要です。
CHARSET_SYMBOL
 シンボル文字セット。16 ビット文字エンコードが必要です。

[out] pulPrivStatus

フォントの埋め込み権限を示すフラグへのポインター。 このフラグには、次のいずれかの値を指定できます。 この関数は、付与された最も制限の厳しいライセンスを返します。

値 意味
EMBED_PREVIEWPRINT
 プレビューと印刷の埋め込み。
EMBED_EDITABLE
 編集可能な埋め込み。
EMBED_INSTALLABLE
 インストール可能な埋め込み。
EMBED_NOEMBEDDING
 制限付きライセンスの埋め込み。

[out] pulStatus

埋め込み要求に関する状態情報を含むビットフィールドへのポインター。 このフィールドは、この関数の完了時に入力されます。 現在、このパラメーターに対してビットは定義されていません。

lpfnWriteToStream

ドキュメント ストリームにフォント構造を書き込む、クライアント定義のコールバック関数へのポインター。 WRITEEMBEDPROC を参照してください。

[in] lpvWriteStream

出力ストリームを表すトークン。

[in] pusCharCodeSet

サブセット化のためのオプションの Unicode 文字コードを含むバッファーへのポインター。 このフィールドはフォントのサブセット化にのみ使用され、 ulFlags フィールドでTTEMBED_SUBSETを指定しない場合は無視されます。

[in] usCharCodeCount

pusCharCodeSet で示される文字の一覧内の文字数。 このフィールドはフォントのサブセット化にのみ使用され、 ulFlags フィールドでTTEMBED_SUBSETを指定しない場合は無視されます。

[in] usLanguage

サブセット化時に保持する名前テーブル内の言語を指定します。 すべての言語を保持するには、0 に設定します。 このフィールドはフォントのサブセット化にのみ使用され、 ulFlags フィールドでTTEMBED_SUBSETを指定しない場合は無視されます。

[in, optional] pTTEmbedInfo

埋め込みフォント オブジェクトが正当に参照される URL を含む TTEMBEDINFO 構造体へのポインター。 pTTEmbedInfo が NULL の場合、埋め込みフォント オブジェクトに URL は追加されません。また、クライアントが TTLoadEmbeddedFont を呼び出しても URL チェックは行われません。

戻り値

埋め込みに成功した場合は、E_NONEを返します。

フォント構造は、クライアントによってドキュメント ストリームに組み込まれます。 pulPrivStatus が設定され、フォントの埋め込み特権が示されます。と pulStatus が設定され、埋め込み操作の結果が提供されます。

それ以外の場合は、「 Embedding-Function Error Messages」で説明されているエラー コードを返します。

注釈

クライアントは、フォントの文字セットを決定して示す役割を担います。

UCS-4 文字の埋め込みの詳細については、「 TTEmbedFontEx」を参照してください。 ファイルからのフォント文字の埋め込みの詳細については、「 TTEmbedFontFromFileA」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー t2embapi.h
Library T2embed.lib
[DLL] T2embed.dll

こちらもご覧ください

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont