RichTextBox.SelectionProtected プロパティ

.NET Framework クラス ライブラリ リファレンス

RichTextBox.SelectionProtected プロパティ

現在選択されているテキストが保護されているかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property SelectionProtected As
 Boolean

Visual Basic (使用法)

Dim instance As RichTextBox
Dim value As Boolean

value = instance.SelectionProtected

instance.SelectionProtected = value

C#

public bool SelectionProtected { get;
 set; }

C++

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

J#

/** @property */
public boolean get_SelectionProtected ()

/** @property */
public void set_SelectionProtected (boolean
 value)

JScript

public function get SelectionProtected
 () : boolean

public function set SelectionProtected
 (value : boolean)

プロパティ値
現在の選択内容に対して変更を行うことができない場合は true。それ以外の場合は false。既定値は false です。

解説

テキストが現在選択されていない場合、テキスト保護の設定は、カーソルがある段落と、カーソル位置以降にコントロールに入力されるすべてのテキストに適用されます。プロパティの値が変更されるまで、またはカーソル位置をコントロール内の別の段落に移動するまでの間は、このテキスト保護の設定が適用されます。

コントロール内でテキストが選択されている場合は、選択されているテキスト、およびテキストを選択した後に入力したすべてのテキストに対して、このプロパティの値が適用されます。このプロパティを使用して、コントロール内のテキスト部分をユーザーが変更できないように設定できます。

このプロパティが true に設定されている場合、現在選択されているテキストをユーザーが変更しようとすると Protected イベントが発生します。

メモ
このプロパティは、コントロール内で選択されている内容の中に、保護された内容が含まれる場合だけ true を返します。

使用例

SelectionProtected プロパティを使用して、RichTextBox 内で保護されるテキストを指定する方法を次のコード例に示します。この例では、richTextBox1 という名前の RichTextBox コントロールがフォームに追加されており、その RichTextBox コントロールに "RichTextBox" という単語が含まれるテキストが追加されている必要があります。

Visual Basic

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

C#

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;
}

C++

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;
   }

J#

private void ProtectMySelectedText()
{
    // Determine if the selected text in the control contains the word
 
    //"RichTextBox".
    if (richTextBox1.get_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.set_SelectionProtected(true);
} //ProtectMySelectedText

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
RichTextBox クラス
RichTextBox メンバ
System.Windows.Forms 名前空間
Protected