Metodo ID3DX10Font::D rawText

Articolo
06/13/2023

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	D3DX10.h
Libreria	D3DX10.lib

Vedi anche

ID3DX10Font
Interfacce D3DX

Share via