CheckedListBox.DisplayMember Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

İçeriğini görüntülemek istediğiniz liste kutusunda bulunan nesnelerin bir özelliğini belirten bir dize alır veya ayarlar.

public:
 property System::String ^ DisplayMember { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string DisplayMember { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DisplayMember : string with get, set

Public Property DisplayMember As String

Özellik Değeri

String

Liste kutusunda bulunan nesnelerin bir özelliğinin adını belirten dize. Varsayılan değer, boş dizedir ("").

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, , SelectionModeve ThreeDCheckBoxes özelliklerini ayarlayarak bir CheckedListBox denetimi başlatmayı CheckOnClickgösterir. Örnek, öğesini CheckedListBox denetimlerle doldurur ve öğesini denetimin Control.Name özelliğine ayarlarDisplayMember.

Örneği çalıştırmak için, aşağıdaki kodu adlandırılmış CheckedListBox1 içeren bir CheckedListBox forma yapıştırın ve formun InitializeCheckListBox oluşturucusundan veya Load yönteminden yöntemini çağırın.

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

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

' 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.
Friend WithEvents CheckedListBox1 As System.Windows.Forms.CheckedListBox

Private Sub InitializeCheckedListBox()
    Me.CheckedListBox1 = New CheckedListBox
    Me.CheckedListBox1.Location = New System.Drawing.Point(40, 90)
    Me.CheckedListBox1.CheckOnClick = True
    Me.CheckedListBox1.Name = "CheckedListBox1"
    Me.CheckedListBox1.Size = New System.Drawing.Size(120, 94)
    Me.CheckedListBox1.TabIndex = 1
    Me.CheckedListBox1.SelectionMode = SelectionMode.One
    Me.CheckedListBox1.ThreeDCheckBoxes = True

    Dim aControl As Control
    For Each aControl In Me.Controls
        Me.CheckedListBox1.Items.Add(aControl, False)
    Next

    Me.CheckedListBox1.DisplayMember = "Name"
    Me.CheckedListBox1.Items.Add(CheckedListBox1)
    Me.Controls.Add(Me.CheckedListBox1)
End Sub

Açıklamalar

Varsayılan olarak, CheckedListBox içerdiği öğeler için varsayılan dizeyi görüntüler. Ancak, CheckedListBox çeşitli nesne türlerini görüntüleyebilir ve özelliğini belirterek görüntülenen dizeyi DisplayMember değiştirmek isteyebilirsiniz. Belirtilen özellik yoksa veya özelliğin DisplayMember değeri boş bir dizeyse (""), bunun yerine nesnenin ToString yönteminin sonuçları görüntülenir.

öğesinin yeni değeri ayarlanamıyorsa DisplayMember , önceki değer korunur.