SelectionTree – ovládací prvek
Tento ovládací prvek umožňuje uživateli změnit stav výběru funkcí uvedených v tabulce funkcí . Ovládací prvek je přidružen k řetězcové hodnotové vlastnosti, kterou uživatel může nastavit pomocí dialogového okna Procházet. Ovládací prvek můžete přidružit k vlastnosti zadáním názvu vlastnosti do sloupce Vlastnost v tabulka ovládacích prvků.
Ovládací prvek SelectionTree automaticky publikuje následující události řízení v systému Windows XP nebo starších operačních systémech. Ovládací prvek SelectionTree tyto události publikuje při změně vybrané položky z jednoho uzlu na jiný. Pokud strom výběru nemá žádné uzly, ovládací prvek tyto události publikuje a vymaže obsah ovládacích prvků, které se přihlásí k odběru události. Tyto ovládací prvky ControlEvent se nevyžadují, aby byly uvedeny v tabulce ControlEvent.
Řídicí událost | Popis |
---|---|
SelectionAction | Publikuje řetězec z tabulky UIText popisující zvýrazněnou položku. |
SelectionBrowse | Vygeneruje dialogové okno Procházet, které slouží k úpravě cesty zvýrazněné položky. |
SelectionDescription | Publikuje řetězec z tabulky funkcí popisující zvýrazněnou položku. |
SelectionNoItems | Odstraní popisný text nebo zakáže tlačítka zastaralé položky. |
SelectionPath | Publikuje cestu ke zvýrazněné položce. |
selectionPathOn | Publikuje, zda je k aktuálně vybrané funkci přidružená cesta výběru nebo ne. |
SelectionSize | Publikuje velikost zvýrazněné položky. |
Počínaje systémy Windows Server 2003 ovládací prvky SelectionTree publikují všechny události v tabulce výše a navíc publikují DoAction ControlEvent nebo SetProperty ControlEvent. Záznamy musí být přidány do tabulky ControlEvent k publikování DoAction nebo SetProperty ControlEvents.
Řídicí událost | Popis |
---|---|
DoAction | Upozorní instalační program, aby spustil vlastní akci. |
SetProperty | Nastaví vlastnost na novou hodnotu. |
Počínaje instalační službou systému Windows verze 3.0 ovládací prvky SelectionTree publikují událost, která spouští vlastní akce uvedené v tabulce ControlEvent. Ovládací prvek SelectionTree publikuje tuto událost při každé změně výběru funkce v ovládacím prvku nebo při každém výběru jiného stavu výběru pro aktuální funkci. Vlastní akce se spouštějí při každém publikování události. Ovládací prvek SelectionTree odesílá informace do vlastní akce nastavením hodnot následujících vlastností. Všechny tyto vlastnosti jsou vymazány při zavření ovládacího prvku SelectionTree.
Instalační služba systému Windows 2.0: Nepodporuje se. Ovládací prvek SelectionTree nepublikuje událost a nenastavuje následující vlastnosti.
Vlastnost | Popis |
---|---|
MsiSelectionTreeSelectedFeature | Název vybrané funkce v poli Funkce v tabulce Funkce. |
MsiSelectionTreeSelectedAction | Stav akce instalace vybrané funkce. Hodnota může být INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE nebo INSTALLSTATE_ADVERTISED. |
MsiSelectonTreeChildrenCount | Počet přímých podřízených uzlů |
MsiSelectionTreeInstallingChildrenCount | Počet přímých podřízených uzlů, které jsou INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE nebo INSTALLSTATE_ADVERTISED. |
MsiSelectionTreeSelectedCost | Náklady na instalaci vybrané funkce v jednotkách 512 bajtů |
MsiSelectionTreeChildrenCost | Náklady na instalaci všech podřízených funkcí v jednotkách 512 bajtů |
MsiSelectionTreeSelectedPath | Cesta, kam se vybraná funkce instaluje. Definuje se jenom v případě, že se tato funkce instaluje jako INSTALLSTATE_LOCAL. |
Poznámka
Obsah textového pole tabulky Ovládací prvek se nikdy nezobrazuje pomocí ovládacího prvku SelectionTree. 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 | 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 | 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é | Zobrazí text v čtečkách obrazovky podle textu zadaného do sloupce Text tabulky Control. 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, 3D a 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. |
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. |
Poznámky
Tento ovládací prvek lze vytvořit z třídy WC_TREEVIEW pomocí funkce CreateWindowEx. Má styly WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPa WS_GROUP.
Strom výběru se vyplní pouze v případě, že byla volána akce CostInitialize a akci CostFinalize.
Následující řetězec v tabulce UIText souvisí s tímto ovládacím prvku.
Semestr | Popis |
---|---|
AbsencePath |
Cesta zobrazená pro položku v chybějícím stavu. |
Následující šest řetězců slouží k zobrazení počtu vybraných podřízených položek a velikosti přidružené ke zvýrazněné položce:
- SelChildCostPos
- SelChildCostNeg
- SelParentCostPos
- SelParentCostPosNeg
- SelParentCostNegPos
- SelParentCostNegNeg
Následující řetězce slouží k zobrazení dostupných možností výběru pro položku v místní nabídce:
- NabídkaAbsent
- NabídkaLocal
- MenuCD
- NabídkaNetwork
- MenuAllLocal
- NabídkaAllCD
- NabídkaAllNetwork
Následující řetězce slouží k vysvětlení aktuálního výběru v SelectionDescription ControlEvent.
- SelAbsentAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Při formátování velikosti souboru se používají následující čtyři lokalizované řetězce:
- Byty
- KB
- MB
- GB