Metodo Font.DrawText (Sprite, String, Rectangle, DrawTextFormat, Color)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Crea il testo formattato.

Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Sintassi

'Dichiarazione
Public Function DrawText ( _
    sprite As Sprite, _
    value As String, _
    rectangle As Rectangle, _
    format As DrawTextFormat, _
    color As Color _
) As Integer
'Utilizzo
Dim instance As Font
Dim sprite As Sprite
Dim value As String
Dim rectangle As Rectangle
Dim format As DrawTextFormat
Dim color As Color
Dim returnValue As Integer

returnValue = instance.DrawText(sprite, _
    value, rectangle, format, color)

public int DrawText(
    Sprite sprite,
    string value,
    Rectangle rectangle,
    DrawTextFormat format,
    Color color
)

public:
int DrawText(
    Sprite^ sprite, 
    String^ value, 
    Rectangle rectangle, 
    DrawTextFormat format, 
    Color color
)

public function DrawText(
    sprite : Sprite, 
    value : String, 
    rectangle : Rectangle, 
    format : DrawTextFormat, 
    color : Color
) : int

Parametri

sprite
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Sprite

Oggetto Sprite che contiene la stringa. Può essere nullriferimento null (Nothing in Visual Basic), nel cui caso viene eseguito il rendering della stringa con il relativo oggetto sprite.

value
Tipo: System.String

Stringa da disegnare.

rectangle
Tipo: System.Drawing.Rectangle

Riferimento a una struttura Rectangle che contiene il rettangolo, in coordinate logiche, nel quale viene formattato il testo.

format
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.DrawTextFormat

Metodo di formattazione del testo; può essere qualsiasi combinazione di valori dall'enumerazione DrawTextFormat.

color
Tipo: System.Drawing.Color

Oggetto Color del testo.

Valore restituito

Tipo: System.Int32

Se la funzione ha esito positivo, il valore restituito rappresenta l'altezza del testo in unità logiche. Se si specifica Center o Bottom nel parametro di formato, il valore restituito rappresenterà l'offset dall'alto verso il basso del testo creato. Se la funzione ha esito negativo, il valore restituito sarà 0.

Note

Questo metodo deve essere chiamato dall'interno di un blocco di codice metodo BeginScene-a-metodo EndScene.

A meno che non venga utilizzato il formato NoClip, questo metodo ritaglia il testo in modo che non venga visualizzato all'esterno del triangolo specificato. Si presuppone che tutta la formattazione presenti più linee, a meno che non venga specificato il formato SingleLine.

Se il tipo di carattere selezionato è troppo grande per il rettangolo, questo metodo non tenta di sostituirlo con un tipo di carettere più piccolo.

Questo metodo supporta unicamente tipi di carattere che presentano un angolo di rotazione e un orientamento pari a zero.

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Piattaforme

Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.