Metodo ID3DX10Font::D rawText
Disegnare testo formattato. Questo metodo supporta stringhe ANSI e Unicode.
Sintassi
INT DrawText(
[in] LPD3DX10SPRITE pSprite,
[in] LPCTSTR pString,
[in] INT Count,
[in] LPRECT pRect,
[in] UINT Format,
[in] D3DXCOLOR Color
);
Parametri
-
pSprite [in]
-
Tipo: LPD3DX10SPRITE
Puntatore a un oggetto ID3DX10Sprite contenente la stringa da disegnare. 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 ID3DX10Font::D rawText deve essere chiamato più volte in una riga.
-
pString [in]
-
Tipo: LPCTSTR
Puntatore a una stringa da disegnare. Se unicode è definito, questo tipo di parametro viene risolto in un LPCWSTR; in caso contrario, il tipo viene risolto in un LPCSTR. Se il parametro Count è -1, la stringa deve essere terminata null .
-
Conteggio [in]
-
Tipo: INT
Numero di caratteri nella stringa. Se Count è -1, si presuppone che il parametro pString sia un puntatore a uno sprite contenente una stringa con terminazione NULL e ID3DX10Font::D rawText 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. Come per qualsiasi oggetto RECT, il valore di 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: UINT
Specificare il metodo di formattazione del testo. Può essere una qualsiasi combinazione dei valori seguenti:
Elemento Descrizione DT_BOTTOM Giustificare il testo nella parte inferiore del rettangolo. Questo valore deve essere combinato con DT_SINGLELINE. DT_CALCRECT Indicare a DrawText di calcolare automaticamente la larghezza e l'altezza del rettangolo in base alla lunghezza della stringa da disegnare. Se sono presenti più righe di testo, ID3DX10Font::D rawText usa 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, ID3DX10Font::D rawText modifica il lato destro del rettangolo in modo che limiti l'ultimo carattere nella riga. In entrambi i casi, ID3DX10Font::D rawText restituisce l'altezza del testo formattato ma non disegna il testo. DT_CENTER Allinea il testo al centro orizzontalmente nel rettangolo. DT_EXPANDTABS Espandere i caratteri di tabulazioni. Il numero predefinito di caratteri per tabulazione è otto. DT_LEFT Allineare il testo a sinistra. DT_NOCLIP Disegnare senza ritagliare. ID3DX10Font::D rawText è leggermente più veloce quando si usa DT_NOCLIP. DT_RIGHT Allineare il testo a destra. DT_RTLREADING Visualizza il testo nell'ordine di lettura da destra a sinistra per il testo bidirezionale quando viene selezionato un tipo di carattere ebraico o arabo. L'ordine di lettura predefinito per tutto il testo è da sinistra a destra. DT_SINGLELINE Consente di visualizzare il testo solo su una singola riga. I ritorni a capo e i avanzamenti riga non interrompono la riga. DT_TOP Testo con giustificazione superiore. DT_VCENTER Allinea il testo al centro verticalmente (solo riga singola). DT_WORDBREAK Interrompi 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: D3DXCOLOR
Colore del testo. Vedere D3DXCOLOR.
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.
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
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche