Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) (gdiplusgraphics.h)

Il metodo Graphics::D rawString disegna una stringa basata su un tipo di carattere, un rettangolo di layout e un formato.

Sintassi

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

Parametri

string

Puntatore a una stringa di caratteri wide da disegnare.

length

Intero che specifica il numero di caratteri nella matrice di stringhe . Il parametro di lunghezza può essere impostato su -1 se la stringa è terminata null.

font

Puntatore a un oggetto Font che specifica gli attributi del tipo di carattere (il nome della famiglia, le dimensioni e lo stile del tipo di carattere) da usare.

layoutRect

Riferimento a un rettangolo che delimita la stringa.

stringFormat

Puntatore a un oggetto StringFormat che specifica le informazioni sul layout di testo e visualizza le manipolazioni da applicare alla stringa.

brush

Puntatore a un oggetto Brush utilizzato per riempire la stringa.

Valore restituito

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Si noti che GDI+ non supporta tipi di carattere PostScript o tipi di carattere OpenType che non hanno struttura TrueType.

Quando si usa l'API GDI+, non è necessario consentire all'applicazione di scaricare tipi di carattere arbitrari da origini non attendibili. Il sistema operativo richiede privilegi elevati per garantire che tutti i tipi di carattere installati siano attendibili.

Esempio

Nell'esempio seguente viene usata la formattazione specificata per disegnare una stringa in un rettangolo di layout.

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

Requisiti

Intestazione	gdiplusgraphics.h

Vedi anche

Grafica

Carattere

Penna

RectF

StringFormat