Delen via

SelectionTree-besturingselement

  • Artikel

Met dit besturingselement kan een gebruiker de selectiestatus wijzigen van functies die worden vermeld in de functietabel. Het besturingselement is gekoppeld aan een eigenschap met een tekenreekswaarde die de gebruiker kan instellen door een dialoogvenster Bladeren. U kunt het besturingselement koppelen aan een eigenschap door de naam van de eigenschap in te voeren in de kolom Eigenschap van de tabel Control.

Het besturingselement SelectionTree publiceert automatisch de volgende Controle-gebeurtenissen op Windows XP of eerdere besturingssystemen. Het besturingselement SelectionTree publiceert deze gebeurtenissen wanneer het geselecteerde item van het ene knooppunt naar het andere wordt gewijzigd. Als de selectiestructuur geen knooppunten heeft, publiceert het besturingselement deze gebeurtenissen en wist het de inhoud van besturingselementen die zich abonneren op de gebeurtenis. Deze ControlEvents hoeven niet te worden vermeld in de tabel ControlEvent.

Controle-gebeurtenis Beschrijving
SelectionAction- Hiermee publiceert u een tekenreeks uit de tabel UIText het gemarkeerde item beschrijft.
SelectionBrowse- Hiermee wordt een dialoogvenster Bladeren gegenereerd dat wordt gebruikt om het pad van het gemarkeerde item te wijzigen.
SelectionDescription Hiermee publiceert u een tekenreeks uit de tabel Functie waarin het gemarkeerde item wordt beschreven.
SelectionNoItems- Hiermee verwijdert u de beschrijvende tekst of schakelt u de knoppen van een verouderd item uit.
SelectionPath- Hiermee publiceert u het pad voor het gemarkeerde item.
SelectionPathOn- Hiermee wordt gepubliceerd of er al dan niet een selectiepad is gekoppeld aan de geselecteerde functie.
SelectionSize Hiermee publiceert u de grootte van het gemarkeerde item.

 

Vanaf de Windows Server 2003-systemen publiceert SelectionTree alle gebeurtenissen in de bovenstaande tabel en publiceert u bovendien een DoAction ControlEvent- of een SetProperty ControlEvent. Records moeten worden toegevoegd aan de ControlEvent-tabel om DoAction of SetProperty ControlEvents te publiceren.

Controle-gebeurtenis Beschrijving
DoAction- Hiermee wordt het installatieprogramma op de hoogte gebracht voor het uitvoeren van een aangepaste actie.
SetProperty- Hiermee stelt u een eigenschap in op een nieuwe waarde.

 

Vanaf Windows Installer versie 3.0 publiceren SelectionTree-besturingselementen een gebeurtenis die aangepaste acties uitvoert vermeld in de ControlEvent-tabel. Het besturingselement SelectionTree publiceert deze gebeurtenis wanneer de functieselectie verandert in het besturingselement of wanneer een andere selectiestatus wordt gekozen voor de huidige functie. De aangepaste acties worden telkens uitgevoerd wanneer de gebeurtenis wordt gepubliceerd. Het besturingselement SelectionTree verzendt informatie naar de aangepaste actie door de waarden van de volgende eigenschappen in te stellen. Al deze eigenschappen worden allemaal gewist wanneer het besturingselement SelectionTree wordt gesloten.

Windows Installer 2.0: Niet ondersteund. Het besturingselement SelectionTree publiceert de gebeurtenis niet en stelt de volgende eigenschappen niet in.

Eigenschap Beschrijving
MsiSelectionTreeSelectedFeature De naam van de geselecteerde functie in het veld Functie van de tabel Functie.
MsiSelectionTreeSelectedAction De installatieactiestatus van de geselecteerde functie. De waarde kan INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE of INSTALLSTATE_ADVERTISED zijn.
MsiSelectonTreeChildrenCount Aantal directe onderliggende knooppunten.
MsiSelectionTreeInstallingChildrenCount Aantal directe onderliggende knooppunten die zijn INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE of INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Kosten voor het installeren van de geselecteerde functie in eenheden van 512 bytes.
MsiSelectionTreeChildrenCost Kosten voor het installeren van alle onderliggende functies in eenheden van 512 bytes.
MsiSelectionTreeSelectedPath Pad waar de geselecteerde functie wordt geïnstalleerd. Alleen gedefinieerd als de functie wordt geïnstalleerd als INSTALLSTATE_LOCAL.

 

Notitie

De inhoud van het tekstveld van de Besturingselementtabel wordt nooit weergegeven door het besturingselement SelectionTree. In plaats daarvan geeft dit veld de stijl van tekst op die door het besturingselement moet worden weergegeven en bevat een beschrijving van het besturingselement dat wordt gebruikt door de hulpprogramma's voor schermbeoordeling. Als u het lettertype en de tekenstijl van een tekenreeks wilt instellen, moet u de tekenreeks van weergegeven tekens voorafzetten met {\style} of {&stijl}. Waar stijl een id is die wordt vermeld in de kolom TextStyle van de tabel TextStyle. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. De volgende informatie wordt gelezen door de hulpprogramma's voor schermbeoordeling als de beschrijving van het besturingselement. Zie Toegankelijkheid.

 

Besturingskenmerken

