Font.PreloadText(String) Method (Microsoft.DirectX.Direct3D)

  • Article

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(
    StringLeave Site^ 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.