GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,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 Rect & 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 Rect
文字列の外接する四角形をワールド単位で指定する Rect オブジェクトへの参照。
[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,
Rect(50, 50, 150, 100),
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 |