RichTextBox.SelectionProtected Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se la selezione di testo corrente è protetta.

public:
 property bool SelectionProtected { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(false)]
public bool SelectionProtected { get; set; }

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

Public Property SelectionProtected As Boolean

Valore della proprietà

Boolean

true se non è consentito apportare modifiche ai contenuti della selezione corrente; in caso contrario, false. Il valore predefinito è false.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come specificare il testo protetto all'interno della RichTextBoxSelectionProtected proprietà . In questo esempio è necessario che un RichTextBox controllo, denominato richTextBox1, sia stato aggiunto al modulo e che il RichTextBox controllo abbia aggiunto il testo che contiene la parola "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

Commenti

Se non è attualmente selezionato alcun testo, l'impostazione di protezione viene applicata al paragrafo in cui viene visualizzato il punto di inserimento e a tutto il testo digitato nel controllo dopo il punto di inserimento. L'impostazione di protezione si applica fino a quando la proprietà non viene modificata in un valore diverso o fino a quando il punto di inserimento non viene spostato in un paragrafo diverso all'interno del controllo.

Se il testo è selezionato all'interno del controllo, il testo selezionato e qualsiasi testo immesso dopo la selezione del testo avrà il valore di questa proprietà applicata. È possibile usare questa proprietà per impedire all'utente di modificare le sezioni di testo all'interno del controllo.

Se questa proprietà è impostata su true, l'evento Protected viene generato quando l'utente tenta di modificare la selezione del testo corrente.

Nota

Questa proprietà restituirà true solo se l'intera selezione all'interno del controllo contiene contenuto protetto.

Vedi anche

• Protected