Klasa CListBox

Artykuł
06/10/2015

Udostępnia funkcje systemu Windows pole listy.

class CListBox : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CListBox::CListBox	Konstrukcje CListBox obiektu.

Metody publiczne

Nazwa	Opis
CListBox::AddString	Dodaje ciąg w polu listy.
CListBox::CharToItem	Zastępowanie zapewnienie niestandardowe WM_CHAR obsługi dla pól listy rysowania przez właściciela, które nie mają ciągi.
CListBox::CompareItem	Wywołana przez ramy do określenia pozycji nowego elementu w polu listy sortowane rysowania przez właściciela.
CListBox::Create	Tworzy pole listy Windows i dołącza go do CListBox obiektu.
CListBox::DeleteItem	Wywołana przez ramy, gdy użytkownik usuwa element z listy rysowania przez właściciela.
CListBox::DeleteString	Usuwa ciąg w polu listy.
CListBox::Dir	Dodaje nazwy i/lub dyski z bieżącego katalogu na pole listy.
CListBox::DrawItem	Wywołana przez ramy podczas visual aspekt zmiany pole listy rysowania przez właściciela.
CListBox::FindString	Wyszukuje ciąg w polu listy.
CListBox::FindStringExact	Odnajduje pierwszy ciąg pole listy, pasujący określony ciąg.
CListBox::GetAnchorIndex	Pobiera wyświetlanego bieżący element kontrolny w polu listy.
CListBox::GetCaretIndex	Określa indeks element prostokąt fokusu w polu listy wielokrotnego wyboru.
CListBox::GetCount	Zwraca liczbę ciągów znaków w polu listy.
CListBox::GetCurSel	Zwraca wyświetlanego aktualnie zaznaczony ciąg w polu listy.
CListBox::GetHorizontalExtent	Zwraca szerokość w pikselach, że pole listy może być przewijane poziomo.
CListBox::GetItemData	Zwraca wartość 32-bitowe skojarzone z elementem pola listy.
CListBox::GetItemDataPtr	Zwraca wskaźnik do elementu pola listy.
CListBox::GetItemHeight	Określa wysokość elementów w polu listy.
CListBox::GetItemRect	Zwraca prostokąta obwiedni elementu pola listy, jak aktualnie wyświetlana.
CListBox::GetListBoxInfo	Pobiera liczbę elementów w kolumnie.
CListBox::GetLocale	Pobiera identyfikator ustawień regionalnych dla pola listy.
CListBox::GetSel	Zwraca stan zaznaczenia elementu pola listy.
CListBox::GetSelCount	Zwraca liczbę ciągów zaznaczonego w polu listy wielokrotnego wyboru.
CListBox::GetSelItems	Zwraca wskaźników ciągi zaznaczonego w polu listy.
CListBox::GetText	Kopiuje element pola listy do bufora.
CListBox::GetTextLen	Zwraca długość w bajtach elementu pola listy.
CListBox::GetTopIndex	Zwraca indeks pierwszego ciągu widoczny w polu listy.
CListBox::InitStorage	Preallocates bloków pamięci dla elementów w polu listy i ciągi znaków.
CListBox::InsertString	Wstawia ciąg w określonej lokalizacji w polu listy.
CListBox::ItemFromPoint	Zwraca indeks elementu pola listy najbliższego punktu.
CListBox::MeasureItem	Wywołana w ramach tworzenia pola listy rysowania przez właściciela, aby określić wymiary w polu listy.
CListBox::ResetContent	Czyści wszystkie wpisy z pola listy.
CListBox::SelectString	Wyszukuje i wybierze ciąg znaków w polu listy z pojedynczym wyborem.
CListBox::SelItemRange	Powoduje zaznaczenie go lub zakres ciągi w pole listy wielokrotnego wyboru.
CListBox::SetAnchorIndex	Ustawia kotwica w pole listy wielokrotnego wyboru, aby rozpocząć rozszerzone zaznaczenie.
CListBox::SetCaretIndex	Ustawia prostokąt fokusu na określony indeks elementu w pole listy wielokrotnego wyboru.
CListBox::SetColumnWidth	Ustawia szerokość kolumny wielokolumnowego pola listy.
CListBox::SetCurSel	Zaznacza pole listy ciąg.
CListBox::SetHorizontalExtent	Ustawia szerokość w pikselach, że pole listy może być przewijane poziomo.
CListBox::SetItemData	Ustawia wartość 32-bitowe skojarzone z elementem pola listy.
CListBox::SetItemDataPtr	Ustawia wskaźnik do elementu pola listy.
CListBox::SetItemHeight	Ustawia wysokość elementów w polu listy.
CListBox::SetLocale	Ustawia identyfikator ustawień regionalnych dla pola listy.
CListBox::SetSel	Powoduje zaznaczenie go lub elementu pola listy w polu listy wielokrotnego wyboru.
CListBox::SetTabStops	Ustawia pozycje tabulatora w polu listy.
CListBox::SetTopIndex	Ustawia wyświetlanego w pierwszym ciągu widoczny w polu listy.
CListBox::VKeyToItem	Zastępowanie zapewnienie niestandardowe WM_KEYDOWN dla pola listy z LBS_WANTKEYBOARDINPUT zestaw stylów.

