CheckedListBox.SelectionMode プロパティ

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

CheckedListBox.SelectionMode プロパティ

選択モードを指定している値を取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 SelectionMode As SelectionMode

Visual Basic (使用法)

Dim instance As CheckedListBox
Dim value As SelectionMode

value = instance.SelectionMode

instance.SelectionMode = value

C#

public override SelectionMode SelectionMode { get;
 set; }

C++

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

J#

/** @property */
public SelectionMode get_SelectionMode ()

/** @property */
public void set_SelectionMode (SelectionMode
 value)

JScript

public override function get
 SelectionMode () : SelectionMode

public override function set
 SelectionMode (value : SelectionMode)

プロパティ値
System.Windows.Forms.SelectionMode の One または None のいずれかの値。

例外

例外の種類	条件
ArgumentException	One または None 以外の System.Windows.Forms.SelectionMode の値を割り当てようとしました。
InvalidEnumArgumentException	System.Windows.Forms.SelectionMode の MultiExtended の値をコントロールに割り当てようとしました。

解説

CheckedListBox オブジェクトについては、複数選択はサポートされていません。モードを設定する項目が 1 つあるか 1 つもないかのいずれかです。

使用例

CheckOnClick プロパティ、SelectionMode プロパティ、および ThreeDCheckBoxes プロパティを設定して CheckedListBox コントロールを初期化するコード例を次に示します。このコードは、CheckedListBox にコントロールを読み込み、DisplayMember にコントロールの Control.Name プロパティを設定します。

この例を実行するには、CheckedListBox1 という名前の CheckedListBox オブジェクトが配置されているフォームに次のコードを貼り付けて、フォームのコンストラクタまたは Load メソッドから InitializeCheckListBox メソッドを呼び出します。

C#

// This method initializes CheckedListBox1 with a list of all 
// the controls on the form. It sets the selection mode
// to single selection and allows selection with a single click.
// It adds itself to the list before adding itself to the form.

internal System.Windows.Forms.CheckedListBox CheckedListBox1;

private void InitializeCheckedListBox()
{
    this.CheckedListBox1 = new CheckedListBox();
    this.CheckedListBox1.Location = new System.Drawing.Point(40,
 90);
    this.CheckedListBox1.CheckOnClick = true;
    this.CheckedListBox1.Name = "CheckedListBox1";
    this.CheckedListBox1.Size = new System.Drawing.Size(120,
 94);
    this.CheckedListBox1.TabIndex = 1;
    this.CheckedListBox1.SelectionMode = SelectionMode.One;
    this.CheckedListBox1.ThreeDCheckBoxes = true;

    foreach ( Control aControl in this.Controls
 )
    {
        this.CheckedListBox1.Items.Add(aControl, false);
    }

    this.CheckedListBox1.DisplayMember = "Name";
    this.CheckedListBox1.Items.Add(CheckedListBox1);
    this.Controls.Add(this.CheckedListBox1);
}

C++

   // This method initializes CheckedListBox1 with a list of all 
   // the controls on the form. It sets the selection mode
   // to single selection and allows selection with a single click.
   // It adds itself to the list before adding itself to the form.
internal:
   System::Windows::Forms::CheckedListBox^ CheckedListBox1;

private:
   void InitializeCheckedListBox()
   {
      this->CheckedListBox1 = gcnew CheckedListBox;
      this->CheckedListBox1->Location = System::Drawing::Point(
 40, 90 );
      this->CheckedListBox1->CheckOnClick = true;
      this->CheckedListBox1->Name = "CheckedListBox1";
      this->CheckedListBox1->Size = System::Drawing::Size(
 120, 94 );
      this->CheckedListBox1->TabIndex = 1;
      this->CheckedListBox1->SelectionMode = SelectionMode::One;
      this->CheckedListBox1->ThreeDCheckBoxes = true;
      System::Collections::IEnumerator^ myEnum = this->Controls->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Control^ aControl = safe_cast<Control^>(myEnum->Current);
         this->CheckedListBox1->Items->Add( aControl,
 false );
      }

      this->CheckedListBox1->DisplayMember = "Name";
      this->CheckedListBox1->Items->Add( CheckedListBox1
 );
      this->Controls->Add( this->CheckedListBox1
 );
   }

プラットフォーム

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

参照

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