RichTextBox.SelectionLength プロパティ

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

RichTextBox.SelectionLength プロパティ

コントロール内で選択されている文字の数を取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 SelectionLength As Integer

Visual Basic (使用法)

Dim instance As RichTextBox
Dim value As Integer

value = instance.SelectionLength

instance.SelectionLength = value

C#

public override int SelectionLength { get;
 set; }

C++

public:
virtual property int SelectionLength {
    int get () override;
    void set (int value)
 override;
}

J#

/** @property */
public int get_SelectionLength ()

/** @property */
public void set_SelectionLength (int
 value)

JScript

public override function get
 SelectionLength () : int

public override function set
 SelectionLength (value : int)

プロパティ値
テキスト ボックス内で選択されている文字の数。

解説

このプロパティを使用すると、選択されたテキストに対して操作を実行する前に、テキスト ボックス コントロールで文字が選択されているかどうかを判断できます。また、このプロパティを使用して、for ループ内の単一文字タスクを実行するときに、選択されている文字の合計数 (空白も含む) も判断できます。

使用例

SelectionLength プロパティを使用して、RichTextBox 内でテキストが選択されているかどうかを確認する方法を次のコード例に示します。この例では、richTextBox1 という名前の RichTextBox コントロールがフォームに追加されている必要があります。また、コントロールで選択されているテキストが richTextBox1 に含まれている必要もあります。

Visual Basic

Private Sub WriteTextToRichTextBox()
   ' Clear all text from the RichTextBox;
   richTextBox1.Clear()
   ' Set the font for the opening text to a larger Arial font;
   richTextBox1.SelectionFont = New Font("Arial",
 16)
   ' Assign the introduction text to the RichTextBox control.
   RichTextBox1.SelectedText = "The following is a list of bulleted
 items:" + ControlChars.Cr
   ' Set the Font for the first item to a smaller size Arial font.
   richTextBox1.SelectionFont = New Font("Arial",
 12)
   ' Specify that the following items are to be added to a bulleted
 list.
   richTextBox1.SelectionBullet = True
   ' Set the color of the item text.
   richTextBox1.SelectionColor = Color.Red
   ' Assign the text to the bulleted item.
   richTextBox1.SelectedText = "Apples" + ControlChars.Cr
   ' Apply same font since font settings do not carry to next line.
   richTextBox1.SelectionFont = New Font("Arial",
 12)
   richTextBox1.SelectionColor = Color.Orange
   richTextBox1.SelectedText = "Oranges" + ControlChars.Cr
   richTextBox1.SelectionFont = New Font("Arial",
 12)
   richTextBox1.SelectionColor = Color.Purple
   richTextBox1.SelectedText = "Grapes" + ControlChars.Cr
   ' End the bulleted list.
   richTextBox1.SelectionBullet = False
   ' Specify the font size and string for text displayed below bulleted
 list.
   richTextBox1.SelectionFont = New Font("Arial",
 16)
   richTextBox1.SelectedText = "Bulleted Text Complete!"
End Sub

C#

private void ModifySelectedText()
{
   // Determine if text is selected in the control.
   if (richTextBox1.SelectionLength > 0)
   {
      // Set the color of the selected text in the control.
      richTextBox1.SelectionColor = Color.Red;
      // Set the font of the selected text to bold and underlined.
      richTextBox1.SelectionFont = new Font("Arial",10,FontStyle.Bold
 | FontStyle.Underline);
      // Protect the selected text from modification.
      richTextBox1.SelectionProtected = true;
   }
}

C++

private:
   void ModifySelectedText()
   {
      // Determine if text is selected in the control.
      if ( richTextBox1->SelectionLength > 0 )
      {
         // Set the color of the selected text in the control.
         richTextBox1->SelectionColor = Color::Red;

         // Set the font of the selected text to bold and underlined.
         richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",10,static_cast<FontStyle>(FontStyle::Bold
 | FontStyle::Underline) );

         // Protect the selected text from modification.
         richTextBox1->SelectionProtected = true;
      }
   }

J#

private void ModifySelectedText()
{
    // Determine if text is selected in the control.
    if (richTextBox1.get_SelectionLength() > 0) {
        // Set the color of the selected text in the control.
        richTextBox1.set_SelectionColor(Color.get_Red());
        // Set the font of the selected text to bold and underlined.
        richTextBox1.set_SelectionFont(new Font("Arial",
 10, FontStyle.
            Bold | FontStyle.Underline));
        // Protect the selected text from modification.
        richTextBox1.set_SelectionProtected(true);
    }
} //ModifySelectedText

プラットフォーム

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 名前空間
SelectionStart
SelectedText