Font.PreloadText Method

Language:

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

Definition

Visual Basic Public Sub PreloadText( _
    ByVal text As String _
)

C# public void PreloadText(
    string text
);

C++ public:
void PreloadText(
    String^ text
);

JScript public function PreloadText(
    text : String
);

Visual Basic	Public Sub PreloadText( _ ByVal text As String _ )
C#	public void PreloadText( string text );
C++	public: void PreloadText( String^ text );
JScript	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.

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

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