RichTextBox.SelectionProtected プロパティ

定義

現在選択されているテキストが保護されているかどうかを示す値を取得または設定します。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; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectionProtected : bool with get, set
Public Property SelectionProtected As Boolean

プロパティ値

Boolean

現在の選択内容に対して変更を行うことができない場合は true。それ以外の場合は falsetrue if the current selection prevents any changes to its content; otherwise, false. 既定値は、false です。The default is false.

属性

プロパティを使用して、で保護されたテキストを指定する方法を次のコード例に示し RichTextBox SelectionProtected ます。The following code example demonstrates how to specify protected text within the RichTextBox using the SelectionProtected property. この例では RichTextBox 、という名前のコントロールが richTextBox1 フォームに追加されていること、および "RichTextBox" という 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

注釈

現在テキストが選択されていない場合は、挿入ポイントが表示されている段落と、挿入ポイントの後にコントロールに入力されたすべてのテキストに保護設定が適用されます。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. 保護の設定は、プロパティが別の値に変更されるか、挿入ポイントがコントロール内の別の段落に移動されるまで適用されます。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.

コントロール内でテキストが選択されている場合、選択したテキストとテキストの選択後に入力したテキストには、このプロパティの値が適用されます。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. このプロパティを使用すると、ユーザーがコントロール内のテキストのセクションを変更できないようにすることができます。You can use this property to prevent the user from modifying sections of text within the control.

このプロパティがに設定されている場合、 true Protected ユーザーが現在のテキスト選択を変更しようとすると、イベントが発生します。If this property is set to true, the Protected event is raised when the user attempts to change the current text selection.

注意

このプロパティは true 、コントロール内の選択範囲全体に保護されたコンテンツが含まれている場合にのみ、を返します。This property will return true only if the entire selection within the control contains protected content.

適用対象

こちらもご覧ください