Graphics::D rawString (constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) method (gdiplusgraphics.h)
Graphics::D rawString 方法會根據字型、版面配置矩形和格式繪製字串。
語法
Status DrawString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
const Brush *brush
);
參數
string
要繪製之寬字元字串的指標。
length
指定 字串 陣列中字元數的整數。 如果字串為 null 終止, 則長度 參數可以設定為 -1。
font
Font 物件的指標,指定 (系列名稱、大小及要使用的字型樣式) 的字型屬性。
layoutRect
系結字串的矩形參考。
stringFormat
StringFormat 物件的指標,指定要套用至字串的文字配置資訊和顯示操作。
brush
用於填滿字串之 Brush 物件的指標。
傳回值
如果方法成功,它會傳回 Ok,這是 Status 列舉的元素。
如果方法失敗,它會傳回 Status 列舉的其中一個其他元素。
備註
請注意,GDI+ 不支援 PostScript 字型或沒有 TrueType 外框的 OpenType 字型。
當您使用 GDI+ API 時,不得允許應用程式從不受信任的來源下載任意字型。 操作系統需要提高的許可權,以確保所有已安裝的字型都受到信任。
範例
下列範例會使用指定的格式設定,在版面配置矩形中繪製字元串。
VOID Example_DrawString(HDC hdc)
{
Graphics graphics(hdc);
// Create a string.
WCHAR string[] = L"Sample Text";
// Initialize arguments.
Font myFont(L"Arial", 16);
RectF layoutRect(0.0f, 0.0f, 200.0f, 50.0f);
StringFormat format;
format.SetAlignment(StringAlignmentCenter);
SolidBrush blackBrush(Color(255, 0, 0, 0));
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
layoutRect,
&format,
&blackBrush);
// Draw layoutRect.
graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}
規格需求
標頭 | gdiplusgraphics.h |