Metodo Graphics::D rawDriverString (gdiplusgraphics.h)

Articolo
02/26/2024

Il metodo Graphics::D rawDriverString disegna caratteri nelle posizioni specificate. Il metodo fornisce al client il controllo completo sull'aspetto del testo. Il metodo presuppone che il client abbia già configurato il formato e il layout da applicare.

Sintassi

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

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] brush

Tipo: pennello* const

Puntatore a un oggetto Brush utilizzato per riempire la 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 .

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

Questo metodo non supporta la gestione di script complessi e presuppone che il client abbia configurato tutto il layout di testo in un altro modo. Questo metodo è utile per la creazione di voci di menu disegnate dal proprietario. Il client deve usare il metodo DrawString Methods per scopi generali.

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