Graphics::D rawString(constWCHAR*,INT,constFont*,constPointF&,constStringFormat*,constBrush*) メソッド (gdiplusgraphics.h)
Graphics::D rawString メソッドは、フォント、文字列の原点、および形式に基づいて文字列を描画します。
構文
Status DrawString(
[in] const WCHAR *string,
[in] INT length,
[in] const Font *font,
[in, ref] const PointF & origin,
[in] const StringFormat *stringFormat,
[in] const Brush *brush
);
パラメーター
[in] string
型: const WCHAR*
描画するワイド文字列へのポインター。
[in] length
型: INT
文字列配列内の文字数を指定する整数。 文字列が null で終わる場合は、 length パラメーターを –1 に設定できます。
[in] font
型: const Font*
使用するフォント属性 (ファミリ名、サイズ、フォントのスタイル) を指定する Font オブジェクトへのポインター。
[in, ref] origin
型: const PointF
文字列の開始点を指定する PointF オブジェクトへの参照。
[in] stringFormat
型: const StringFormat*
文字列に適用するテキスト レイアウト情報と表示操作を指定する StringFormat オブジェクトへのポインター。
[in] brush
型: const Brush*
文字列の塗りつぶしに使用される Brush オブジェクトへのポインター。
戻り値
種類: 状態
メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
注釈
GDI+ では、TrueType アウトラインのない PostScript フォントまたは OpenType フォントはサポートされないことに注意してください。
GDI+ API を使用する場合、アプリケーションで信頼されていないソースから任意のフォントをダウンロードできないようにする必要があります。 オペレーティング システムでは、インストールされているすべてのフォントが信頼されるように、昇格された特権が必要です。
例
次の例では、指定した書式を使用して、指定した原点に文字列を描画します。
VOID Example_DrawString3(HDC hdc)
{
Graphics graphics(hdc);
// Create a string.
WCHAR string[] = L"Sample Text";
// Initialize arguments.
Font myFont(L"Arial", 16);
PointF origin(0.0f, 0.0f);
SolidBrush blackBrush(Color(255, 0, 0, 0));
StringFormat format;
format.SetAlignment(StringAlignmentCenter);
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
origin,
&format,
&blackBrush);
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | gdiplusgraphics.h (Gdiplus.h を含む) |
| Library | Gdiplus.lib |
| [DLL] | Gdiplus.dll |