CheckedListBox.GetItemCheckState(Int32) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

CheckedListBox.cs

Restituisce un valore che indica lo stato di controllo dell'elemento corrente.

public:
 System::Windows::Forms::CheckState GetItemCheckState(int index);

public System.Windows.Forms.CheckState GetItemCheckState(int index);

member this.GetItemCheckState : int -> System.Windows.Forms.CheckState

Public Function GetItemCheckState (index As Integer) As CheckState

Parametri

index

Int32

Indice dell'elemento di cui ottenere il valore selezionato.

Restituisce

CheckState

Uno dei CheckState valori.

Eccezioni

ArgumentOutOfRangeException

L'oggetto index specificato è minore di zero.

oppure

L'oggetto index specificato è maggiore o uguale al numero di elementi nell'elenco.

Esempio

Nell'esempio seguente vengono enumerati gli elementi selezionati in CheckedListBox.CheckedIndexCollection per verificare lo stato di controllo in cui si trova un elemento. Nell'esempio viene illustrato l'utilizzo del GetItemCheckState metodo per impostare lo stato di controllo di un elemento. Nell'esempio viene inoltre illustrato l'utilizzo della CheckedIndices proprietà per ottenere CheckedListBox.CheckedIndexCollection e la CheckedItems proprietà per ottenere l'oggetto CheckedListBox.CheckedItemCollection.

Il primo ciclo usa il GetItemCheckState metodo per ottenere l'oggetto CheckState di ogni elemento selezionato, in base all'indice dell'elemento. Il secondo ciclo usa GetItemCheckStateanche , ma usa il ListBox.ObjectCollection.IndexOf metodo per recuperare l'indice per l'elemento.

void WhatIsChecked_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Display in a message box all the items that are checked.
   // First show the index and check state of all selected items.
   IEnumerator^ myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      Int32 indexChecked =  *safe_cast<Int32^>(myEnum1->Current);
      
      // The indexChecked variable contains the index of the item.
      MessageBox::Show( String::Concat( "Index#: ", indexChecked, ", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( indexChecked ), "." ) );
   }

   
   // Next show the Object* title and check state for each item selected.
   IEnumerator^ myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      Object^ itemChecked = safe_cast<Object^>(myEnum2->Current);
      
      // Use the IndexOf method to get the index of an item.
      MessageBox::Show( String::Concat( "Item with title: \"", itemChecked, "\", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( checkedListBox1->Items->IndexOf( itemChecked ) ), "." ) );
   }
}

private void WhatIsChecked_Click(object sender, System.EventArgs e) {
    // Display in a message box all the items that are checked.

    // First show the index and check state of all selected items.
    foreach(int indexChecked in checkedListBox1.CheckedIndices) {
        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" +
                        checkedListBox1.GetItemCheckState(indexChecked).ToString() + ".");
    }

    // Next show the object title and check state for each item selected.
    foreach(object itemChecked in checkedListBox1.CheckedItems) {

        // Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: \"" + itemChecked.ToString() +
                        "\", is checked. Checked state is: " +
                        checkedListBox1.GetItemCheckState(checkedListBox1.Items.IndexOf(itemChecked)).ToString() + ".");
    }
}

Private Sub WhatIsChecked_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles WhatIsChecked.Click
    ' Display in a message box all the items that are checked.
    Dim indexChecked As Integer
    Dim itemChecked As Object
    Const quote As String = """"

    ' First show the index and check state of all selected items.
    For Each indexChecked In CheckedListBox1.CheckedIndices
        ' The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" + _
                        CheckedListBox1.GetItemCheckState(indexChecked).ToString() + ".")
    Next

    ' Next show the object title and check state for each item selected.
    For Each itemChecked In CheckedListBox1.CheckedItems

        ' Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: " + quote + itemChecked.ToString() + quote + _
                        ", is checked. Checked state is: " + _
                        CheckedListBox1.GetItemCheckState(CheckedListBox1.Items.IndexOf(itemChecked)).ToString() + ".")
    Next

End Sub

Commenti

Il GetItemCheckState metodo consente di ottenere il CheckState valore di un elemento, dato l'indice. Se non si imposta mai lo stato di controllo di un elemento su Indeterminate, usare il GetItemChecked metodo .

Vedi anche

• GetItemChecked(Int32)
• CheckState