GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRectF&,constStringFormat*) メソッド (gdipluspath.h)

[アーティクル]
01/10/2024

GraphicsPath::AddString メソッドは、文字列のアウトラインをこのパスに追加します。

構文

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const RectF &      layoutRect,
  [in]      const StringFormat *format
);

パラメーター

[in] string

型: const WCHAR*

ワイド文字列へのポインター。

[in] length

型: INT

表示する文字数を指定する整数。 文字列パラメーターが NULL で終わる文字列を指している場合、このパラメーターは –1 に設定できます。

[in] family

型: const FontFamily*

文字列のフォントファミリを指定する FontFamily オブジェクトへのポインター。

[in] style

型: INT

書体のスタイルを指定する整数。この値は、FontStyle 列挙の要素、またはこれらの 2 つ以上の要素に適用されたビットごとの OR の結果である必要があります。たとえば、 FontStyleBold | FontStyleUnderline | FontStyleStrikeout 3 つのスタイルの組み合わせとしてスタイルを設定します。

[in] emSize

種類: REAL

文字列文字の em サイズをワールド単位で指定する実数。

[in, ref] layoutRect

型: const RectF

文字列の外接する四角形をワールド単位で指定する RectF オブジェクトへの参照。

[in] format

型: const StringFormat*

文字列のレイアウト情報 (配置、トリミング、タブ位置など) を指定する StringFormat オブジェクトへのポインター。

戻り値

種類: 状態

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

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

注釈

GDI+ では、TrueType アウトラインのない PostScript フォントまたは OpenType フォントはサポートされないことに注意してください。

例

次の例では、 GraphicsPath オブジェクトパスを作成し、 NULL で終わる文字列を path に追加してから、パスを描画します。

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      RectF(50.0f, 50.0f, 150.0f, 100.0f),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

要件


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