Share via

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

另請參閱

圖形

字型

筆

RectF

StringFormat