Sdílet prostřednictvím


ListBox – přehled ovládacího prvku (Windows Forms)

Ovládací prvek Windows Forms ListBox zobrazí seznam, ze kterého může uživatel vybrat jednu nebo více položek. Pokud celkový počet položek překročí počet, který lze zobrazit, posuvník se automaticky přidá do ovládacího prvku ListBox. Pokud je vlastnost MultiColumn nastavena na true, zobrazí se v seznamu položky ve více sloupcích a zobrazí se vodorovný posuvník. Pokud je vlastnost MultiColumn nastavena na false, zobrazí se v seznamu položky v jednom sloupci a zobrazí se svislý posuvník. Pokud je ScrollAlwaysVisible nastavena na true, zobrazí se posuvník bez ohledu na počet položek. Vlastnost SelectionMode určuje, kolik položek seznamu lze vybrat najednou.

Způsoby změny ovládacího prvku ListBox

Vlastnost SelectedIndex vrátí celočíselnou hodnotu, která odpovídá první vybrané položce v seznamu. Vybranou položku můžete programově změnit změnou hodnoty SelectedIndex v kódu; odpovídající položka v seznamu se zobrazí zvýrazněná ve formuláři Windows Form. Pokud není vybrána žádná položka, hodnota SelectedIndex je -1. Pokud je vybrána první položka v seznamu, SelectedIndex hodnota je 0. Pokud je vybráno více položek, SelectedIndex hodnota odráží vybranou položku, která se zobrazí jako první v seznamu. Vlastnost SelectedItem se podobá SelectedIndex, ale vrátí samotnou položku, obvykle řetězcovou hodnotu. Vlastnost Count odráží počet položek v seznamu a hodnota vlastnosti Count je vždy jedna více než největší možná SelectedIndex hodnota, protože SelectedIndex je založená na nule.

Chcete-li přidat nebo odstranit položky v ovládacím prvku ListBox, použijte metodu Add, Insert, Clear nebo Remove. Alternativně můžete do seznamu přidat položky pomocí vlastnosti Items v době návrhu.

Viz také