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

Il metodo Graphics::D rawString disegna una stringa basata su un tipo di carattere e un'origine per la stringa.

Sintassi

Status DrawString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [in]      const Brush    *brush
);

Parametri

[in] string

Tipo: const WCHAR*

Puntatore a una stringa di caratteri wide da disegnare.

[in] length

Tipo: INT

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

[in] font

Tipo: carattere const *

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 utilizzare.

[in, ref] origin

Tipo: const PointF

Riferimento a un oggetto PointF che specifica il punto iniziale per la stringa.

[in] brush

Tipo: pennello* const

Puntatore a un oggetto Brush utilizzato per riempire la stringa.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è 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 contorni 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 tracciata una stringa in corrispondenza dell'origine specificata.

VOID Example_DrawString2(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));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &blackBrush);
}

Requisiti

Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll

Vedi anche

Carattere

Grafica

GraphicsPath

Solidbrush