次の方法で共有

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 PGlyphIn配列要素 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 メンバー ゼロに設定します。

    UNIFONTOBJ_GetInfo が返された後、dwGlyphOutSize メンバーには、変換された文字列を格納するために必要なバッファーのサイズ (バイト単位) が含まれます。

  • プラグインは、dwGlyphOutSize メンバーで受信したサイズのメモリ ブロックを割り当て、このメモリ ブロックを指すように pGlyphOut メンバーを設定し、UNIFONTOBJ_GetInfo をもう一度呼び出します。 その後、UNIDRV は文字列を TYPE_GLYPHHANDLE から TYPE_TRANSDATA に変換します。

dwTypeInおよび pGlyphIn メンバーに対してレンダリング プラグインが指定する値は、通常、dwTypeとして受け取り、IPrintOemUni::OutputCharStr メソッドに pGlyph パラメーターを したものです。

必要条件

要件 価値
ヘッダー printoem.h (Printoem.h を含む)

関連項目

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo