Graphics::D rawDriverString メソッド (gdiplusgraphics.h)

[アーティクル]
02/22/2024

Graphics::D rawDriverString メソッドは、指定した位置に文字を描画します。メソッドを使用すると、クライアントはテキストの外観を完全に制御できます。メソッドは、クライアントが適用する形式とレイアウトを既に設定していることを前提としています。

構文

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

パラメーター

[in] text

型: const UINT16*

16 ビット値の配列へのポインター。 DriverStringOptionsCmapLookup フラグが設定されている場合、各値は表示する Unicode 文字を指定します。それ以外の場合、各値は、表示する文字を定義するフォントグリフへのインデックスを指定します。

[in] length

型: INT

テキスト配列内の値の数を指定する整数。文字列が null で終了する場合は、 length パラメーターを –1 に設定できます。

[in] font

種類: const Font*

文字列に適用するフォントのファミリ名、サイズ、スタイルを指定する Font オブジェクトへのポインター。

[in] brush

種類: const Brush*

文字列の塗りつぶしに使用される Brush オブジェクトへのポインター。

[in] positions

型: const PointF*

DriverStringOptionsRealizedAdvance フラグが設定されている場合、positions は最初のグリフの位置を指定する PointF オブジェクトへのポインターです。それ以外の場合、位置は PointF オブジェクトの配列であり、それぞれが個々のグリフの原点を指定します。

[in] flags

型: INT

文字列の外観のオプションを指定する整数。この値は、DriverStringOptions 列挙体の要素、またはこれらの 2 つ以上の要素に適用されるビットごとの OR の結果である必要があります。

[in] matrix

型: const Matrix*

テキスト配列の各値に適用する変換行列を指定する Matrix オブジェクトへのポインター。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

このメソッドは、複雑なスクリプトの処理をサポートせず、クライアントが他の方法ですべてのテキストレイアウトを設定していることを前提としています。このメソッドは、所有者が描画したメニュー項目を作成する場合に便利です。クライアントでは、一般的な目的で DrawString メソッドを使用する必要があります。

要件

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