GraphicsPath.AddString Metodo

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-preview.6.24327.6

Aggiunge una stringa di testo a questo percorso.

Overload

AddString(String, FontFamily, Int32, Single, Point, StringFormat)	Aggiunge una stringa di testo a questo percorso.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	Aggiunge una stringa di testo a questo percorso.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	Aggiunge una stringa di testo a questo percorso.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	Aggiunge una stringa di testo a questo percorso.

AddString(String, FontFamily, Int32, Single, Point, StringFormat)

Origine:

GraphicsPath.cs

Aggiunge una stringa di testo a questo percorso.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::Point origin, System::Drawing::StringFormat ^ format);

public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Point origin, System.Drawing.StringFormat? format);

member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.Point * System.Drawing.StringFormat -> unit

Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, origin As Point, format As StringFormat)

Parametri

s

String

String da aggiungere.

family

FontFamily

Oggetto FontFamily che rappresenta il nome del tipo di carattere con cui viene disegnato il test.

style

Int32

Enumerazione FontStyle che rappresenta informazioni di stile sul testo (grassetto, corsivo e così via). È necessario eseguire il cast come numero intero (vedere il codice di esempio più avanti in questa sezione).

emSize

Single

Altezza della casella quadrata em che delimita il carattere.

origin

Point

Oggetto Point che rappresenta il punto in cui inizia il testo.

format

StringFormat

Oggetto StringFormat che specifica le informazioni di formattazione del testo, ad esempio l'interlinea e l'allineamento.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, un oggetto evento OnPaint. Il codice esegue le azioni seguenti:

• Crea un percorso.

• Imposta gli argomenti stringa e tipo di carattere.

• Aggiunge la stringa al percorso.

• Disegna la stringa sullo schermo.

Ci sono due aspetti importanti da sottolineare. Prima di tutto, si noti che viene eseguito il cast dell'argomento fontStyle come numero intero. Il metodo AddString richiede questa operazione in modo che due o più membri FontStyle possano essere combinati per creare lo stile del tipo di carattere desiderato (in questo caso, Italic e Underline). In secondo luogo, si noti che il metodo FillPath viene usato anziché il metodo DrawPath. Se si utilizza FillPath, viene eseguito il rendering del testo a tinta unita, mentre se DrawPath viene utilizzato, il testo sarà uno stile di struttura.

private:
   void AddStringExample( PaintEventArgs^ e )
   {
      // Create a GraphicsPath object.
      GraphicsPath^ myPath = gcnew GraphicsPath;

      // Set up all the string parameters.
      String^ stringText = "Sample Text";
      FontFamily^ family = gcnew FontFamily( "Arial" );
      int fontStyle = (int)FontStyle::Italic;
      int emSize = 26;
      Point origin = Point(20,20);
      StringFormat^ format = StringFormat::GenericDefault;

      // Add the string to the path.
      myPath->AddString( stringText, family, fontStyle, (float)emSize, origin, format );

      //Draw the path to the screen.
      e->Graphics->FillPath( Brushes::Black, myPath );
   }

private void AddStringExample(PaintEventArgs e)
{
             
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();
             
    // Set up all the string parameters.
    string stringText = "Sample Text";
    FontFamily family = new FontFamily("Arial");
    int fontStyle = (int)FontStyle.Italic;
    int emSize = 26;
    Point origin = new Point(20, 20);
    StringFormat format = StringFormat.GenericDefault;
             
    // Add the string to the path.
    myPath.AddString(stringText,
        family,
        fontStyle,
        emSize,
        origin,
        format);
             
    //Draw the path to the screen.
    e.Graphics.FillPath(Brushes.Black, myPath);
}

