TTGetEmbeddedFontInfo 関数 (t2embapi.h)

  • [アーティクル]

埋め込みアクセス許可など、埋め込みフォントに関する情報を取得します。 TTGetEmbeddedFontInfo は TTLoadEmbeddedFont と同じタスクを実行しますが、埋め込みフォントに内部データ構造を割り当てません。

構文

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

パラメーター

[in] ulFlags

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

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

[out] pulPrivStatus

完了時に、 はフォントの埋め込み特権を示します。 使用可能な値の一覧は次のとおりです。

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

[in] ulPrivs

クライアントによって課される埋め込み特権のさらに制限を示すフラグ。 詳細については、「 TTLoadEmbeddedFont」 を参照してください。

このフラグには、次のいずれかの値が必要です。

値 意味
LICENSE_PREVIEWPRINT
 プレビューと印刷の埋め込み。
LICENSE_EDITABLE
 編集可能な埋め込み。
LICENSE_INSTALLABLE
 インストール可能な埋め込み。
LICENSE_NOEMBEDDING
 制限付きライセンスの埋め込み。
LICENSE_DEFAULT
 既定の埋め込みレベルを使用します。

[out] pulStatus

状態情報を含むビットフィールドへのポインター。この関数の完了時に入力されます。 状態は、0 または次の値にすることができます。

値 意味
TTLOAD_FONT_SUBSETTED
 読み込まれたフォントは、元のフォントのサブセットです。

lpfnReadFromStream

[callback]ドキュメント ストリームからフォント構造を読み取るクライアント定義コールバック関数へのポインター。

[in] lpvReadStream

現在未定義です。 ストリームへのポインター (フォント構造) 用に予約されています。

[in] pTTLoadInfo

埋め込みフォント オブジェクトが取得された URL を含む TTLOADINFO 構造体へのポインター。

戻り値

成功した場合は、E_NONEを返します。

*pulPrivStatus によって参照される場所は、フォントの埋め込み特権を識別します。 *pulStatus によって参照される場所は、フォントのサブセットが埋め込まれているかどうかを識別します。

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

要件

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

こちらもご覧ください

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO

TTLoadEmbeddedFont