ID3DXFont ::P méthode reloadText

Charge le texte mis en forme dans la mémoire vidéo pour améliorer l’efficacité du rendu sur l’appareil. Cette méthode prend en charge les chaînes ANSI et Unicode.

Syntaxe

HRESULT PreloadText(
  [in] LPCTSTR *pString,
  [in] INT     Count
);

Paramètres

pString [ dans]

Type : LPCTSTR*

Pointeur vers une chaîne de caractères à charger dans la mémoire vidéo. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR ; dans le cas contraire, le type de données est résolu en LPCSTR. Consultez la section Notes.

Nombre [ dans]

Type : int

Nombre de caractères dans la chaîne de texte.

Valeur retournée

Type : HRESULT

Si la méthode est réussie, la valeur de retour est S _ OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé.

Remarques

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en PreloadTextW. Dans le cas contraire, l’appel de fonction est résolu en PreloadTextA, car les chaînes ANSI sont utilisées.

Cette méthode génère des textures qui contiennent des glyphes qui représentent le texte d’entrée. Les glyphes sont dessinés sous la forme d’une série de triangles.

Le texte ne sera pas rendu sur l’appareil ; DrawText doit encore être appelé pour restituer le texte. Toutefois, en préchargeant le texte dans la mémoire vidéo, DrawText utilise beaucoup moins de ressources processeur.

Cette méthode convertit en interne les caractères en glyphes à l’aide de la fonction GDI GetCharacterPlacement.

Configuration requise

Condition requise Valeur
En-tête
D3dx9core. h
Bibliothèque
D3dx9. lib

Voir aussi

ID3DXFont