RichTextBox.SelectionProtected Propriété

Définition

Obtient ou définit une valeur indiquant si la sélection de texte actuelle est protégée.Gets or sets a value indicating whether the current text selection is protected.

public:
 property bool SelectionProtected { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool SelectionProtected { get; set; }
member this.SelectionProtected : bool with get, set
Public Property SelectionProtected As Boolean

Valeur de propriété

true si la sélection actuelle empêche toute modification de son contenu ; sinon, false.true if the current selection prevents any changes to its content; otherwise, false. La valeur par défaut est false.The default is false.

Attributs

Exemples

L’exemple de code suivant montre comment spécifier du texte protégé dans le RichTextBox à l’aide de la propriété SelectionProtected.The following code example demonstrates how to specify protected text within the RichTextBox using the SelectionProtected property. Cet exemple requiert qu’un contrôle RichTextBox, nommé richTextBox1, ait été ajouté au formulaire et que du texte soit ajouté au contrôle RichTextBox qui contient le mot « RichTextBox ».This example requires that a RichTextBox control, named richTextBox1, has been added to the form and that the RichTextBox control has text added to it that contains the word "RichTextBox."

private:
   void ProtectMySelectedText()
   {
      // Determine if the selected text in the control contains the word "RichTextBox".
      if (  !richTextBox1->SelectedText->Equals( "RichTextBox" ) )
      {
         // Search for the word RichTextBox in the control.
         if ( richTextBox1->Find( "RichTextBox", RichTextBoxFinds::WholeWord ) == -1 )
         {
            //Alert the user that the word was not foun and return.
            MessageBox::Show( "The text \"RichTextBox\" was not found!" );
            return;
         }
      }

      // Protect the selected text in the control from being altered.
      richTextBox1->SelectionProtected = true;
   }
private void ProtectMySelectedText()
{
   // Determine if the selected text in the control contains the word "RichTextBox".
   if(richTextBox1.SelectedText != "RichTextBox")
   {
      // Search for the word RichTextBox in the control.
      if(richTextBox1.Find("RichTextBox",RichTextBoxFinds.WholeWord)== -1)
      {
         //Alert the user that the word was not foun and return.
         MessageBox.Show("The text \"RichTextBox\" was not found!");
         return;
      }
   }
   // Protect the selected text in the control from being altered.
   richTextBox1.SelectionProtected = true;
}
Private Sub ProtectMySelectedText()
   ' Determine if the selected text in the control contains the word "RichTextBox".
   If richTextBox1.SelectedText <> "RichTextBox" Then
      ' Search for the word RichTextBox in the control.
      If richTextBox1.Find("RichTextBox", RichTextBoxFinds.WholeWord) = -1 Then
         'Alert the user that the word was not foun and return.
         MessageBox.Show("The text ""RichTextBox"" was not found!")
         Return
      End If
   End If
   ' Protect the selected text in the control from being altered.
   richTextBox1.SelectionProtected = True
End Sub

Remarques

Si aucun texte n’est actuellement sélectionné, le paramètre de protection est appliqué au paragraphe dans lequel le point d’insertion apparaît et à tout le texte tapé dans le contrôle après le point d’insertion.If no text is currently selected, the protection setting is applied to the paragraph in which the insertion point appears and to all text that is typed into the control after the insertion point. Le paramètre de protection s’applique jusqu’à ce que la propriété soit remplacée par une autre valeur ou que le point d’insertion soit déplacé vers un autre paragraphe dans le contrôle.The protection setting applies until the property is changed to a different value or until the insertion point is moved to a different paragraph within the control.

Si du texte est sélectionné dans le contrôle, la valeur de cette propriété est appliquée au texte sélectionné et au texte entré après la sélection de texte.If text is selected within the control, the selected text and any text entered after the text selection will have the value of this property applied to it. Vous pouvez utiliser cette propriété pour empêcher l’utilisateur de modifier des sections de texte dans le contrôle.You can use this property to prevent the user from modifying sections of text within the control.

Si cette propriété a la valeur true, l’événement Protected est déclenché lorsque l’utilisateur tente de modifier la sélection de texte actuelle.If this property is set to true, the Protected event is raised when the user attempts to change the current text selection.

Notes

Cette propriété retourne true uniquement si l’ensemble de la sélection dans le contrôle contient du contenu protégé.This property will return true only if the entire selection within the control contains protected content.

S’applique à

Voir aussi