Jak używać widoków kafelków

W tym temacie pokazano, jak ustawić widok kafelka dla kontrolki widoku listy. W widoku kafelka każdy element jest reprezentowany przez dużą ikonę z co najmniej jednym wierszem towarzyszącego tekstu. Aby zapoznać się z ilustracją, zobacz About List-View Controls.

Co musisz wiedzieć

Technologie

• kontrolek systemu Windows

Warunki wstępne

• C/C++
• Programowanie interfejsu użytkownika systemu Windows

Instrukcje

Ustaw ogólne parametry wyświetlania widoku kafelków przy użyciu makra ListView_SetTileViewInfo. Użyj LVTILEVIEWINFO struktury przekazanej do tego makra, aby określić położenie tekstu w odniesieniu do ikony, rozmiar każdego kafelka (w tym towarzyszący tekst) oraz maksymalną liczbę wierszy tekstu.

Jeśli nie chcesz, aby kafelki były rozmiarowane automatycznie, musisz ustawić LVTVIF_FIXEDSIZE w członku dwFlags i LVTVIM_TILESIZE w członku dwMask struktury LVTILEVIEWINFO, a także podać wymiary w członku sizeTile.

Poniższy przykład kodu języka C++ ustawia informacje widoku kafelkowego dla kontrolki widoku listy, tak aby dla każdego elementu wyświetlane były maksymalnie dwie podpozycje. Ustawia również rozmiar każdego kafelka.

    SIZE size = { 100, 50 };
    LVTILEVIEWINFO tileViewInfo = {0};

    tileViewInfo.cbSize   = sizeof(tileViewInfo);
    tileViewInfo.dwFlags  = LVTVIF_FIXEDSIZE;
    tileViewInfo.dwMask   = LVTVIM_COLUMNS | LVTVIM_TILESIZE;
    tileViewInfo.cLines   = 2;
    tileViewInfo.sizeTile = size;

    ListView_SetTileViewInfo(hWndListView, &tileViewInfo);

Dla każdego elementu na liście można ustawić dalsze parametry, gdy element zostanie wstawiony na liście lub później. Struktura LVITEM używana z ListView_InsertItem zawiera członków, którzy określają, które kolumny danych wyświetlić poniżej elementu oraz ich wyrównanie. Te same parametry wyświetlania znajdują się również w strukturze LVTILEINFO używanej z ListView_SetTileInfo .

Tematy pokrewne

odniesienie do kontrolki List-View

informacje o kontrolkach List-View

Korzystanie z kontrolek List-View