ID3DX10Font ::D méthode rawText
Dessinez du texte mis en forme. Cette méthode prend en charge les chaînes ANSI et Unicode.
Syntaxe
INT DrawText(
[in] LPD3DX10SPRITE pSprite,
[in] LPCTSTR pString,
[in] INT Count,
[in] LPRECT pRect,
[in] UINT Format,
[in] D3DXCOLOR Color
);
Paramètres
-
pSprite [ dans]
-
Type : LPD3DX10SPRITE
Pointeur vers un objet ID3DX10Sprite qui contient la chaîne que vous souhaitez dessiner. Peut avoir la valeur null, auquel cas Direct3D affiche la chaîne avec son propre objet Sprite. Pour améliorer l’efficacité, un objet Sprite doit être spécifié si ID3DX10Font ::D rawText doit être appelé plusieurs fois dans une ligne.
-
pString [ dans]
-
Type : LPCTSTR
Pointeur vers une chaîne à dessiner. Si UNICODE est défini, ce type de paramètre correspond à un LPCWSTR, dans le cas contraire, le type correspond à un LPCSTR. Si le paramètre count a la valeur-1, la chaîne doit se terminer par null .
-
Nombre [ dans]
-
Type : int
Nombre de caractères dans la chaîne. Si Count a la valeur-1, le paramètre pString est supposé être un pointeur vers un sprite contenant une chaîne se terminant par un caractère NULL et ID3DX10Font ::D rawText calcule le nombre de caractères automatiquement.
-
pRect [ dans]
-
Type : LPRECT
Pointeur vers une structure Rect qui contient le rectangle, en coordonnées logiques, dans lequel le texte doit être mis en forme. Comme avec n’importe quel objet RECT, la valeur de coordonnée du côté droit du rectangle doit être supérieure à celle de son côté gauche. De même, la valeur de coordonnée du bas doit être supérieure à celle du haut.
-
Format [ dans]
-
Type : uint
Spécifiez la méthode de mise en forme du texte. Il peut s’agir de n’importe quelle combinaison des valeurs suivantes :
Élément Description DT en _ bas Justifie le texte en bas du rectangle. Cette valeur doit être combinée avec DT _ Singleline. _CALCRECT DT Indiquez à DrawText de calculer automatiquement la largeur et la hauteur du rectangle en fonction de la longueur de la chaîne que vous lui indiquez de dessiner. S’il y a plusieurs lignes de texte, ID3DX10Font ::D rawText utilise la largeur du rectangle vers lequel pointe le paramètre pRect et étend la base du rectangle pour délimiter la dernière ligne de texte. S’il n’existe qu’une seule ligne de texte, ID3DX10Font ::D rawText modifie le côté droit du rectangle afin qu’il limite le dernier caractère de la ligne. Dans les deux cas, ID3DX10Font ::D rawText retourne la hauteur du texte mis en forme, mais ne dessine pas le texte. _Centre DT Centrer le texte horizontalement dans le rectangle. _ExpandTabs DT Développez caractères de tabulation. Le nombre par défaut de caractères par tabulation est huit. DT à _ gauche Aligner le texte à gauche. DT _ NOclip Dessin sans découpage. ID3DX10Font ::D rawText est un peu plus rapide lorsque DT _ noclip est utilisé. DT- _ droit Aligner le texte à droite. _RTLREADING DT Affichez le texte dans l’ordre de lecture de droite à gauche pour le texte bidirectionnel lorsqu’une police hébraïque ou arabe est sélectionnée. L’ordre de lecture par défaut pour tout le texte est de gauche à droite. DT _ Singleline Affichez le texte sur une seule ligne. Les retours chariot et les sauts de ligne n’interrompent pas la ligne. DT en _ haut Texte de justification en haut. _VCENTER DT Centrer le texte verticalement (une seule ligne). _WordBreak DT Mots insécables. Les lignes sont automatiquement réparties entre les mots si un mot s’étend au-delà du bord du rectangle spécifié par le paramètre pRect. Une séquence de retour chariot/saut de ligne interrompt également la ligne. -
Couleur [ dans]
-
Type : D3DXCOLOR
Couleur du texte. Consultez D3DXCOLOR.
Valeur renvoyée
Type : int
Si la fonction est réussie, la valeur de retour est la hauteur du texte en unités logiques. Si DT _ VCENTER ou DT _ Bottom est spécifié, la valeur de retour est le décalage de pRect (de haut en bas) du texte dessiné. Si la fonction échoue, la valeur de retour est égale à zéro.
Notes
Les paramètres de cette méthode sont très similaires à ceux de la fonction GDI DrawText .
Cette méthode prend en charge les chaînes ANSI et Unicode.
À moins que le _ format DT NOclip ne soit utilisé, cette méthode découpe le texte afin qu’il n’apparaisse pas en dehors du rectangle spécifié. Toute la mise en forme est supposée avoir plusieurs lignes, sauf si le _ format DT Singleline est spécifié.
Si la police sélectionnée est trop grande pour le rectangle, cette méthode n’essaie pas de remplacer une police plus petite.
Cette méthode prend en charge uniquement les polices dont l’échappement et l’orientation sont toutes deux égales à zéro.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|