Uwagi

Pole listy wyświetla listę elementów, takich jak nazwy plików, które użytkownik może przeglądać i zaznacz.

W polu listy z pojedynczym wyborem użytkownika można wybrać tylko jeden element.Pole listy wielokrotnego wyboru można wybrać zakres elementów.Gdy użytkownik wybierze element, jest podświetlony i pole listy wysyła komunikat z powiadomieniem okno nadrzędne.

Można utworzyć pole listy, z szablonu okno dialogowe lub bezpośrednio w kodzie.Utworzyć bezpośrednio, skonstruować CListBox obiekt, a następnie wywołać Tworzenie Członkowskich funkcji Utwórz formant pola listy Windows i dołącz ją do CListBox obiektu.Do pola listy w szablonie okno dialogowe, należy zadeklarować zmienną pola listy w polu dialogowym klasy, a następnie użyj DDX_Control klasy okno dialogowe DoDataExchange funkcji połączyć zmienna członka formantu.(to jest wykonywane automatycznie po dodaniu do klasy okno dialogowe zmienna kontrolna.)

Budowa może być procesem jednostopniowym pochodną klasy CListBox.Konstruktora dla klasy pochodne i wywołanie zapis Tworzenie od wewnątrz konstruktora.

Jeśli chcesz obsłużyć wysłane przez pole listy nadrzędnego wiadomości powiadomień systemu Windows (zazwyczaj pochodną klasy CDialog), dodać funkcję Członkowskie wejścia i obsługi wiadomości wiadomości mapę do klasy nadrzędnej dla każdej wiadomości.

Każdy wpis mapowania wiadomości ma następującą postać:

ON_Notification( id, memberFxn )

gdy id Określa identyfikator okno podrzędne formantu pola listy wysłanie powiadomienia i memberFxn jest nazwą funkcji Członkowskich nadrzędnej do obsługi powiadamiania zostały zapisane.

Prototyp nadrzędnego jest następujący:

afx_msg void memberFxn( );

Poniżej znajduje się lista potencjalnych wpisów mapy wiadomości oraz opis przypadków, w których mogłoby być wysyłane do nadrzędnej:

ON_LBN_DBLCLK użytkownik kliknie dwukrotnie ciąg w polu listy.Tylko pola listy, który ma LBS_NOTIFY styl wyśle to komunikat z powiadomieniem.
ON_LBN_ERRSPACE pole listy nie można przydzielić wystarczającej ilości pamięci do spełnienia żądania.
ON_LBN_KILLFOCUS pole listy traci fokus.
ON_LBN_SELCANCEL bieżące zaznaczenie w polu listy jest anulowana.Wiadomość jest wysyłana tylko wtedy, gdy pole listy ma LBS_NOTIFY styl.
ON_LBN_SELCHANGE zaznaczenie w polu listy została zmieniona.To powiadomienie nie jest wysyłana, jeśli zaznaczenie zostanie zmienione przez CListBox::SetCurSel funkcji składowej.To powiadomienie dotyczy tylko pole listy, który ma LBS_NOTIFY styl.LBN_SELCHANGE komunikat z powiadomieniem jest wysyłany na pole listy wielokrotnego wyboru przy każdym naciśnięciu klawisza strzałki, nawet jeśli nie zmienia zaznaczenie.
ON_LBN_SETFOCUS odbiera fokus w polu listy.
ON_WM_CHARTOITEM pole listy rysowania przez właściciela, zawierającą ciągi nie odbiera WM_CHAR wiadomości.
ON_WM_VKEYTOITEM pole listy z LBS_WANTKEYBOARDINPUT odbiera styl WM_KEYDOWN wiadomości.

Jeśli tworzysz CListBox obiektu w oknie dialogowym (poprzez okno dialogowe zasób), CListBox obiekt jest niszczony automatycznie, gdy użytkownik zamyka okno dialogowe.

Jeśli tworzysz CListBox obiektu w oknie, może być konieczne zniszczenie CListBox obiektu.Jeśli tworzysz CListBox obiektów na stosie, jest niszczony.Jeśli tworzysz CListBox obiektu na stercie za pomocą Nowy funkcji, należy wywołać usunąć obiektu zniszczyć ją, gdy użytkownik zamyka okno nadrzędne.

Jeśli przydzielić pamięci w CListBox obiektów, należy zastąpić CListBox destruktora zbycia tego przydziału.