StringFormat.SetDigitSubstitution-Methode

Gibt die beim Ersetzen westlicher Ziffern durch lokale Ziffern zu verwendende Sprache und Methode an.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Sub SetDigitSubstitution ( _
    language As Integer, _
    substitute As StringDigitSubstitute _
)
'Usage
Dim instance As StringFormat
Dim language As Integer
Dim substitute As StringDigitSubstitute

instance.SetDigitSubstitution(language, substitute)

public void SetDigitSubstitution (
    int language,
    StringDigitSubstitute substitute
)

public:
void SetDigitSubstitution (
    int language, 
    StringDigitSubstitute substitute
)

public void SetDigitSubstitution (
    int language, 
    StringDigitSubstitute substitute
)

public function SetDigitSubstitution (
    language : int, 
    substitute : StringDigitSubstitute
)

Parameter

language
Ein NLS-Sprachbezeichner (National Language Support, Sprachunterstützung) für die Sprache, die beim Ersetzen westlicher Ziffern durch lokale Ziffern verwendet wird. Sie können die LCID-Eigenschaft eines CultureInfo-Objekts als NLS-Sprachbezeichner übergeben. Angenommen, Sie erstellen ein CultureInfo-Objekt, indem Sie die Zeichenfolge "ar-EG" an einen CultureInfo-Konstruktor übergeben. Wenn Sie die LCID-Eigenschaft dieses CultureInfo-Objekts zusammen mit Traditional an die SetDigitSubstitution-Methode übergeben, werden zum Zeitpunkt der Anzeige westliche Ziffern durch arabisch-indische Ziffern ersetzt.

substitute
Ein Element der StringDigitSubstitute-Enumeration, das angibt, wie Ziffern angezeigt werden.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Beispiel

Das folgende Beispiel ist für die Verwendung mit Windows Forms vorgesehen und erfordert PaintEventArgse, wobei es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

Legt für StringFormat die zu verwendende Sprache und das zu verwendende Ersetzungsverfahren fest.
Zeichnet die Zeichenfolge.
Wiederholt die beiden oben aufgeführten Schritte für zwei verschiedene Sprachen (Arabisch und Thai).

Die nationale Ersetzungsmethode und die traditionelle Ersetzungsmethode werden für beide Sprachen veranschaulicht. Bei der nationalen Methode werden die Ziffern entsprechend der offiziellen Landessprache des Gebietsschemas des Benutzers angezeigt. Bei der traditionellen Methode werden Ziffern entsprechend des Schriftsystems bzw. der Muttersprache des Benutzers angezeigt, die von der offiziellen Landessprache des Benutzers abweichen können.

Public Sub SetDigitSubExample(ByVal e As PaintEventArgs)
    Dim g As Graphics = e.Graphics
    Dim blueBrush As New SolidBrush(Color.FromArgb(255, 0, 0, 255))
    Dim myFont As New Font("Courier New", 12)
    Dim myStringFormat As New StringFormat
    Dim myString As String = "0 1 2 3 4 5 6 7 8 9"

    ' Arabic (0x0C01) digits.

    ' Use National substitution method.
    myStringFormat.SetDigitSubstitution(&HC01, _
    StringDigitSubstitute.National)
    g.DrawString("Arabic:" & ControlChars.Cr & _
    "Method of substitution = National:     " & myString, _
    myFont, blueBrush, New PointF(10.0F, 20.0F), myStringFormat)

    ' Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(&HC01, _
    StringDigitSubstitute.Traditional)
    g.DrawString("Method of substitution = Traditional:  " _
    & myString, myFont, blueBrush, New PointF(10.0F, 55.0F), _
    myStringFormat)

    ' Thai (0x041E) digits.

    ' Use National substitution method.
    myStringFormat.SetDigitSubstitution(&H41E, _
    StringDigitSubstitute.National)
    g.DrawString("Thai:" & ControlChars.Cr & _
    "Method of substitution = National:     " & myString, _
    myFont, blueBrush, New PointF(10.0F, 85.0F), myStringFormat)

    ' Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(&H41E, _
    StringDigitSubstitute.Traditional)
    g.DrawString("Method of substitution = Traditional:  " _
    & myString, myFont, blueBrush, New PointF(10.0F, 120.0F), _
    myStringFormat)
End Sub

