RichTextBox.SelectionCharOffset Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

RichTextBox.cs

Obtient ou définit si le texte du contrôle apparaît sur la base de référence, en tant qu’exposant ou en tant qu’indice sous la ligne de base.

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

Valeur de propriété

Int32

Nombre qui spécifie le décalage de caractère.

Attributs

BrowsableAttribute

Exceptions

ArgumentException

La valeur spécifiée était inférieure à -2000 ou supérieure à 2000.

Exemples

L’exemple de code suivant montre comment spécifier du texte exposant et indice dans la propriété à l’aide RichTextBox de la SelectionCharOffset propriété. Cet exemple nécessite qu’un RichTextBox contrôle nommé richTextBox1ait été ajouté au formulaire.

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

Remarques

La valeur de cette propriété doit être comprise entre -2000 et 2000.

Si cette propriété est définie sur zéro, le texte apparaît sur la ligne de base. S’il s’agit d’un nombre positif, le nombre spécifie le nombre de pixels par lesquels élever la sélection de texte au-dessus de la ligne de base. S’il s’agit d’un nombre négatif, ce nombre spécifie le nombre de pixels par lequel subscripteur la sélection de texte. Vous pouvez utiliser cette propriété pour spécifier du texte en exposant ou en indice.

Si aucun texte n’est sélectionné, le décalage est appliqué au point d’insertion actuel et à tout le texte que l’utilisateur tape après le point d’insertion. Le décalage de caractères s’applique jusqu’à ce que la propriété soit remplacée par une valeur différente ou jusqu’à ce que le point d’insertion soit déplacé vers une autre section du contrôle.

Si le texte est sélectionné dans le contrôle, le texte sélectionné et tout texte entré après la sélection de texte aura la valeur de cette propriété. Vous pouvez utiliser cette propriété pour créer du texte exposant et indice pour des applications telles que des expressions mathématiques.