U kunt de volgende kenmerken gebruiken met dit besturingselement. Als u de waarde van een kenmerk wilt wijzigen met behulp van een gebeurtenis, abonneert u het besturingselement op een ControlEvent in de EventMapping-tabel en vermeldt u de id van het kenmerk in de kolom Kenmerk. Voer de id in van de ControlEvent in de kolom Gebeurtenis.

Kenmerk-id Hexadecimale bit Beschrijving
IndirectPropertyName Naam van een indirecte eigenschap die is gekoppeld aan het besturingselement. Als de bit van het indirecte kenmerk is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Als de bit van het indirecte kenmerk is ingesteld, is deze naam ook de waarde van de eigenschap die wordt vermeld in de kolom Eigenschap van de Control-tabel.
positie Positie van het besturingselement in het dialoogvenster. Voer de breedte, hoogte en coördinaten van het besturingselement in de linkerhoek van het besturingselement in de kolommen Breedte, Hoogte, X en Y van de Control-tabel in. Gebruik installatie-eenheden voor lengte en afstand.
PropertyName- Naam van de eigenschap die aan dit besturingselement is gekoppeld. Als de bit van het indirecte kenmerk niet is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Dit kenmerk wordt opgegeven in de kolom Eigenschap van de Control-tabel.
PropertyValue- Huidige waarde van de eigenschap die door dit besturingselement wordt weergegeven of gewijzigd. Als de indirecte kenmerk-bit niet is ingesteld, is dit de waarde van PropertyName. Als de bit van het indirecte kenmerk is ingesteld, is dit de waarde van IndirectPropertyName. Als het kenmerk wordt gewijzigd, geeft het besturingselement de nieuwe waarde weer.
tekst Hiermee wordt tekst in schermlezers weergegeven op basis van tekst die is ingevoerd in de kolom Tekst van de tabel Control. Zie Toegankelijkheid.
zichtbare 0x00000000 0x00000001
 Verborgen besturingselement. Zichtbaar besturingselement.
Neem deze bit op in het bitwoord van de kolom Kenmerken in de tabel Control om het besturingselement zichtbaar of verborgen te maken.
U kunt een besturingselement ook verbergen of weergeven met behulp van de tabel ControlCondition.
ingeschakelde 0x00000000 0x00000002
 Besturingselement met een uitgeschakelde status. Besturingselement in een ingeschakelde status.
Neem deze bit op in het bitwoord in de kolom Kenmerken van het Besturingselement om het besturingselement bij het maken in te schakelen.
U kunt een besturingselement ook in- of uitschakelen met behulp van de tabel ControlCondition.
0x00000000 0x00000004
 Hiermee wordt de standaardvisualstijl weergegeven. Geeft het besturingselement weer met een gezonken, 3D, look.
Neem deze bits op in het bitwoord in de kolom Kenmerken van de Control-tabel.
indirect 0x00000000 0x00000008
 Het besturingselement geeft de waarde van de eigenschap weer of wijzigt deze in de kolom Eigenschap van de tabel Control. Het besturingselement geeft de waarde weer of wijzigt van de eigenschap met de id die wordt vermeld in de kolom Eigenschap van de tabel Control.
Bepaalt of de eigenschap die aan dit besturingselement is gekoppeld indirect wordt verwezen.
RTLRO- 0x00000000 0x00000020
 Tekst in het besturingselement wordt weergegeven in de leesrichting van links naar rechts. Tekst in het besturingselement wordt weergegeven in de leesrichting van rechts naar links.
rechts uitgelijnde 0x00000000 0x00000040
 Tekst in het besturingselement wordt links uitgelijnd. Tekst in het besturingselement wordt rechts uitgelijnd.
LeftScroll- 0x00000000 0x00000080
 De schuifbalk bevindt zich aan de rechterkant van het besturingselement. De schuifbalk bevindt zich aan de linkerkant van het besturingselement.
BiDi- 0x000000E0 Stel deze waarde in voor een combinatie van de RTLRO-, RightAligneden LeftScroll kenmerken.

 

Opmerkingen

Dit besturingselement kan worden gemaakt op basis van de klasse WC_TREEVIEW met behulp van de functie CreateWindowEx. Het bevat de stijlen WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPen WS_GROUP.

De selectiestructuur wordt alleen ingevuld als de actie CostInitialize en actie CostFinalize zijn aangeroepen.

De volgende tekenreeks in de UIText-tabel is gerelateerd aan dit besturingselement.

Term Beschrijving
AbsentPath
 Het pad dat wordt weergegeven voor een item met de status Afwezig.

 

De volgende zes tekenreeksen worden gebruikt om het aantal geselecteerde onderliggende items en de grootte weer te geven die is gekoppeld aan het gemarkeerde item:

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

De volgende tekenreeksen worden gebruikt om de beschikbare selectieopties voor een item in een pop-upmenu weer te geven:

  • MenuAbsent
  • MenuLocal
  • MenuCD
  • MenuNetwork
  • MenuAllLocal
  • MenuAllCD
  • MenuAllNetwork

De volgende tekenreeksen worden gebruikt om de huidige selectie in de SelectionDescription ControlEvent uit te leggen.

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

De volgende vier gelokaliseerde tekenreeksen worden gebruikt voor het opmaken van de grootte van een bestand:

  • Bytes
  • KB
  • MB
  • GB