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

Articolo
07/16/2024

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 un NULLstringa con terminazione, questo parametro può essere impostato su -1.

family

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

style

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

emSize

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

origin

Riferimento a un oggetto PointF che specifica, in unità di misura globale, la posizione della stringa.

format

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

Valore restituito

Tipo di :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.

Osservazioni

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

Esempi

Nell'esempio seguente viene creato un GraphicsPath percorso oggetto, viene aggiunta una stringa con terminazione NULL al percorso e quindi viene disegnato 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);
}