Metodo Graphics::MeasureDriverString (gdiplusgraphics.h)

Articolo
02/27/2024

Il metodo Graphics::MeasureDriverString misura il rettangolo di selezione per i caratteri specificati e le relative posizioni corrispondenti.

Sintassi

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

Parametri

[in] text

Tipo: const UINT16*

Puntatore a una matrice di valori a 16 bit. Se il flag DriverStringOptionsCmapLookup è impostato, ogni valore specifica un carattere Unicode da visualizzare. In caso contrario, ogni valore specifica un indice a un glifo del tipo di carattere che definisce un carattere da visualizzare.

[in] length

Tipo: INT

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

[in] font

Tipo: carattere const *

Puntatore a un oggetto Font che specifica il nome della famiglia, le dimensioni e lo stile del tipo di carattere da applicare alla stringa.

[in] positions

Tipo: const PointF*

Se viene impostato il flag DriverStringOptionsAdAdvance, le posizioni sono un puntatore a un oggetto PointF che specifica la posizione del primo glifo. In caso contrario, le posizioni sono una matrice di oggetti PointF , ognuno dei quali specifica l'origine di un singolo glifo.

[in] flags

Tipo: INT

Intero che specifica le opzioni per l'aspetto della stringa. Questo valore deve essere un elemento dell'enumerazione DriverStringOptions o il risultato di un or bit per bit applicato a due o più di questi elementi.

[in] matrix

Tipo: matrice* const

Puntatore a un oggetto Matrix che specifica la matrice di trasformazione da applicare a ogni valore della matrice di testo .

[out] boundingBox

Tipo: RectF*

Puntatore a un oggetto RectF che riceve il rettangolo che delimita 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 .

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