RichTextBox.SelectionProtected Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

RichTextBox.cs

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 la selezione corrente impedisce modifiche al relativo contenuto; 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 di RichTextBox utilizzando la SelectionProtected proprietà . In questo esempio è necessario che al form sia stato aggiunto un RichTextBox controllo denominato richTextBox1e che al RichTextBox controllo sia stato aggiunto testo contenente 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 viene selezionato all'interno del controllo, il testo selezionato e qualsiasi testo immesso dopo la selezione del testo avrà il valore di questa proprietà applicato. È possibile utilizzare questa proprietà per impedire all'utente di modificare 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.

Annotazioni

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

Vedi anche

• Protected