Klasa CListCtrl hermetyzuje funkcji "formantu widoku listy," który wyświetla zbiór elementów każdy składający się ikona (z listy obrazu) i etykiet. Oprócz ikony i etykiety każdy element może mieć informacje wyświetlane w kolumn po prawej stronie ikony i etykiety. Ten formant (i w związku z tym klasy CListCtrl ) jest dostępna tylko dla programów działających w systemie Windows 95 i Windows NT w wersji 3.51 lub nowszej.
Oto krótki przegląd klasy CListCtrl . Omówienie szczegółowe, pojęciach, zobacz Za pomocą CListCtrl i Tematy kontroli w Visual C++ Programmer's Guide.
Widoki
Formanty widok listy można wyświetlać ich zawartość w czterech różnych sposobów, o nazwie "widoków."
Każdy element jest wyświetlany jako ikona pełnowymiarowa (32 x 32 piksele) z etykietą poniżej. Użytkownik może przeciągać elementy w dowolne miejsce w oknie widoku listy.
Każdy element jest wyświetlany jako małe ikony (16 x 16 pikseli) z etykiety po prawej stronie. Użytkownik może przeciągać elementy w dowolne miejsce w oknie widoku listy.
Każdy element jest wyświetlany jako małe ikony z etykiety po prawej stronie. Elementy są rozmieszczone w kolumnach i nie mogą być przeciągane na dowolne miejsce w oknie widoku listy.
Każdy element jest wyświetlany w osobnym wierszu, z dodatkowymi informacjami, rozmieszczone w kolumnach po prawej stronie. Skrajna kolumna zawiera małe ikony i etykiety, a kolejne kolumny zawierają elementy podrzędne określonej przez aplikację. Osadzone nagłówka formantu (klasa CHeaderCtrl) implementuje tych kolumn. Aby uzyskać więcej informacji na temat nagłówka formantu i kolumn w widoku raportu, zobacz za pomocą CListCtrl: dodawanie kolumn do kontroli (widok raportu).
Styl formantu bieżącego widoku listy określa bieżący widok. Więcej informacji na temat tych tych stylów i ich wykorzystania, zobacz za pomocą CListCtrl: zmiana listy kontrolą style.
Rozszerzone style
W uzupełnieniu do stylów standardowe listy klasy CListCtrl obsługuje duży zestaw rozszerzonych style, zapewniając wzbogaconego funkcjonalność. Niektóre przykłady tej funkcji:
Po włączeniu umożliwia automatyczne zaznaczenie elementu, gdy kursor pozostaje nad elementem przez pewien okres czasu.
Po włączeniu, umożliwia sterowanie do elementów DWORD . Jest to możliwe poprzez umieszczenie narzutów zarządzania element danych w aplikacji. Z wyjątkiem dla zaznaczenia elementu i informacja fokusu wszystkie informacje elementu muszą być zarządzane przez aplikację. Aby uzyskać więcej informacji, zobacz za pomocą CListCtrl: wirtualny formanty listy.
Po włączeniu umożliwia śledzenie gorąco (automatycznego wyróżniania tekstu elementu) i one– lub two– aktywacji kliknij element wyróżniony.
Po włączeniu, pozwala na przeciąganie i upuszczanie zmiana kolejności kolumn w formancie widoku listy. Dostępny tylko w widoku raportu.
Aby uzyskać informacje na temat używania tych nowych, rozszerzone style, za pomocą CListCtrl: zmiana listy kontrolą style.
Elementy oraz elementy podrzędne
Każdy element w formancie widoku listy składa się ikona (z listy obrazów), etykieta, bieżący stan i wartości zdefiniowanych przez aplikację (dalej jako "element danych"). Podelementy jednego lub więcej może być także powiązane z każdego elementu. "Podelement" jest ciągiem, że w widoku raportu może być wyświetlona w kolumnie po prawej stronie elementu ikony i etykiety. Wszystkie elementy w formancie widoku listy musi mieć taką samą liczbę podelementy.
Klasa CListCtrl udostępnia kilka funkcji do wstawiania, usuwania, znajdowanie i modyfikowanie tych elementów. Aby uzyskać więcej informacji, zobacz CListCtrl::GetItem, CListCtrl::InsertItemi CListCtrl::FindItem, za pomocą CListCtrl: dodawanie elementów do formantu, i za pomocą CListCtrl: przewijanie, rozmieszczanie, sortowanie i wyszukiwanie w formanty listy.
Domyślnie formantu widoku listy jest odpowiedzialna za przechowywanie elementu tekst i ikona atrybutów. Jednakże oprócz tych typów elementów klasy CListCtrl obsługuje "wywołania zwrotnego elementów." "Pozycja wywołania zwrotnego" jest element widoku listy, dla którego wniosek — zamiast kontroli — zapisuje tekst i/lub w ikonę. Aby określić, które atrybuty elementu (tekst i ikona) są dostarczane przez aplikację jest używana maska wywołania zwrotnego. Jeśli aplikacja używa wywołania zwrotnego elementów, musi być w stanie dostarczyć atrybuty tekstu i/lub ikona na popyt. Elementy wywołania zwrotnego są pomocne w przypadku aplikacji już utrzymuje niektóre z tych informacji. Aby uzyskać więcej informacji, zobacz temat CListCtrl::GetCallBackMask i za pomocą CListCtrl: elementy wywołania zwrotnego i Maska wywołania zwrotnego.
Obraz list
Ikony, nagłówek elementu obrazów i application– zdefiniowane Państwa w widoku listy, której elementy są zawarte w kilka obrazu list (implementowane przez klasy CImageList), które można utworzyć i przypisać do formantu widoku listy. Każdego formantu widoku listy może mieć maksymalnie cztery różne typy list obrazu:
Używane w widoku ikony dla pełnowymiarowej ikony.
Używane w małe ikony, lista, widoków raportu na mniejsze wersje ikon używanych w widoku ikony.
Zawiera stan obrazów, które są wyświetlane obok ikony elementu do wskazania Państwa zdefiniowanych przez aplikację.
Używane w widoku raportu dla małych obrazów, które pojawiają się w każdej pozycji formantu nagłówka.
Domyślnie formant widoku listy niszczy listy obrazów, przypisane do niego zostanie zniszczone; Jednakże autora można dostosować to zachowanie przez zniszczenie każdej listy obrazu, gdy jest już używany, określone przez aplikację. Aby uzyskać więcej informacji, zobacz za pomocą CListCtrl: elementy listy i wyświetla obraz i za pomocą CListCtrl: elementy listy i wyświetla obraz.
# include lt;afxcmn.h>
Czło&nkowie klasy |nbsp; Klasa podstawowa | Wykres hierarchii
Próbki Próbki MFC DAOTABLE | Próbki MFC HTTPSVR | Próbki MFC LISTHDR | Próbki MFC ROWLIST | Próbki MFC DBVLIST
Zobacz też CImageList