ListView – ovládací prvek
ListView ovládací prvek, který zobrazuje jeden sloupec hodnot s ikonou vedle každé položky. Umožňuje uživateli vybrat jeden řetězec nebo celočíselnou hodnotu vlastnosti z předem určeného seznamu. Možné hodnoty se čtou z tabulky ListView. Ovládací prvek můžete přidružit k celočíselné nebo řetězcové hodnotě zadáním názvu vlastnosti do sloupce Vlastnost v tabulce Ovládací prvek.
Obsah textového pole Tabulka ovládacích prvků není nikdy zobrazen Ovládací prvek ListView. Místo toho toto pole určuje styl textu, který má ovládací prvek zobrazit, a obsahuje popis ovládacího prvku používaného nástroji pro kontrolu obrazovky. Pokud chcete nastavit písmo a styl písma textového řetězce, předponu řetězce zobrazených znaků zadejte {\style} nebo {&styl}. Kde styl je identifikátor uvedený ve sloupci TextStyle tabulky TextStyle tabulky. Pokud žádná z těchto možností není k dispozici, ale DefaultUIFont vlastnost je definována jako platný styl textu, použije se toto písmo. Následující informace čtou nástroje pro kontrolu obrazovky jako popis ovládacího prvku. Viz přístupnosti .
Atributy ovládacího prvku
U tohoto ovládacího prvku můžete použít následující atributy. Pokud chcete změnit hodnotu atributu pomocí události, přihlaste se k odběru ovládacího prvku ControlEvent v tabulce EventMapping a vypište identifikátor atributu ve sloupci Atribut. Zadejte identifikátor ControlEvent ve sloupci Událost.
| Identifikátor atributu | Šestnáctkový bit | Popis |
|---|---|---|
| IndirectPropertyName | Toto je název nepřímé vlastnosti přidružené k ovládacímu prvku. Pokud je nastaven bit nepřímého atributu, ovládací prvek zobrazí nebo změní hodnotu vlastnosti s tímto názvem. Pokud je nastaven nepřímý atribut bit, tento název je také hodnota vlastnosti uvedené ve sloupci Vlastnost Control tabulka. | |
| pozice | Umístění ovládacího prvku v dialogovém okně Zadejte šířku, výšku a souřadnice ovládacího prvku do sloupců Width, Height, X a Y v tabulkyControl . Pro délku a vzdálenost použijte jednotky instalačního programu . |
|
| PropertyName | Toto je název vlastnosti přidružené k tomuto ovládacímu prvku. Pokud není nastaven bit nepřímého atributu, ovládací prvek zobrazí nebo změní hodnotu vlastnosti s tímto názvem. Tento atribut je určen ve sloupci Property tabulky Control. | |
| PropertyValue | Aktuální hodnota vlastnosti zobrazené nebo změněné tímto ovládacím prvku. Pokud není nastaven bit nepřímého atributu, jedná se o hodnotu PropertyName. Pokud je nastaven bit nepřímého atributu, jedná se o hodnotu IndirectPropertyName. Pokud se atribut změní, ovládací prvek odráží novou hodnotu. | |
| textové | Chcete-li zobrazit text v čtečkách obrazovky, zadejte text do sloupce Text v Tabulka Ovládacích prvků. Viz přístupnosti . | |
| viditelných | 0x00000000 0x00000001 |
Skrytý ovládací prvek. Viditelný ovládací prvek. Tento bit zahrňte do bitového slova sloupce Atributy v řídicí tabulce, aby byl ovládací prvek viditelný nebo skrytý při jeho vytvoření. Ovládací prvek můžete také skrýt nebo zobrazit pomocí tabulky ControlCondition. |
| Povoleno | 0x00000000 0x00000002 |
Řízení v zakázaném stavu Řízení v povoleném stavu Tento bit zahrňte do bitového slova ve sloupci Atributy Ovládací povolit ovládací prvek při vytváření. Ovládací prvek můžete také povolit nebo zakázat pomocí tabulky ControlCondition. |
| sunken | 0x00000000 0x00000004 |
Zobrazí výchozí vizuální styl. Zobrazí ovládací prvek se sunkenem, prostorovým vzhledem. Zahrňte tyto bity do bitového slova ve sloupci Atributy tabulky Control. |
| nepřímých | 0x00000000 0x00000008 |
Ovládací prvek zobrazí nebo změní hodnotu vlastnosti ve sloupci Vlastnost tabulky Control. Ovládací prvek zobrazí nebo změní hodnotu vlastnosti, která má identifikátor uvedený ve sloupci Vlastnost tabulky Control. Určuje, zda vlastnost přidružená k tomuto ovládacího prvku je nepřímo odkazována. |
| celočíselná | 0x00000000 0x00000010 |
Vlastnost přidružená k ovládacího prvku je řetězcová hodnota. Vlastnost přidružená k ovládacího prvku je celočíselná hodnota. Tento bit zahrňte do bitového slova sloupce Atributy tabulky Control nastavit tento atribut při vytváření ovládacího prvku. |
| RTLRO | 0x00000000 0x00000020 |
Text v ovládacím prvku se zobrazí v pořadí čtení zleva doprava. Text v ovládacím prvku se zobrazí v pořadí čtení zprava doleva. |
| RightAligned | 0x00000000 0x00000040 |
Text v ovládacím prvku je zarovnaný doleva. Text v ovládacím prvku je zarovnaný doprava. |
| LeftScroll | 0x00000000 0x00000080 |
Posuvník se nachází na pravé straně ovládacího prvku. Posuvník se nachází na levé straně ovládacího prvku. |
| biDi | 0x000000E0 | Nastavte tuto hodnotu pro kombinaci RTLRO, RightAligneda LeftScroll atributy. |
| Seřazené | 0x00000000 0x00010000 |
Položky zobrazené v abecedním pořadí Položky zobrazené v pořadí zadaném v tabulce ListView. Tento bit zahrňte do bitového slova ve sloupci Atributy k zobrazení položek v pořadí určeném sloupcem Order v tabulce ListView. |
| FixedSize | 0x00000000 0x00100000 |
Roztáhne obrázek ikony tak, aby odpovídal ovládacímu prvku. Ořezá nebo zacentruje obrázek ikony v ovládacím prvku. Tento bit zahrňte do bitového slova sloupce Atributy tabulky Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Načte první obrázek. Načte první obrázek 16x16. Načte první obrázek 32x32. Načte první obrázek 48x48. Soubor ikony může obsahovat různé velikosti obrázků stejné ikony. Do sloupce Atributy tabulky Control zahrňte hodnotu odpovídajícího bitového slova. Pokud tyto bity nejsou nastaveny, instalační program ignoruje atribut FixedSize a obrázek se roztáhne tak, aby odpovídal obdélníku ovládacího prvku. Pokud jsou nastaveny bity IconSize i bity FixedSize, obrázek menší než ovládací prvek je zarovnaný na střed a obrázek je větší než ovládací prvek, který se zmenšuje tak, aby se vešl. |
Poznámky
Tento ovládací prvek lze vytvořit z WC_LISTVIEW třídy pomocí funkce CreateWindowEx. Má styly LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERa WS_TABSTOP. Pokud bit seřazeného stylu není zapnutý, ovládací prvek má také LVS_SORTASCENDING styl.
Kvůli kompatibilitě se čtečkami obrazovky musíte při vytváření dialogového okna s ovládacím prvku ListView jako prvního aktivního ovládacího prvku nastavit textové pole, které patří do pole pro úpravy, první aktivní ovládací prvek v tabulce dialogového okna . Vzhledem k tomu, že statický text nemůže fokus zaostřit, při vytvoření dialogového okna bude mít pole pro úpravy fokus původně tak, jak má, ale tím zajistíte, aby čtečky obrazovky zobrazovaly správné informace.