Seznamy obrázků v ovládacím prvku strom
Každá položka v ovládacím prvku stromu (CTreeCtrl) může mít přidruženou dvojici rastrových obrázků. Obrázky se zobrazí na levé straně popisku položky. Při výběru položky se zobrazí jeden obrázek a druhý se zobrazí, když položka není vybraná. Položka může například při výběru zobrazit otevřenou složku a uzavřenou složku, pokud není vybraná.
Chcete-li použít obrázky položek, musíte vytvořit seznam imagí vytvořením objektu CImageList a pomocí funkce CImageList::Create vytvořit přidružený seznam imagí. Potom přidejte požadované rastrové obrázky do seznamu a přidružte seznam k ovládacímu prvku stromu pomocí členské funkce SetImageList . Ve výchozím nastavení se u vybraných i nevybraných stavů zobrazí první obrázek v seznamu obrázků. Výchozí chování konkrétní položky můžete změnit zadáním indexů vybraných a nevybraných obrázků při přidávání položky do ovládacího prvku stromu pomocí členské funkce InsertItem . Indexy můžete po přidání položky změnit pomocí členské funkce SetItemImage .
Seznamy obrázků ovládacího prvku stromu můžou obsahovat také překryvné obrázky, které jsou navržené tak, aby byly superpozice na obrázcích položek. Nenulová hodnota v bitech 8 až 11 stavu položky ovládacího prvku stromu určuje index jednoho překrytí obrázku (0 označuje žádný překryvný obrázek). Vzhledem k tomu, že se používá 4bitový index založený na jednom, musí být překryvné obrázky mezi prvními 15 obrázky v seznamech obrázků. Další informace o stavech položek ovládacího prvku stromu naleznete v tématu Přehled stavů položek ovládacího prvku stromu dříve v tomto tématu.
Pokud je zadán seznam stavových imagí, ovládací prvek stromu si rezervuje místo vlevo od ikony každé položky pro obrázek stavu. Aplikace může k označení stavů definovaných položek použít obrázky stavu, jako jsou zaškrtnuté a nezaškrtnuté zaškrtávací políčka. Nenulová hodnota v bitech 12 až 15 určuje index stavu 12 až 15 (0 označuje žádný stavový obrázek).
Zadáním hodnoty I_IMAGECALLBACK namísto indexu obrázku můžete zpozdit zadání vybraného nebo nevybraného obrázku, dokud se položka nepřekreslí. I_IMAGECALLBACK směruje ovládací prvek stromu k dotazování aplikace na index odesláním zprávy TVN_GETDISPINFO oznámení.
Členská funkce GetImageList načte popisovač seznamu obrázků ovládacího prvku stromu. Tato funkce je užitečná, pokud potřebujete do seznamu přidat další obrázky. Další informace o seznamech obrázků naleznete v tématu Použití CImageList, CImageList v referenční dokumentaci MFC a seznamy obrázků v sadě Windows SDK.