Microsoft DirectX 9.0 SDK Update (October 2004)

Font.PreloadText Method

Language:

Note: This documentation is preliminary and is subject to change.

Loads formatted text into video memory to improve the efficiency of rendering to a device.

Definition

Visual Basic .NET Public Sub PreloadText( _
    ByVal text As String _
)
C# public void PreloadText(
    string text
);
Managed C++ public: void PreloadText(
    String *text
);
JScript .NET public function PreloadText(
    text : String
);

Parameters

text System.String. String of characters to load into video memory.

Remarks

This method does not render text to the device; Font.DrawText must still be called to render the text. However, pre-loading text into video memory causes Font.DrawText to use substantially fewer CPU resources.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.
InvalidDataException The data is invalid.


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center