ホーム › Graphics.DirectWrite › IDWriteFactory7

IDWriteFactory7

COM

📘 Microsoft Learn (日本語) · English

IID35d0e0b3-9076-4d2e-a016-a91b568a06b4継承元IDWriteFactory6自前メソッド開始 vtbl55

公式ドキュメント

このインターフェイスは、すべての DirectWrite オブジェクトを作成する元となるファクトリオブジェクトを表します。IDWriteFactory7 は、システムフォントを扱うための新しい機能を追加します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 55 HRESULT GetSystemFontSet(BOOL includeDownloadableFonts, IDWriteFontSet2** fontSet)

システムフォントのセットを取得します。(IDWriteFactory7::GetSystemFontSet)

includeDownloadableFonts	BOOL	in	ダウンロード可能なフォントを含める場合は `true`。ローカルにインストールされたフォントのみを対象とする場合は `false`。
fontSet	IDWriteFontSet2**	out	IDWriteFontSet2 インターフェイスへのポインターのアドレス。正常に完了すると、この関数はポインターをフォントセットオブジェクトに設定します。それ以外の場合は、ポインターを `nullptr` に設定します。

戻り値

Type: HRESULT

関数が成功した場合は S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 56 HRESULT GetSystemFontCollection(BOOL includeDownloadableFonts, DWRITE_FONT_FAMILY_MODEL fontFamilyModel, IDWriteFontCollection3** fontCollection)

ファミリーごとにグループ化されたフォントのコレクションを取得します。(IDWriteFactory7::GetSystemFontCollection)

includeDownloadableFonts	BOOL	in	ダウンロード可能なフォントを含める場合は `true`。ローカルにインストールされたフォントのみを対象とする場合は `false`。
fontFamilyModel	DWRITE_FONT_FAMILY_MODEL	in	コレクション内でファミリーをどのようにグループ化するか。
fontCollection	IDWriteFontCollection3**	out	IDWriteFontCollection3 インターフェイスへのポインターのアドレス。正常に完了すると、この関数はポインターを新しく作成されたフォントコレクションオブジェクトに設定します。それ以外の場合は、ポインターを `nullptr` に設定します。

戻り値

Type: HRESULT

関数が成功した場合は S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IDWriteFactory7 "{35D0E0B3-9076-4D2E-A016-A91B568A06B4}"
#usecom global IDWriteFactory7 IID_IDWriteFactory7 "{}"
#comfunc global IDWriteFactory7_GetSystemFontSet         55 int,sptr
#comfunc global IDWriteFactory7_GetSystemFontCollection  56 int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。