Public Sub AddStringExample(ByVal e As PaintEventArgs)

    ' Create a GraphicsPath object.
    Dim myPath As New GraphicsPath

    ' Set up all the string parameters.
    Dim stringText As String = "Sample Text"
    Dim family As New FontFamily("Arial")
    Dim myfontStyle As Integer = CInt(FontStyle.Italic)
    Dim emSize As Integer = 26
    Dim origin As New Point(20, 20)
    Dim format As StringFormat = StringFormat.GenericDefault

    ' Add the string to the path.
    myPath.AddString(stringText, family, myfontStyle, emSize, _
    origin, format)

    'Draw the path to the screen.
    e.Graphics.FillPath(Brushes.Black, myPath)
End Sub

AddString(String, FontFamily, Int32, Single, PointF, StringFormat)

Origine:

GraphicsPath.cs

Aggiunge una stringa di testo a questo percorso.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::PointF origin, System::Drawing::StringFormat ^ format);

public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.PointF origin, System.Drawing.StringFormat? format);

member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.PointF * System.Drawing.StringFormat -> unit

Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, origin As PointF, format As StringFormat)

Parametri

s

String

String da aggiungere.

family

FontFamily

Oggetto FontFamily che rappresenta il nome del tipo di carattere con cui viene disegnato il test.

style

Int32

Enumerazione FontStyle che rappresenta informazioni di stile sul testo (grassetto, corsivo e così via). È necessario eseguire il cast come numero intero (vedere il codice di esempio più avanti in questa sezione).

emSize

Single

Altezza della casella quadrata em che delimita il carattere.

origin

PointF

Oggetto PointF che rappresenta il punto in cui inizia il testo.

format

StringFormat

Oggetto StringFormat che specifica le informazioni di formattazione del testo, ad esempio l'interlinea e l'allineamento.

Esempio

Per un esempio, vedere AddString(String, FontFamily, Int32, Single, Point, StringFormat).

AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)

Origine:

GraphicsPath.cs

Aggiunge una stringa di testo a questo percorso.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::Rectangle layoutRect, System::Drawing::StringFormat ^ format);

public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Rectangle layoutRect, System.Drawing.StringFormat? format);

member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.Rectangle * System.Drawing.StringFormat -> unit

Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, layoutRect As Rectangle, format As StringFormat)

Parametri

s

String

String da aggiungere.

family

FontFamily

Oggetto FontFamily che rappresenta il nome del tipo di carattere con cui viene disegnato il test.

style

Int32

Enumerazione FontStyle che rappresenta informazioni di stile sul testo (grassetto, corsivo e così via). È necessario eseguire il cast come numero intero (vedere il codice di esempio più avanti in questa sezione).

emSize

Single

Altezza della casella quadrata em che delimita il carattere.

layoutRect

Rectangle

Oggetto Rectangle che rappresenta il rettangolo che delimita il testo.

format

StringFormat

Oggetto StringFormat che specifica le informazioni di formattazione del testo, ad esempio l'interlinea e l'allineamento.

Esempio

Per un esempio, vedere AddString(String, FontFamily, Int32, Single, Point, StringFormat).

AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)

Origine:

GraphicsPath.cs

Aggiunge una stringa di testo a questo percorso.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::RectangleF layoutRect, System::Drawing::StringFormat ^ format);

public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.RectangleF layoutRect, System.Drawing.StringFormat? format);

member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit

Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, layoutRect As RectangleF, format As StringFormat)

Parametri

s

String

String da aggiungere.

family

FontFamily

Oggetto FontFamily che rappresenta il nome del tipo di carattere con cui viene disegnato il test.

style

Int32

Enumerazione FontStyle che rappresenta informazioni di stile sul testo (grassetto, corsivo e così via). È necessario eseguire il cast come numero intero (vedere il codice di esempio più avanti in questa sezione).

emSize

Single

Altezza della casella quadrata em che delimita il carattere.

layoutRect

RectangleF

Oggetto RectangleF che rappresenta il rettangolo che delimita il testo.

format

StringFormat

Oggetto StringFormat che specifica le informazioni di formattazione del testo, ad esempio l'interlinea e l'allineamento.

Esempio

Per un esempio, vedere AddString(String, FontFamily, Int32, Single, Point, StringFormat).