Sdílet prostřednictvím

SelectionTree – ovládací prvek

  • Článek

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