RichTextBox.SelectionProtected 属性

定义

获取或设置一个值,通过该值指示是否保护当前选定文本。

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

属性值

如果禁止更改当前选择的任何内容,则为 true;否则为 false。 默认值为 false

属性

示例

下面的代码示例演示如何使用 SelectionProtected 属性在 中RichTextBox指定受保护的文本。 此示例要求 RichTextBox 已将名为 richTextBox1的控件添加到窗体中,并且该 RichTextBox 控件添加了包含单词“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

注解

如果当前未选择任何文本,则保护设置将应用于显示插入点的段落以及插入点后键入控件的所有文本。 保护设置将一直应用,直到 属性更改为其他值,或者直到插入点移动到控件中的另一个段落。

如果在控件中选择了文本,则所选文本和在文本选择后输入的任何文本都将应用此属性的值。 可以使用此属性来防止用户修改控件中的文本部分。

如果此属性设置为 true,则 Protected 当用户尝试更改当前文本选择时,将引发 事件。

注意

仅当控件中的整个选定内容包含受保护的内容时,此属性才会返回 true

适用于

另请参阅