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

Articolo
08/24/2023

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

Sintassi

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Parametri

string

Puntatore a una stringa di caratteri wide.

length

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.

family

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

style

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.

emSize

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

origin

Riferimento a un oggetto PointF che specifica, nelle unità mondiali, la posizione della stringa.

format

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

Valore restituito

Type:Status

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, 
      PointF(50.0f, 50.0f),
      NULL);

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