RichTextBox.SelectionCharOffset Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft ab, ob der Text im Steuerelement auf der Baseline, hochgestellt oder tiefergestellt unterhalb der Basislinie angezeigt wird, oder legt diesen fest.

public:
 property int SelectionCharOffset { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public int SelectionCharOffset { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectionCharOffset : int with get, set

Public Property SelectionCharOffset As Integer

Eigenschaftswert

Int32

Eine Zahl, die den Zeichenversatz angibt.

Attribute

BrowsableAttribute

Ausnahmen

ArgumentException

Der angegebene Wert ist kleiner als -2000 oder größer als 2000.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Hoch- und Tiefgestellter Text in der Verwendung der RichTextBox SelectionCharOffset Eigenschaft angegeben wird. In diesem Beispiel ist erforderlich, dass dem Formular ein RichTextBox Steuerelement mit dem Namen richTextBox1"" hinzugefügt wurde.

private:
   void WriteOffsetTextToRichTextBox()
   {
      // Clear all text from the RichTextBox.
      richTextBox1->Clear();

      // Set the font for the text.
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Lucinda Console",12 );

      // Set the foreground color of the text.
      richTextBox1->SelectionColor = Color::Purple;

      // Set the baseline text.
      richTextBox1->SelectedText = "10";

      // Set the CharOffset to display superscript text.
      richTextBox1->SelectionCharOffset = 10;

      // Set the superscripted text. 
      richTextBox1->SelectedText = "2";

      // Reset the CharOffset to display text at the baseline.
      richTextBox1->SelectionCharOffset = 0;
      richTextBox1->AppendText( "\n\n" );

      // Change the forecolor of the next text selection.
      richTextBox1->SelectionColor = Color::Blue;

      // Set the baseline text.
      richTextBox1->SelectedText = "77";

      // Set the CharOffset to display subscript text.
      richTextBox1->SelectionCharOffset = -10;

      // Set the subscripted text.  
      richTextBox1->SelectedText = "3";

      // Reset the CharOffset to display text at the baseline.
      richTextBox1->SelectionCharOffset = 0;
   }

private void WriteOffsetTextToRichTextBox()
{
    // Clear all text from the RichTextBox.
    richTextBox1.Clear();
    // Set the font for the text.
    richTextBox1.SelectionFont = new Font("Lucinda Console", 12);
    // Set the foreground color of the text.
    richTextBox1.SelectionColor = Color.Purple;
    // Set the baseline text.
    richTextBox1.SelectedText = "10";
    // Set the CharOffset to display superscript text.
    richTextBox1.SelectionCharOffset = 10;
    // Set the superscripted text.	
    richTextBox1.SelectedText = "2";
    // Reset the CharOffset to display text at the baseline.
    richTextBox1.SelectionCharOffset = 0;
    richTextBox1.AppendText("\n\n");
    // Change the forecolor of the next text selection.
    richTextBox1.SelectionColor = Color.Blue;
    // Set the baseline text.
    richTextBox1.SelectedText = "77";
    // Set the CharOffset to display subscript text.
    richTextBox1.SelectionCharOffset = -10;
    // Set the subscripted text.  
    richTextBox1.SelectedText = "3";
    // Reset the CharOffset to display text at the baseline.
    richTextBox1.SelectionCharOffset = 0; 
}

Private Sub WriteOffsetTextToRichTextBox()
   ' Clear all text from the RichTextBox.
   RichTextBox1.Clear()
   ' Set the font for the text.
   RichTextBox1.SelectionFont = New Font("Lucinda Console", 12)
   ' Set the foreground color of the text.
   RichTextBox1.SelectionColor = Color.Purple
   ' Set the baseline text.
   RichTextBox1.SelectedText = "10"
   ' Set the CharOffset to display superscript text.
   RichTextBox1.SelectionCharOffset = 10
   ' Set the superscripted text.	
   RichTextBox1.SelectedText = "2"
   ' Reset the CharOffset to display text at the baseline.
   RichTextBox1.SelectionCharOffset = 0
   RichTextBox1.SelectedText = ControlChars.CrLf + ControlChars.CrLf
   ' Change the forecolor of the next text selection.
   RichTextBox1.SelectionColor = Color.Blue
   ' Set the baseline text.
   RichTextBox1.SelectedText = "777"
   ' Set the CharOffset to display subscript text.
   RichTextBox1.SelectionCharOffset = -10
   ' Set the subscripted text.  
   RichTextBox1.SelectedText = "3"
   ' Reset the CharOffset to display text at the baseline.
   RichTextBox1.SelectionCharOffset = 0
End Sub

Hinweise

Der Wert dieser Eigenschaft muss zwischen -2000 und 2000 sein.

Wenn diese Eigenschaft auf Null festgelegt ist, wird der Text in der Basislinie angezeigt. Wenn es sich um eine positive Zahl handelt, gibt die Zahl die Anzahl von Pixeln an, um die Textauswahl oberhalb der Basislinie zu erhöhen. Wenn es sich um eine negative Zahl handelt, gibt diese Zahl die Anzahl der Pixel an, um die die Textauswahl tiefgestellt werden soll. Sie können diese Eigenschaft verwenden, um Text als hochgestellt oder tiefgestellt anzugeben.

Wenn kein Text ausgewählt ist, wird der Offset auf die aktuelle Einfügemarke und auf den gesamten Text angewendet, den der Benutzer nach der Einfügemarke eingibt. Der Zeichenversatz gilt, bis die Eigenschaft in einen anderen Wert geändert wird oder bis die Einfügemarke in einen anderen Abschnitt innerhalb des Steuerelements verschoben wird.

Wenn Text innerhalb des Steuerelements ausgewählt ist, hat der markierte Text und jeder Text, der nach der Textauswahl eingegeben wurde, den Wert dieser Eigenschaft darauf angewendet. Sie können diese Eigenschaft verwenden, um hochgestellten und tiefgestellten Text für anwendungen wie mathematische Ausdrücke zu erstellen.