Dela via

SelectionTree-kontroll

  • Artikel

Den här kontrollen gör det möjligt för en användare att ändra urvalstillståndet för funktioner som anges i tabellen Funktion. Kontrollen är associerad med en strängvärdesegenskap som användaren kan ange i en dialogrutan Bläddra. Du kan associera kontrollen med en egenskap genom att ange egenskapens namn i kolumnen Egenskap i tabellen Control.

SelectionTree-kontrollen publicerar automatiskt följande Control Events på Windows XP eller tidigare operativsystem. Kontrollen SelectionTree publicerar dessa händelser när det markerade objektet ändras från en nod till en annan. Om markeringsträdet inte har några noder publicerar kontrollen dessa händelser och raderar innehållet i kontroller som prenumererar på händelsen. Dessa ControlEvents behöver inte anges i tabellen ControlEvent.

Kontrollhändelse Beskrivning
SelectionAction Publicerar en sträng från tabellen UIText som beskriver det markerade objektet.
SelectionBrowse Genererar en bläddra-dialogruta som används för att ändra sökvägen till det markerade objektet.
SelectionDescription Publicerar en sträng från tabellen Feature som beskriver det markerade objektet.
SelectionNoItems Tar bort den beskrivande texten eller inaktiverar knapparna för ett föråldrat objekt.
SelectionPath Publicerar sökvägen för det markerade objektet.
SelectionPathOn Publicerar om det finns en markeringssökväg som är associerad med den valda funktionen eller inte.
SelectionSize Publicerar storleken på det markerade objektet.

 

Från och med Windows Server 2003-system publicerar SelectionTree-kontroller alla händelser i tabellen ovan och publicerar dessutom en DoAction ControlEvent- eller en SetProperty ControlEvent-. Poster måste läggas till i tabellen ControlEvent för att publicera DoAction eller SetProperty ControlEvents.

Kontrollhändelse Beskrivning
DoAction Meddelar installationsprogrammet att köra en anpassad åtgärd.
SetProperty Anger en egenskap till ett nytt värde.

 

Från och med Windows Installer version 3.0 publicerar SelectionTree-kontroller en händelse som kör anpassade åtgärder visas i tabellen ControlEvent. SelectionTree-kontrollen publicerar den här händelsen när funktionsvalet ändras i kontrollen eller när ett annat urvalstillstånd väljs för den aktuella funktionen. De anpassade åtgärderna körs varje gång händelsen publiceras. Kontrollen SelectionTree skickar information till den anpassade åtgärden genom att ange värdena för följande egenskaper. Alla dessa egenskaper avmarkeras när SelectionTree-kontrollen stängs.

Windows Installer 2.0: Stöds inte. SelectionTree-kontrollen publicerar inte händelsen och anger inte följande egenskaper.

Egenskap Beskrivning
MsiSelectionTreeSelectedFeature Den valda funktionens namn i fältet Funktion i tabellen Feature.
MsiSelectionTreeSelectedAction Den valda funktionens installationsåtgärdstillstånd. Värdet kan vara INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE eller INSTALLSTATE_ADVERTISED.
MsiSelectonTreeChildrenCount Antal direkta underordnade noder.
MsiSelectionTreeInstallingChildrenCount Antal direkta underordnade noder som är INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE eller INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Kostnaden för att installera den valda funktionen i enheter på 512 byte.
MsiSelectionTreeChildrenCost Kostnaden för att installera alla underordnade funktioner i enheter på 512 byte.
MsiSelectionTreeSelectedPath Sökväg där den valda funktionen installeras. Definieras endast om funktionen installeras som INSTALLSTATE_LOCAL.

 

Not

Innehållet i fältet Text i tabellen Control visas aldrig av SelectionTree-kontrollen. I stället anger det här fältet textformatet som ska visas av kontrollen och innehåller en beskrivning av kontrollen som används av verktygen för skärmgranskning. Om du vill ange teckensnittet och teckensnittsformatet för en textsträng prefixar du strängen med tecken som visas med {\style} eller {&formatmall}. Där formatmallen är en identifierare i kolumnen TextStyle i tabellen TextStyle. Om inget av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. Informationen som följer detta läss av verktyg för skärmgranskning som beskrivning av kontrollen. Se Hjälpmedel.

 

Kontrollattribut

Du kan använda följande attribut med den här kontrollen. Om du vill ändra värdet för ett attribut med hjälp av en händelse prenumererar du på kontrollen till en ControlEvent i tabellen EventMapping och listar attributets identifierare i kolumnen Attribut. Ange identifieraren för ControlEvent i kolumnen Händelse.

