Font.PreloadGlyphs Method

Language:

Loads a series of glyphs into video memory to improve the efficiency of rendering to a device.

Definition

Visual Basic Public Sub PreloadGlyphs( _
    ByVal first As Integer, _
    ByVal last As Integer _
)

C# public void PreloadGlyphs(
    int first,
    int last
);

C++ public:
void PreloadGlyphs(
    int first,
    int last
);

JScript public function PreloadGlyphs(
    first : int,
    last : int
);

Visual Basic	Public Sub PreloadGlyphs( _ ByVal first As Integer, _ ByVal last As Integer _ )
C#	public void PreloadGlyphs( int first, int last );
C++	public: void PreloadGlyphs( int first, int last );
JScript	public function PreloadGlyphs( first : int, last : int );

Parameters

first System.Int32
Identifier of the first glyph to load into video memory.

last System.Int32
Identifier of the last glyph to load into video memory.

Remarks

This method does not render the glyphs to the device; Font.DrawText still must be called to render the glyphs. However, pre-loading glyphs 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

first	System.Int32 Identifier of the first glyph to load into video memory.
last	System.Int32 Identifier of the last glyph to load into video memory.

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