Metodo ID3DXFont::D rawText

Disegna testo formattato. Questo metodo supporta stringhe ANSI e Unicode.

Sintassi

INT DrawText(
  [in] LPD3DXSPRITE pSprite,
  [in] LPCTSTR      pString,
  [in] INT          Count,
  [in] LPRECT       pRect,
  [in] DWORD        Format,
  [in] D3DCOLOR     Color
);

Parametri

pSprite [in]

Tipo: LPD3DXSPRITE

Puntatore a un oggetto ID3DXSprite contenente la stringa. Può essere NULL, nel qual caso Direct3D eseguirà il rendering della stringa con il proprio oggetto sprite. Per migliorare l'efficienza, è necessario specificare un oggetto sprite se DrawText deve essere chiamato più volte in una riga.

pString [in]

Tipo: LPCTSTR

Puntatore a una stringa da disegnare. Se il parametro Count è -1, la stringa deve essere con terminazione Null.

Conteggio [in]

Tipo: INT

Specifica il numero di caratteri nella stringa. Se Count è -1, si presuppone che il parametro pString sia un puntatore a una stringa con terminazione Null e DrawText calcola automaticamente il conteggio dei caratteri.

pRect [in]

Tipo: LPRECT

Puntatore a una struttura RECT che contiene il rettangolo, in coordinate logiche, in cui il testo deve essere formattato. Il valore della coordinata del lato destro del rettangolo deve essere maggiore di quello del lato sinistro. Analogamente, il valore della coordinata della parte inferiore deve essere maggiore di quello superiore.

Formato [in]

Tipo: DWORD

Specifica il metodo di formattazione del testo. Può essere una qualsiasi combinazione dei valori seguenti:

Valore	Significato
DT_BOTTOM	Giustifica il testo nella parte inferiore del rettangolo. Questo valore deve essere combinato con DT_SINGLELINE.
DT_CALCRECT	Determina la larghezza e l'altezza del rettangolo. Se sono presenti più righe di testo, DrawText utilizza la larghezza del rettangolo a cui punta il parametro pRect ed estende la base del rettangolo per associare l'ultima riga di testo. Se è presente una sola riga di testo, DrawText modifica il lato destro del rettangolo in modo che limiti l'ultimo carattere nella riga. In entrambi i casi , DrawText restituisce l'altezza del testo formattato ma non disegna il testo.
DT_CENTER	Centra il testo orizzontalmente nel rettangolo.
DT_EXPANDTABS	Espande i caratteri di tabulazione. Il numero predefinito di caratteri per tabulazione è otto.
DT_LEFT	Allinea il testo a sinistra.
DT_NOCLIP	Disegna senza ritagliare. DrawText è leggermente più veloce quando si usa DT_NOCLIP.
DT_RIGHT	Allinea il testo a destra.
DT_RTLREADING	Visualizza il testo nell'ordine di lettura da destra a sinistra per il testo bidirezionale quando è selezionato un tipo di carattere ebraico o arabo. L'ordine di lettura predefinito per tutto il testo è da sinistra a destra.
DT_SINGLELINE	Visualizza il testo solo su una singola riga. I ritorni a capo e i avanzamenti riga non interrompono la riga.
DT_TOP	In primo piano il testo viene giustificato.
DT_VCENTER	Centra il testo verticalmente (solo riga singola).
DT_WORDBREAK	Interrompe le parole. Le righe vengono interrotte automaticamente tra le parole se una parola si estende oltre il bordo del rettangolo specificato dal parametro pRect. Una sequenza di ritorno a capo/avanzamento riga interrompe anche la riga.

 

Colore [in]

Tipo: D3DCOLOR

Colore del testo. Per altre informazioni, vedere D3DCOLOR.

Valore restituito

Tipo: INT

Se la funzione ha esito positivo, il valore restituito corrisponde all'altezza del testo in unità logiche. Se viene specificato DT_VCENTER o DT_BOTTOM, il valore restituito corrisponde all'offset da pRect (in alto verso il basso) del testo disegnato. Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

I parametri di questo metodo sono molto simili a quelli della funzione DrawText GDI.

Questo metodo supporta stringhe ANSI e Unicode.

Questo metodo deve essere chiamato all'interno di beginScene ... Blocco EndScene . L'unica eccezione è quando un'applicazione chiama DrawText con DT_CALCRECT per calcolare le dimensioni di un determinato blocco di testo.

A meno che non venga utilizzato il formato DT_NOCLIP, questo metodo ritaglia il testo in modo che non venga visualizzato all'esterno del rettangolo specificato. Si presuppone che la formattazione abbia più righe, a meno che non venga specificato il formato DT_SINGLELINE.

Se il tipo di carattere selezionato è troppo grande per il rettangolo, questo metodo non tenta di sostituire un tipo di carattere più piccolo.

Questo metodo supporta solo i tipi di carattere i cui caratteri di escape e orientamento sono entrambi zero.

Requisiti

Vedi anche

ID3DXFont