Font.DrawText Method (Sprite, String, Int32, Int32, Int32)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Draws formatted text.
Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Syntax
'Declaration
Public Function DrawText ( _
sprite As Sprite, _
value As String, _
x As Integer, _
y As Integer, _
color As Integer _
) As Integer
'Usage
Dim instance As Font
Dim sprite As Sprite
Dim value As String
Dim x As Integer
Dim y As Integer
Dim color As Integer
Dim returnValue As Integer
returnValue = instance.DrawText(sprite, _
value, x, y, color)
public int DrawText(
Sprite sprite,
string value,
int x,
int y,
int color
)
public:
int DrawText(
Sprite^ sprite,
String^ value,
int x,
int y,
int color
)
member DrawText :
sprite:Sprite *
value:string *
x:int *
y:int *
color:int -> int
Parameters
- sprite
Type: Microsoft.WindowsMobile.DirectX.Direct3D.Sprite
A Sprite that contains the string. Can be nulla null reference (Nothing in Visual Basic), in which case Direct3D renders the string with its own sprite object.
- value
Type: System.String
The string to draw.
- x
Type: System.Int32
The x-coordinate at which to draw the font.
- y
Type: System.Int32
The y-coordinate at which to draw the font.
- color
Type: System.Int32
An integer color value.
Return Value
Type: System.Int32
If the function succeeds, the return value is the height of the text in logical units. If Center or Bottom is specified in the format parameter, the return value is the offset from the top to the bottom of the drawn text. If the function fails, the return value is 0.
Remarks
This method must be called from inside of a BeginScene-method-to-EndScene-method code block.
Unless the NoClip format is used, this method clips the text so that it does not appear outside of the specified rectangle. All formatting is assumed to have multiple lines unless the SingleLine format is specified.
If the selected font is too large for the rectangle, this method does not attempt to substitute a smaller font.
This method supports only fonts whose escapement and orientation are both zero.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Platforms
Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Compact Framework
Supported in: 3.5, 2.0