ID3DXFont::P reloadText-Methode

Lädt formatierten Text in den Videospeicher, um die Effizienz des Renderns auf dem Gerät zu verbessern. Diese Methode unterstützt ANSI- und Unicode-Zeichenfolgen.

Syntax

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

Parameter

pString [in]

Typ: LPCTSTR*

Zeiger auf eine Zeichenfolge, die in den Videospeicher geladen werden soll. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Datentyp in LPCSTR aufgelöst. Siehe Hinweise.

Anzahl [in]

Typ: INT

Anzahl der Zeichen in der Textzeichenfolge.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Bemerkungen

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in PreloadTextW aufgelöst. Andernfalls wird der Funktionsaufruf in PreloadTextA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Diese Methode generiert Texturen, die Glyphen enthalten, die den Eingabetext darstellen. Die Glyphen werden als Eine Reihe von Dreiecken gezeichnet.

Text wird nicht auf dem Gerät gerendert. DrawText muss weiterhin aufgerufen werden, um den Text zu rendern. Durch das Vorabladen von Text in den Videospeicher benötigt DrawText jedoch wesentlich weniger CPU-Ressourcen.

Diese Methode konvertiert Mithilfe der GDI-Funktion GetCharacterPlacement intern Zeichen in Glyphen.

Anforderungen

Siehe auch

ID3DXFont