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

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

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

構文

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

パラメーター

string

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

length

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

family

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

style

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

emSize

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

origin

文字列の位置をワールド単位で指定する PointF オブジェクトへの参照。

format

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

戻り値

Type:Status

メソッドが成功した場合は、 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, 
      PointF(50.0f, 50.0f),
      NULL);

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