Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TextBoxBase.SelectionStart propriété

 

Date de publication : novembre 2016

Obtient ou définit le point de départ du texte sélectionné dans la zone de texte.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public int SelectionStart { get; set; }

Valeur de propriété

Type: System.Int32

Position de départ du texte sélectionné dans la zone de texte.

Exception Condition
ArgumentOutOfRangeException

La valeur assignée est inférieure à zéro.

Si aucun texte n’est sélectionné dans le contrôle, cette propriété indique le point d’insertion, ou signe insertion, pour le nouveau texte. Si vous définissez cette propriété sur un emplacement au-delà de la longueur du texte dans le contrôle, la position de début de sélection sera placée après le dernier caractère. Lorsque le texte est sélectionné dans le contrôle de zone de texte, la modification de cette propriété peut diminuer la valeur de la SelectionLength propriété. Si le reste du texte dans le contrôle après la position indiquée par le SelectionStart propriété est inférieure à la valeur de la SelectionLength propriété, la valeur de la SelectionLength propriété est automatiquement diminuée. La valeur de la SelectionStart propriété ne provoque jamais une augmentation dans le SelectionLength propriété.

Vous pouvez déplacer par programme la sélection dans la zone de texte en définissant le SelectionStart et le SelectionLength Propriétés.

Vous pouvez déplacer par programme le signe insertion dans la zone de texte en définissant le SelectionStart à la position dans la zone de texte où vous souhaitez le signe insertion pour atteindre et définir le SelectionLength propriété à une valeur de zéro (0).

Le TextBox doit avoir le focus pour la sélection ou le signe insertion puisse être déplacé. Vous pouvez définir le SelectionStart propriété d’un TextBox qui est ReadOnly en lui attribuant le Focus première.

Exemple 1

Le code suivant utilise des exemple TextBox, une classe dérivée. Il fournit Click gestionnaires d’événements pour MenuItem objets capables de couper, copier, coller et opérations d’annulation. Cet exemple suppose qu’un TextBox contrôle nommé textBox1 a été créé.

private void Menu_Copy(System.Object sender, System.EventArgs e)
 {
    // Ensure that text is selected in the text box.   
    if(textBox1.SelectionLength > 0)
        // Copy the selected text to the Clipboard.
        textBox1.Copy();
 }

 private void Menu_Cut(System.Object sender, System.EventArgs e)
 {   
     // Ensure that text is currently selected in the text box.   
     if(textBox1.SelectedText != "")
        // Cut the selected text in the control and paste it into the Clipboard.
        textBox1.Cut();
 }

 private void Menu_Paste(System.Object sender, System.EventArgs e)
 {
    // Determine if there is any text in the Clipboard to paste into the text box.
    if(Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) == true)
    {
        // Determine if any text is selected in the text box.
        if(textBox1.SelectionLength > 0)
        {
          // Ask user if they want to paste over currently selected text.
          if(MessageBox.Show("Do you want to paste over current selection?", "Cut Example", MessageBoxButtons.YesNo) == DialogResult.No)
             // Move selection to the point after the current selection and paste.
             textBox1.SelectionStart = textBox1.SelectionStart + textBox1.SelectionLength;
        }
        // Paste current text in Clipboard into text box.
        textBox1.Paste();
    }
 }


 private void Menu_Undo(System.Object sender, System.EventArgs e)
 {
    // Determine if last operation can be undone in text box.   
    if(textBox1.CanUndo == true)
    {
       // Undo the last operation.
       textBox1.Undo();
       // Clear the undo buffer to prevent last action from being redone.
       textBox1.ClearUndo();
    }
 }

Exemple 2

L’exemple suivant définit le SelectionStart propriété d’un TextBox qui est ReadOnly en lui attribuant le Focus première.

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        this.button1.Click += new System.EventHandler(this.ButtonClickWork);
    }

    private void ButtonClickWork(object sender, EventArgs e)
    {
        this.textBox1.Text = "Hello world!";
        this.textBox1.ReadOnly = true;

        this.textBox1.Focus();
        this.textBox1.SelectionStart = this.textBox1.SelectionStart + 1;
        this.textBox1.SelectionLength = 1;
    }
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: