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 を含む)

こちらもご覧ください

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo