Klasa CListCtrl

Artykuł
02/27/2013

Hermetyzuje funkcjonalność "widoku formantu listy," który wyświetla zbiór elementów każdej ikony (z listy obrazu) i etykiety.

class CListCtrl : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CListCtrl::CListCtrl	Konstrukcje CListCtrl obiektu.

Metody publiczne

Nazwa	Opis
CListCtrl::ApproximateViewRect	Określa szerokość i wysokość wymagane, aby wyświetlić elementy sterowania widoku listy.
CListCtrl::Arrange	Wyrównuje elementów na siatce.
CListCtrl::CancelEditLabel	Anuluje operację edycji tekstu elementu.
CListCtrl::Create	Tworzy formant listy i dołącza go do CListCtrl obiektu.
CListCtrl::CreateDragImage	Tworzy listę przeciągania obrazu dla określonego towaru.
CListCtrl::CreateEx	Tworzy formant listy z określonych stylów rozszerzonego systemu Windows i dołącza go do CListCtrl obiektu.
CListCtrl::DeleteAllItems	Usuwa wszystkie elementy z formantu.
CListCtrl::DeleteColumn	Usuwa kolumnę z formantu widoku listy.
CListCtrl::DeleteItem	Usuwa element z formantu.
CListCtrl::DrawItem	Wywoływane, gdy visual aspekt zmiany kontroli rysowania przez właściciela.
CListCtrl::EditLabel	Rozpoczyna się w miejscu edycji tekstu elementu.
CListCtrl::EnableGroupView	Włącza lub wyłącza się, czy elementy formantu widoku listy są wyświetlane jako grupa.
CListCtrl::EnsureVisible	Zapewnia, że element jest widoczny.
CListCtrl::FindItem	Wyszukiwanie elementu widoku listy, posiadające określone cechy.
CListCtrl::GetBkColor	Pobiera kolor tła formantu widoku listy.
CListCtrl::GetBkImage	Pobiera bieżący obraz tła formantu widoku listy.
CListCtrl::GetCallbackMask	Pobiera maskę wywołania zwrotnego dla formantu widoku listy.
CListCtrl::GetCheck	Pobiera bieżący stan wyświetlania obrazu stanu skojarzonego z elementem.
CListCtrl::GetColumn	Pobiera atrybuty kolumny formantu.
CListCtrl::GetColumnOrderArray	Pobiera kolejność kolumn (od lewej do prawej) formantu widoku listy.
CListCtrl::GetColumnWidth	Pobiera szerokość kolumny w widoku raportu lub listy.
CListCtrl::GetCountPerPage	Oblicza liczbę elementów, które można zmieścić w pionie w formantu widoku listy.
CListCtrl::GetEditControl	Pobiera uchwycie edycyjnym, używany do edytowania tekstu elementu.
CListCtrl::GetEmptyText	Pobiera ciąg do wyświetlania, jeśli bieżący widok listy formant jest pusty.
CListCtrl::GetExtendedStyle	Pobiera extended style bieżącego formantu widoku listy.
CListCtrl::GetFirstSelectedItemPosition	Pobiera pozycji pierwszego elementu widoku listy wybranego formantu widoku listy.
CListCtrl::GetFocusedGroup	Pobiera grupy, fokusem klawiatury w formancie bieżącego widoku listy.
CListCtrl::GetGroupCount	Pobiera numer bieżącego formantu widoku listy grup.
CListCtrl::GetGroupInfo	Pobiera informacje dla określonej grupy, formant w widoku listy.
CListCtrl::GetGroupInfoByIndex	Pobiera informacje o określonej grupy bieżącego formantu widoku listy.
CListCtrl::GetGroupMetrics	Pobiera metryki grupy.
CListCtrl::GetGroupRect	Pobiera prostokąta obwiedni dla określonej grupy bieżącego formantu widoku listy.
CListCtrl::GetGroupState	Pobiera stan dla określonej grupy bieżącego formantu widoku listy.
CListCtrl::GetHeaderCtrl	Pobiera formant nagłówka formantu widoku listy.
CListCtrl::GetHotCursor	Pobiera kursor używane podczas śledzenia hot jest włączona dla formantu widoku listy.
CListCtrl::GetHotItem	Pobiera element widoku listy aktualnie pod kursorem.
CListCtrl::GetHoverTime	Pobiera bieżący czas aktywowania formantu widoku listy.
CListCtrl::GetImageList	Pobiera uchwyt listy obrazów używany do rysowania elementów widoku listy.
CListCtrl::GetInsertMark	Pobiera bieżącą pozycję znacznik wstawiania.
CListCtrl::GetInsertMarkColor	Pobiera bieżący kolor znaku wstawiania.
CListCtrl::GetInsertMarkRect	Pobiera prostokąt, który ogranicza punkt wstawiania.
CListCtrl::GetItem	Pobiera atrybuty elementu widoku listy.
CListCtrl::GetItemCount	Pobiera numer formantu widoku listy elementów.
CListCtrl::GetItemData	Pobiera wartość specyficzne dla aplikacji skojarzonych z towarem.
CListCtrl::GetItemIndexRect	Pobiera prostokąta obwiedni dla wszystkich lub części podpozycji bieżącego formantu widoku listy.
CListCtrl::GetItemPosition	Pobiera położenie elementu widoku listy.
CListCtrl::GetItemRect	Pobiera prostokąta obwiedni dla towaru.
CListCtrl::GetItemSpacing	Oblicza wartość odstępów między elementami w bieżącego formantu widoku listy.
CListCtrl::GetItemState	Pobiera stan elementu widoku listy.
CListCtrl::GetItemText	Pobiera tekst elementu widoku listy lub podelement.
CListCtrl::GetNextItem	Wyszukiwanie elementu widoku listy z określonych właściwości i określonej relacji do danego elementu.
CListCtrl::GetNextItemIndex	Pobiera indeks bieżącego formantu widoku listy, który ma określony zestaw właściwości elementu.
CListCtrl::GetNextSelectedItem	Pobiera indeks pozycji elementu widoku listy i położenie następnego elementu widoku listy wybranych do iteracji.
CListCtrl::GetNumberOfWorkAreas	Pobiera bieżący numer obszary robocze dla formantu widoku listy.
CListCtrl::GetOrigin	Pobiera bieżący widok pochodzenia dla formantu widoku listy.
CListCtrl::GetOutlineColor	Pobiera kolor obramowania formantu widoku listy.
CListCtrl::GetSelectedColumn	Pobiera indeks aktualnie zaznaczonej kolumny w formancie listy.
CListCtrl::GetSelectedCount	Kopiuje zaznaczone elementy w formantu widoku listy.
CListCtrl::GetSelectionMark	Pobiera znak zaznaczenia formantu widoku listy.
CListCtrl::GetStringWidth	Określa minimalną szerokość niezbędne do wyświetlenia wszystkich ciągu.
CListCtrl::GetSubItemRect	Pobiera prostokąta obwiedni elementu formantu widoku listy.
CListCtrl::GetTextBkColor	Pobiera tekst kolor tła formantu widoku listy.
CListCtrl::GetTextColor	Pobiera kolor tekstu formantu widoku listy.
CListCtrl::GetTileInfo	Pobiera informacje o sąsiadująco formantu widoku listy.
CListCtrl::GetTileViewInfo	Pobiera informacje o formantu widoku listy w widoku Sąsiadująco.
CListCtrl::GetToolTips	Pobiera używającej formantu widoku listy, aby wyświetlić etykietki formantu tooltip.
CListCtrl::GetTopIndex	Pobiera indeks widoczne elementem wierzchnim.
CListCtrl::GetView	Pobiera widoku formantu widoku listy.
CListCtrl::GetViewRect	Pobiera prostokąta obwiedni wszystkich elementów w formancie widoku listy.
CListCtrl::GetWorkAreas	Pobiera bieżący obszary robocze formant w widoku listy.
CListCtrl::HasGroup	Określa, czy formant w widoku listy ma określonej grupy.
CListCtrl::HitTest	Określa, których wykaz jest widok elementu w określonym położeniu.
CListCtrl::InsertColumn	Wstawia nowe kolumny formantu widoku listy.
CListCtrl::InsertGroup	Wstawia formant w widoku listy grupy.
CListCtrl::InsertGroupSorted	Wstawia określona grupa uporządkowanej listy grup.
CListCtrl::InsertItem	Wstawia nowy element formantu widoku listy.
CListCtrl::InsertMarkHitTest	Pobiera określonego punktu najbliżej punktu wstawiania.
CListCtrl::IsGroupViewEnabled	Określa, czy grupa widoku jest włączona dla formantu widoku listy.
CListCtrl::IsItemVisible	Wskazuje, czy określony element w formancie bieżącego widoku listy jest widoczny.
CListCtrl::MapIDToIndex	Mapuje indeks unikatowy identyfikator elementu w formancie bieżącego widoku listy.
CListCtrl::MapIndexToID	Mapuje indeksu elementu w formancie bieżącego widoku listy unikatowy identyfikator.
CListCtrl::MoveGroup	Przenosi określonej grupy.
CListCtrl::MoveItemToGroup	Przesuwa się, że określona grupa na określonym zero indeks oparty formant w widoku listy.
CListCtrl::RedrawItems	Wymusza formantu widoku listy do odświeżenia zakresu elementów.
CListCtrl::RemoveAllGroups	Usuwa wszystkie grupy z formantu widoku listy.
CListCtrl::RemoveGroup	Określona grupa Usuwa z formantu widoku listy.
CListCtrl::Scroll	Przewija zawartość formantu widoku listy.
CListCtrl::SetBkColor	Ustawia kolor tła formantu widoku listy.
CListCtrl::SetBkImage	Ustawia bieżący obraz tła formantu widoku listy.
CListCtrl::SetCallbackMask	Ustawia maskę wywołania zwrotnego dla formantu widoku listy.
CListCtrl::SetCheck	Ustawia bieżący wyświetlić stan obrazu stanu skojarzonego z elementem.
CListCtrl::SetColumn	Ustawia atrybuty kolumny widoku listy.
CListCtrl::SetColumnOrderArray	Ustawia kolejność kolumn (od lewej do prawej) formantu widoku listy.
CListCtrl::SetColumnWidth	Zmienia szerokość kolumny w widoku raportu lub listy.
CListCtrl::SetExtendedStyle	Ustawia extended style bieżącego formantu widoku listy.
CListCtrl::SetGroupInfo	Ustawia informacje dotyczące określonej grupy, formant w widoku listy.
CListCtrl::SetGroupMetrics	Ustawia metryki grupy, formant w widoku listy.
CListCtrl::SetHotCursor	Ustawia kursor używane podczas śledzenia hot jest włączona dla formantu widoku listy.
CListCtrl::SetHotItem	Ustawia bieżący element hot formant w widoku listy.
CListCtrl::SetHoverTime	Ustawia bieżący czas aktywowania formantu widoku listy.
CListCtrl::SetIconSpacing	Ustawia odstępy między ikonami formantu widoku listy.
CListCtrl::SetImageList	Przypisuje listę obrazu formantu widoku listy.
CListCtrl::SetInfoTip	Określa tekst etykietki narzędzia.
CListCtrl::SetInsertMark	Ustawia punkt wstawiania do określonego położenia.
CListCtrl::SetInsertMarkColor	Ustawia kolor punktu wstawiania.
CListCtrl::SetItem	Ustawia niektóre lub wszystkie widoku listy atrybutów towaru.
CListCtrl::SetItemCount	Przygotowuje formantu widoku listy do dodawania wielu elementów.
CListCtrl::SetItemCountEx	Ustawia licznik towaru dla formantu widoku listy wirtualnych.
CListCtrl::SetItemData	Ustawia wartość specyficzne dla aplikacji.
CListCtrl::SetItemIndexState	Ustawia stan elementu w formancie bieżącego widoku listy.
CListCtrl::SetItemPosition	Przesuwa element do określonego położenia formantu widoku listy.
CListCtrl::SetItemState	Zmienia stan elementu formantu widoku listy.
CListCtrl::SetItemText	Zmienia tekst elementu widoku listy lub podelement.
CListCtrl::SetOutlineColor	Ustawia kolor obramowania formantu widoku listy.
CListCtrl::SetSelectedColumn	Ustawia zaznaczoną kolumnę formantu widoku listy.
CListCtrl::SetSelectionMark	Ustawia znak zaznaczenia formantu widoku listy.
CListCtrl::SetTextBkColor	Ustawia kolor tła tekstu w formancie widoku listy.
CListCtrl::SetTextColor	Ustawia kolor tekstu formantu widoku listy.
CListCtrl::SetTileInfo	Ustawia informacje dotyczące tabliczkę formant w widoku listy.
CListCtrl::SetTileViewInfo	Ustawia informacje o używającej formantu widoku listy w widoku Sąsiadująco.
CListCtrl::SetToolTips	Ustawia, że formant widok listy umożliwia wyświetlanie formantu tooltip.
CListCtrl::SetView	Ustawia wyświetlanie formantu widoku listy.
CListCtrl::SetWorkAreas	Ustawia obszar, gdzie wyświetlane ikony formantu widoku listy.
CListCtrl::SortGroups	Sortuje grupy listy wyświetlania formantu za pomocą funkcji zdefiniowanej przez użytkownika.
CListCtrl::SortItems	Sortuje elementy widoku listy za pomocą funkcji Porównywanie przez aplikację.
CListCtrl::SortItemsEx	Sortuje elementy widoku listy za pomocą funkcji Porównywanie przez aplikację.
CListCtrl::SubItemHitTest	Określa które elementu widoku listy, jeśli jest, w danej pozycji.
CListCtrl::Update	Siły sterowania do odświeżenia określonego elementu.

Uwagi

Ikony i etykiety każdy element może mieć informacje wyświetlane w kolumnach po prawej stronie ikony i etykiety.Ten formant (a zatem CListCtrl klasy) jest dostępna tylko dla programów działających w systemie Windows 95 i 98 i Windows NT w wersji 3.51 i później.

Oto krótki przegląd CListCtrl klasy.Szczegółowe omówienie pojęć, zobacz Za pomocą CListCtrl i kontroli.

Widoki

Formanty widok listy można wyświetlać ich zawartość w cztery różne sposoby, nazywany "widoki".

Widok ikony

Każdy element pojawia się jako ikona pełnowymiarowa (32 x 32 piksele) z etykietą poniżej.Użytkownik może przeciągać elementy w dowolne miejsce w oknie Widok listy.
Małe ikony, widok

Każdy element pojawia się jako mała ikona (16 x 16 pikseli), etykiety po prawej stronie.Użytkownik może przeciągać elementy w dowolne miejsce w oknie Widok listy.
Widok listy

Każdy element jest wyświetlany jako małe ikony z etykietą z prawej strony.Elementy są rozmieszczone w kolumnach i nie mogą być przeciągane na dowolne miejsce w oknie widoku listy.
Widok raportu

Dodatkowe informacje rozmieszczone w kolumnach po prawej stronie każdego elementu pojawia się w osobnym wierszu.Skrajna kolumna zawiera małe ikony i etykiety i kolejnych kolumn zawiera podelementy określonych aplikacji.Osadzone nagłówka formantu (klasy CHeaderCtrl) implementuje te kolumny.Więcej informacji o nagłówku kontroli i kolumn w widoku raportu, zobacz CListCtrl za pomocą: Dodawanie kolumn do formantu (widok raportu).

Zobacz też:

Artykuł bazy wiedzy Knowledge Base Q250614: HOWTO: sortowanie elementów w CListCtrl w widoku raportu
Artykuł bazy wiedzy Knowledge Base Q200054: PRB: OnTimer() jest nie nazywane wielokrotnie dla formantu listy

Styl formantu bieżącego widoku listy określa bieżący widok.Więcej informacji o tych stylów i sposób ich użycia, zobacz CListCtrl za pomocą: zmiana listy stylów formantu.

Extended style

Oprócz standardowej listy stylów, klasy CListCtrl obsługuje duży zestaw extended style, dostarczanie wzbogaconych funkcji.Niektóre przykłady tej funkcji:

Wybór aktywowania

Po włączeniu umożliwia automatyczne zaznaczenie elementu, gdy kursor pozostaje nad elementem okres czasu.
Widoki listy wirtualnych

Po włączeniu umożliwia kontrolę do obsługi maksymalnie DWORD elementy.Jest to możliwe, umieszczając narzutów zarządzania element danych w aplikacji.Wybór przedmiotu i informacje fokus wszystkie informacje muszą być zarządzane przez aplikację.Aby uzyskać więcej informacji, zobacz CListCtrl za pomocą: wirtualnego formantów listy.
One– i two– kliknij aktywacji

Po włączeniu pozwala hot śledzenia (automatyczne podkreślanie tekstu elementu) i one– lub two– kliknij aktywacji element wyróżniony.
Przeciągnij i upuść kolejności kolumn

Po włączeniu pozwala przeciągać i upuszczać kolejności kolumn w formancie widoku listy.Tylko dostępne w widoku raportu.

Aby uzyskać informacje na temat używania tych nowych extended style, CListCtrl za pomocą: zmiana listy stylów formantu.

Elementy i elementy podrzędne

Każdy element formantu widoku listy składa się z ikony (z listy obrazu), etykieta, bieżący stan i wartość przez aplikację (zwany dalej jako "element danych").Jeden lub więcej podelementów może być także powiązane z każdego elementu."Podpozycji" jest ciągiem w widoku raportu można wyświetlane w kolumnie po prawej stronie ikony i etykiety elementu.Wszystkie elementy w formantu widoku listy musi mieć taką samą liczbę podelementy.

Klasa CListCtrl zawiera kilka funkcji do wstawiania, usuwania, znajdowanie i modyfikowanie tych elementów.Aby uzyskać więcej informacji, zobacz CListCtrl::GetItem, CListCtrl::InsertItem, i CListCtrl::FindItem, CListCtrl za pomocą: Dodawanie elementów do formantu, i CListCtrl za pomocą: przewijanie, rozmieszczanie, sortowanie i wyszukiwanie w liście kontroli.

