次の方法で共有


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

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

こちらもご覧ください

AddString メソッド

領域を使用したクリッピング

パスの作成および描画

パス グラデーションの作成

フォント

FontFamily

FontStyle

Graphicspath

RectF

StringFormat

テキストとフォントの使用