Udostępnij za pośrednictwem

ListBox — przegląd kontrolki (Windows Forms)

Kontrolka Windows Forms ListBox wyświetla listę, z której użytkownik może wybrać co najmniej jeden element. Jeśli łączna liczba elementów przekracza liczbę, którą można wyświetlić, do kontrolki ListBox zostanie automatycznie dodany pasek przewijania. Gdy właściwość MultiColumn jest ustawiona na true, pole listy wyświetla elementy w wielu kolumnach i zostanie wyświetlony poziomy pasek przewijania. Gdy właściwość MultiColumn jest ustawiona na false, pole listy wyświetla elementy w jednej kolumnie i zostanie wyświetlony pionowy pasek przewijania. Gdy ScrollAlwaysVisible jest ustawiona na true, pasek przewijania jest wyświetlany niezależnie od liczby elementów. Właściwość SelectionMode określa, ile elementów listy można wybrać jednocześnie.

Sposoby zmiany kontrolki ListBox

Właściwość SelectedIndex zwraca wartość całkowitą odpowiadającą pierwszemu wybranemu elementowi w polu listy. Możesz programowo zmienić wybrany element, zmieniając wartość SelectedIndex w kodzie; odpowiedni element na liście zostanie wyróżniony w formularzu systemu Windows. Jeśli nie wybrano żadnego elementu, wartość SelectedIndex wynosi -1. Jeśli wybrano pierwszy element na liście, wartość SelectedIndex wynosi 0. Po wybraniu wielu elementów wartość SelectedIndex odzwierciedla wybrany element, który jest wyświetlany jako pierwszy na liście. Właściwość SelectedItem jest podobna do SelectedIndex, ale zwraca sam element, zazwyczaj wartość ciągu. Właściwość Count odzwierciedla liczbę elementów na liście, a wartość właściwości Count jest zawsze jedną więcej niż największą możliwą wartością SelectedIndex, ponieważ SelectedIndex jest oparta na zera.

Aby dodać lub usunąć elementy w kontrolce ListBox, użyj metody Add, Insert, Clear lub Remove. Alternatywnie można dodawać elementy do listy przy użyciu właściwości Items w czasie projektowania.

Zobacz także