GETINFO_GLYPHSTRING構造体 (printoem.h)
GETINFO_GLYPHSTRING構造体は、UNIFONTOBJ_GetInfo コールバック関数への入力として使用されます。
構文
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
メンバー
dwSize
GETINFO_GLYPHSTRING構造体のサイズをバイト単位で指定します。 この値は、 UNIFONTOBJ_GetInfo 呼び出し元によって提供されます。
dwCount
pGlyphIn および pGlyphOut によって指される配列内の要素の数を指定します。 この値は、 UNIFONTOBJ_GetInfo 呼び出し元によって提供されます。
dwTypeIn
pGlyphIn が指すグリフ指定子配列の型を指定します。 有効な値は次のとおりです。
値 | 定義 |
---|---|
TYPE_GLYPHHANDLE | TpGlyphIn 配列要素は HGLYPH 型であるか、デバイス フォント グリフへのハンドルです。 dwTypeIn のこの値の場合、dwTypeOut の有効な値はTYPE_UNICODEまたはTYPE_TRANSDATAです。 |
TYPE_GLYPHID | pGlyphIn 配列要素は DWORD 型で、ダウンロードした TrueType フォント グリフのグリフ識別子が含まれています。 dwTypeIn のこの値の場合、dwTypeOut の有効な値はTYPE_UNICODEまたはTYPE_GLYPHHANDLEです。 |
UNIFONTOBJ_GetInfo呼び出し元によって提供されます。
pGlyphIn
グリフ指定子の配列へのポインター。 配列要素の型は dwTypeIn によって示されます。 この値は、 UNIFONTOBJ_GetInfo 呼び出し元によって提供されます。
dwTypeOut
pGlyphOut が指すグリフ指定子配列の型を指定します。 有効な値は次のとおりです。
値 | 定義 |
---|---|
TYPE_GLYPHHANDLE | pGlyphOut 配列要素は HGLYPH 型であるか、デバイス フォント グリフへのハンドルです。 この値は、 dwTypeIn が TYPE_GLYPHID に設定されている場合にのみ有効です。 |
TYPE_TRANSDATA | pGlyphOut 配列要素は TRANSDATA 型です。 この値は、 dwTypeIn が TYPE_GLYPHHANDLE に設定されている場合にのみ有効です。 |
TYPE_UNICODE | pGlyph 配列要素は WCHAR 型です。 この値は、 dwTypeIn が TYPE_GLYPHHANDLE または TYPE_GLYPHID のいずれかに設定されている場合に有効です。 |
UNIFONTOBJ_GetInfo呼び出し元によって提供されます。
pGlyphOut
グリフ指定子の空の配列への呼び出し元指定ポインター。 配列は、Unidrv の UNIFONTOBJ_GetInfo コールバック関数によって入力されます。 配列要素の型は dwTypeOut で示されます。 このポインターは、UNIFONTOBJ_GetInfo呼び出し元によって提供されます。
dwGlyphOutSize
pGlyphOut が指すバッファーのサイズをバイト単位で指定します。 このメンバーは、 dwTypeIn が TYPE_GLYPHHANDLE に設定され、 dwTypeOut が TYPE_TRANSDATA に設定されている場合にのみ使用されます。 詳細については、次の「備考」セクションを参照してください。
注釈
グリフ指定子の配列をある型から別の型に変換するために、レンダリング プラグインは Unidrv の UNIFONTOBJ_GetInfo コールバック関数を呼び出すときに 、GETINFO_GLYPHSTRING 構造体のアドレスを指定できます。
変換が TYPE_GLYPHHANDLE から TYPE_TRANSDATA に変換される場合は、 UNIFONTOBJ_GetInfo を 2 回呼び出す必要があります。
UNIFONTOBJ_GetInfoの最初の呼び出しの前に、レンダリング プラグインによって dwSize、dwCount、dwTypeIn、および pGlyphIn メンバーが入力され、dwGlyphOutSize メンバーが 0 に設定されます。
UNIFONTOBJ_GetInfoが返された後、dwGlyphOutSize メンバーには、変換された文字列を格納するために必要なバッファーのサイズ (バイト単位) が含まれます。
プラグインは 、dwGlyphOutSize メンバーで受信したサイズのメモリ ブロックを割り当て、このメモリ ブロックを指すように pGlyphOut メンバーを設定し、 UNIFONTOBJ_GetInfo をもう一度呼び出します。 その後、UNIDRV は文字列を TYPE_GLYPHHANDLE から TYPE_TRANSDATA に変換します。
レンダリング プラグインが dwTypeInおよび pGlyphIn メンバーに 対して指定する値は、通常、以前に dwTypeパラメーターおよび pGlyph パラメーターとして IPrintOemUni::OutputCharStr メソッドに受け取られた値です。
要件
要件 | 値 |
---|---|
Header | printoem.h (Printoem.h を含む) |