Attributidentifierare Hexadecimal bit Beskrivning
IndirectPropertyName Namnet på en indirekt egenskap som är associerad med kontrollen. Om den indirekta attributbiten har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Om biten Indirekt attribut anges är det här namnet också värdet för egenskapen som anges i kolumnen Egenskap i tabellen Control.
position Kontrollens position i dialogrutan. Ange kontrollens bredd, höjd och koordinater i kontrollens vänstra hörn i kolumnerna Width, Height, X och Y i tabellen Control. Använd installationsenheter för längd och avstånd.
PropertyName Namnet på egenskapen som är associerad med den här kontrollen. Om den indirekta attributbiten inte har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Det här attributet anges i kolumnen Egenskap i tabellen Control.
PropertyValue Aktuellt värde för egenskapen som visas eller ändras av den här kontrollen. Om biten Indirect attribute inte har angetts är det värdet för PropertyName. Om biten Indirect attribute har angetts är det värdet indirectPropertyName. Om attributet ändras återspeglar kontrollen det nya värdet.
Text Visar text i skärmläsare enligt text som angetts i kolumnen Text i tabellen Control. Se Hjälpmedel.
synlig 0x00000000 0x00000001
 Dold kontroll. Synlig kontroll.
Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att göra kontrollen synlig eller dold när den skapas.
Du kan också dölja eller visa en kontroll med hjälp av tabellen ControlCondition.
aktiverat 0x00000000 0x00000002
 Kontroll i inaktiverat tillstånd. Kontroll i ett aktiverat tillstånd.
Inkludera den här biten i bitordet i kolumnen Attribut i Control för att aktivera kontrollen när den skapas.
Du kan också aktivera eller inaktivera en kontroll med hjälp av tabellen ControlCondition.
nedsänkt 0x00000000 0x00000004
 Visar standardformatet för visuella objekt. Visar kontrollen med en nedsänkt 3D-look.
Inkludera dessa bitar i bitordet i kolumnen Attribut i tabellen Control.
Indirekt 0x00000000 0x00000008
 Kontrollen visar eller ändrar värdet för egenskapen i kolumnen Egenskap i tabellen Control. Kontrollen visar eller ändrar värdet för egenskapen som innehåller identifieraren i kolumnen Egenskap i tabellen Kontroll.
Avgör om egenskapen som är associerad med den här kontrollen refereras indirekt.
RTLRO- 0x00000000 0x00000020
 Text i kontrollen visas i läsordning från vänster till höger. Text i kontrollen visas i läsordning från höger till vänster.
RightAligned 0x00000000 0x00000040
 Texten i kontrollen är justerad till vänster. Texten i kontrollen är justerad till höger.
LeftScroll 0x00000000 0x00000080
 Rullningslisten finns till höger om kontrollen. Rullningslisten finns till vänster i kontrollen.
BiDi 0x000000E0 Ange det här värdet för en kombination av RTLRO, RightAlignedoch LeftScroll attribut.

 

Anmärkningar

Den här kontrollen kan skapas från klassen WC_TREEVIEW med hjälp av funktionen CreateWindowEx. Den har formaten WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPoch WS_GROUP.

Urvalsträdet fylls bara i om åtgärden CostInitialize och CostFinalize har anropats.

Följande sträng i tabellen UIText är relaterad till den här kontrollen.

Term Beskrivning
AbsentPath
 Sökvägen som visas för ett objekt i frånvarande tillstånd.

 

Följande sex strängar används för att visa antalet underordnade objekt som valts och den storlek som är associerad med det markerade objektet:

  • SelChildCostPos
  • SelChildCostNeg
  • SelParentCostPosPos
  • SelParentCostPosNeg
  • SelParentCostNegPos
  • SelParentCostNegNeg

Följande strängar används för att visa tillgängliga urvalsalternativ för ett objekt i en popup-meny:

  • MenyAbsent
  • MenuLocal
  • MenuCD
  • MenyNätverk
  • MenuAllLocal
  • MenuAllCD
  • MenuAllNetwork

Följande strängar används för att förklara det aktuella valet i SelectionDescription ControlEvent.

  • SelAbsentAbsent
  • SelAbsentLocal
  • SelAbsentCD
  • SelAbsentNetwork
  • SelLocalAbsent
  • SelLocalLocalLocal
  • SelLocalCD
  • SelLocalNetwork
  • SelCDAbsent
  • SelNetworkAbsent
  • SelCDLocal
  • SelNetworkLocal
  • SelCDCD
  • SelNetworkNetwork

Följande fyra lokaliserade strängar används för att formatera storleken på en fil:

  • Byte
  • KB
  • MB
  • GB