次の方法で共有

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

  • [アーティクル]

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-terminated 文字列を指している場合は、このパラメーターを –1 に設定できます。

family

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

style

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

emSize

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

origin

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

format

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

戻り値

の種類:状態

メソッドが成功した場合は、ok を返します。これは、Status 列挙体の要素です。

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

備考

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

例

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

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);
}

必要条件

要件 価値
ヘッダー gdipluspath.h

関連項目

AddString メソッド を する

領域 でのクリッピングの

パス の構築と描画の

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

フォント

FontFamily

FontStyle

GraphicsPath

PointF

StringFormat

テキストとフォントの を使用した