GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) (gdipluspath.h)

Articolo
02/27/2024

Il metodo GraphicsPath::AddString aggiunge la struttura di una stringa a questo percorso.

Sintassi

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Parametri

[in] string

Tipo: const WCHAR*

Puntatore a una stringa di caratteri wide.

[in] length

Tipo: INT

Intero che specifica il numero di caratteri da visualizzare. Se il parametro stringa punta a una stringa con terminazione NULL, questo parametro può essere impostato su -1.

[in] family

Tipo: const FontFamily*

Puntatore a un oggetto FontFamily che specifica la famiglia di caratteri per la stringa.

[in] style

Tipo: INT

Intero che specifica lo stile del carattere di tipo. Questo valore deve essere un elemento dell'enumerazione FontStyle o il risultato di un OR bit applicato a due o più elementi. Ad esempio, FontStyleBold | FontStyleUnderline | FontStyleStrikeout imposta lo stile come combinazione dei tre stili.

[in] emSize

Tipo: REAL

Numero reale che specifica le dimensioni em, nelle unità mondiali, dei caratteri stringa.

[in, ref] layoutRect

Tipo: const Rect

Riferimento a un oggetto Rect che specifica, nelle unità mondiali, il rettangolo di selezione per la stringa.

[in] format

Tipo: const StringFormat*

Puntatore a un oggetto StringFormat che specifica informazioni sul layout (allineamento, ritaglio, tabulazioni e simili) per la stringa.

Valore restituito

Tipo: Stato

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.

Esempio

L'esempio seguente crea un percorso oggetto GraphicsPath, aggiunge una stringa con terminazione NULL al percorso e quindi disegna il percorso.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requisiti

Requisito	Valore
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	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll