TTEmbedFontEx 関数 (t2embapi.h)

  • [アーティクル]

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

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

TTEmbedFontEx は TTEmbedFont と同じ方法で使用されますが、UCS-4 (32 ビット) で指定された文字コード セットを受け入れます。

構文

LONG TTEmbedFontEx(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           ULONG          *pulCharCodeSet,
  [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] pulCharCodeSet

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

[in] usCharCodeCount

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

[in] usLanguage

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

[in, optional] pTTEmbedInfo

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

戻り値

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

フォント構造は、クライアントによってドキュメント ストリームに組み込まれます。

pulPrivStatus が設定され、フォントの埋め込み特権が示されます。と pulStatus は、埋め込み操作の結果を提供するように設定されています。

それ以外の場合は、「 埋め込み関数のエラー メッセージ」で説明されているエラー コードを返します。

注釈

この関数は、フォント構造をドキュメント ストリームに埋め込むクライアント定義のコールバック ルーチンを参照します。

クライアントは、フォントの文字セットを決定して示す責任があります。

Unicode 文字の埋め込みの詳細については、「 TTEmbedFont」を参照してください。ファイルから Unicode 文字を埋め込む方法については、「 TTEmbedFontFromFileA」を参照してください。

要件

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

こちらもご覧ください

TTEMBEDINFO

TTEmbedFont

TTEmbedFontFromFileA

TTLoadEmbeddedFont