public void SetDigitSubExample(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
    SolidBrush   blueBrush = new SolidBrush(Color.FromArgb(255, 0, 0, 255));
    Font         myFont = new Font("Courier New", 12);
    StringFormat myStringFormat = new StringFormat();
    string       myString = "0 1 2 3 4 5 6 7 8 9";
             
       
    // Arabic (0x0C01) digits.
             
    // Use National substitution method.
    myStringFormat.SetDigitSubstitution(0x0C01,
        StringDigitSubstitute.National);
    g.DrawString(
        "Arabic:\nMethod of substitution = National:     " + myString,
        myFont, blueBrush, new PointF(10.0f, 20.0f), myStringFormat);
             
    // Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(0x0C01,
        StringDigitSubstitute.Traditional);
    g.DrawString(
        "Method of substitution = Traditional:  " + myString,
        myFont, blueBrush, new PointF(10.0f, 55.0f), myStringFormat);
             
    // Thai (0x041E) digits.
   
    // Use National substitution method.
    myStringFormat.SetDigitSubstitution(0x041E,
        StringDigitSubstitute.National);
    g.DrawString(
        "Thai:\nMethod of substitution = National:     " + myString,
        myFont, blueBrush, new PointF(10.0f, 85.0f), myStringFormat);
             
    // Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(0x041E,
        StringDigitSubstitute.Traditional);
    g.DrawString(
        "Method of substitution = Traditional:  " + myString,
        myFont, blueBrush, new PointF(10.0f, 120.0f), myStringFormat);
}

public:
   void SetDigitSubExample( PaintEventArgs^ e )
   {
      Graphics^ g = e->Graphics;
      SolidBrush^ blueBrush = gcnew SolidBrush( Color::FromArgb( 255, 0, 0, 255 ) );
      System::Drawing::Font^ myFont = gcnew System::Drawing::Font( "Courier New",12 );
      StringFormat^ myStringFormat = gcnew StringFormat;
      String^ myString = "0 1 2 3 4 5 6 7 8 9";

      // Arabic (0x0C01) digits.
      // Use National substitution method.
      myStringFormat->SetDigitSubstitution( 0x0C01, StringDigitSubstitute::National );
      g->DrawString( String::Format( "Arabic:\nMethod of substitution = National:     {0}", myString ), myFont, blueBrush, PointF(10.0f,20.0f), myStringFormat );

      // Use Traditional substitution method.
      myStringFormat->SetDigitSubstitution( 0x0C01, StringDigitSubstitute::Traditional );
      g->DrawString( String::Format( "Method of substitution = Traditional:  {0}", myString ), myFont, blueBrush, PointF(10.0f,55.0f), myStringFormat );

      // Thai (0x041E) digits.
      // Use National substitution method.
      myStringFormat->SetDigitSubstitution( 0x041E, StringDigitSubstitute::National );
      g->DrawString( String::Format( "Thai:\nMethod of substitution = National:     {0}", myString ), myFont, blueBrush, PointF(10.0f,85.0f), myStringFormat );

      // Use Traditional substitution method.
      myStringFormat->SetDigitSubstitution( 0x041E, StringDigitSubstitute::Traditional );
      g->DrawString( String::Format( "Method of substitution = Traditional:  {0}", myString ), myFont, blueBrush, PointF(10.0f,120.0f), myStringFormat );
   }

public void SetDigitSubExample(PaintEventArgs e)
{
    Graphics g = e.get_Graphics();
    SolidBrush blueBrush = new SolidBrush(Color.FromArgb(255, 0, 0, 255));
    Font myFont = new Font("Courier New", 12);
    StringFormat myStringFormat = new StringFormat();
    String myString = "0 1 2 3 4 5 6 7 8 9";

    // Arabic (0x0C01) digits.
    // Use National substitution method.
    myStringFormat.SetDigitSubstitution(0xC01, 
        StringDigitSubstitute.National);
    g.DrawString("Arabic:\nMethod of substitution = National:     " 
        + myString, myFont, blueBrush, new PointF(10, 20), myStringFormat);

    // Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(0xC01, 
        StringDigitSubstitute.Traditional);
    g.DrawString("Method of substitution = Traditional:  " + myString, 
        myFont, blueBrush, new PointF(10, 55), myStringFormat);

    // Thai (0x041E) digits.
    // Use National substitution method.
    myStringFormat.SetDigitSubstitution(0x41E, 
        StringDigitSubstitute.National);
    g.DrawString("Thai:\nMethod of substitution = National:     " 
        + myString, myFont, blueBrush, new PointF(10, 85), myStringFormat);

    // Use Traditional substitution method.
    myStringFormat.SetDigitSubstitution(0x41E, 
        StringDigitSubstitute.Traditional);
    g.DrawString("Method of substitution = Traditional:  " + myString,
        myFont, blueBrush, new PointF(10, 120), myStringFormat);
} //SetDigitSubExample

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

StringFormat-Klasse
StringFormat-Member
System.Drawing-Namespace

Last updated on 2007-08-20

Freigeben über