Domyślnie formantu widoku listy jest odpowiedzialny za przechowywanie atrybutów ikonę i tekst elementu.Jednakże, poza tymi typami towarów klasy CListCtrl obsługuje "elementy wywołania zwrotnego." "Element wywołania zwrotnego" jest element widoku listy, dla której aplikacji — formant — zapisuje tekst lub ikonę.Maska wywołania zwrotnego jest używany do określenia, które atrybuty elementu (tekst i ikona) są dostarczane przez aplikację.Jeśli aplikacja używa elementów wywołania zwrotnego, należy dostarczyć atrybuty tekstu lub ikony na żądanie.Elementy wywołania zwrotnego są pomocne w przypadku aplikacji już przechowuje niektóre z tych informacji.Aby uzyskać więcej informacji, zobacz CListCtrl za pomocą: elementy wywołania zwrotnego i maska wywołania zwrotnego.

Obraz list

Ikony, nagłówek elementu obrazów i application– zdefiniowane Państwa dla elementów w widoku listy są zawarte w kilku list obrazu (implementowane przez klasy CImageList), który można utworzyć i przypisać do formantu widoku listy.Każdy formant w widoku listy może mieć maksymalnie cztery różne typy list obrazu:

Duże ikony

Używane w widoku ikony dla pełnowymiarowych ikon.
Mała ikona

Używane w małe ikony, lista i widoki raportu dla wersji mniejsze ikony w widoku ikony.
Definicja aplikacji Państwo

Zawiera obrazy stanu, które są wyświetlane obok ikony elementu, aby wskazywać stan przez aplikację.
Element nagłówka

Używane w widoku raportu dla małych obrazów wyświetlanych w każdym elemencie sterowania nagłówka.

Domyślnie formantu widoku listy niszczy list obraz przypisany do niego podczas zostanie zniszczone; Programiści mogą dostosowywać zachowanie przez zniszczenie każdej listy obrazu, gdy jest już używany, określone przez aplikację.Aby uzyskać więcej informacji, zobacz CListCtrl za pomocą: elementy listy i wyświetla obraz.