Metodo Font.DrawText (Sprite, String, Point, 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, _
    pos As Point, _
    color As Color _
) As Integer
'Utilizzo
Dim instance As Font
Dim sprite As Sprite
Dim value As String
Dim pos As Point
Dim color As Color
Dim returnValue As Integer

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

public int DrawText(
    Sprite sprite,
    string value,
    Point pos,
    Color color
)

public:
int DrawText(
    Sprite^ sprite, 
    String^ value, 
    Point pos, 
    Color color
)

public function DrawText(
    sprite : Sprite, 
    value : String, 
    pos : Point, 
    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.

pos
Tipo: System.Drawing.Point

Struttura Point che specifica le coordinate superiori sinistre del punto in cui creare il tipo di carattere.

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.