Freigeben über

SelectionTree-Steuerelement

  • Artikel

Mit diesem Steuerelement kann ein Benutzer den Auswahlstatus der Features ändern, die in der Featuretabelleaufgeführt sind. Das Steuerelement ist einer Zeichenfolgeneigenschaft zugeordnet, die der Benutzer durch ein dialogfeld Durchsuchenfestlegen kann. Sie können das Steuerelement einer Eigenschaft zuordnen, indem Sie den Namen der Eigenschaft in die Spalte "Eigenschaft" der Steuerelementtabelleeingeben.

Das SelectionTree-Steuerelement veröffentlicht automatisch die folgenden Steuerelementereignisse unter Windows XP oder früheren Betriebssystemen. Das SelectionTree-Steuerelement veröffentlicht diese Ereignisse, wenn das ausgewählte Element von einem Knoten in einen anderen geändert wird. Wenn die Auswahlstruktur keine Knoten aufweist, veröffentlicht das Steuerelement diese Ereignisse und löscht den Inhalt von Steuerelementen, die das Ereignis abonnieren. Diese ControlEvents müssen nicht in der ControlEvent-Tabelleaufgeführt werden.

Control-Ereignis Beschreibung
SelectionAction- Veröffentlicht eine Zeichenfolge aus der UIText-Tabelle beschreiben das hervorgehobene Element.
SelectionBrowse- Generiert ein Dialogfeld zum Durchsuchen, das zum Ändern des Pfads des hervorgehobenen Elements verwendet wird.
SelectionDescription- Veröffentlicht eine Zeichenfolge aus der Featuretabelle beschreiben das hervorgehobene Element.
SelectionNoItems- Löscht den beschreibenden Text oder deaktiviert die Schaltflächen eines veralteten Elements.
SelectionPath- Veröffentlicht den Pfad für das hervorgehobene Element.
SelectionPathOn- Veröffentlicht, ob es einen Auswahlpfad gibt, der dem aktuell ausgewählten Feature zugeordnet ist.
SelectionSize- Veröffentlicht die Größe des hervorgehobenen Elements.

 

Ab windows Server 2003-Systemen veröffentlichen SelectionTree-Steuerelemente alle Ereignisse in der obigen Tabelle und veröffentlichen darüber hinaus ein DoAction ControlEvent oder ein SetProperty ControlEvent. Datensätze müssen der ControlEvent-Tabelle hinzugefügt werden, um DoAction oder SetProperty ControlEvents zu veröffentlichen.

Control-Ereignis Beschreibung
DoAction- Benachrichtigt das Installationsprogramm, eine benutzerdefinierte Aktion auszuführen.
SetProperty- Legt eine Eigenschaft auf einen neuen Wert fest.

 

Ab Windows Installer Version 3.0 veröffentlichen SelectionTree-Steuerelemente ein Ereignis, das benutzerdefinierten Aktionen ausführt, in der ControlEvent-Tabelleaufgeführt sind. Das SelectionTree-Steuerelement veröffentlicht dieses Ereignis, wenn sich die Featureauswahl im Steuerelement ändert oder wenn ein anderer Auswahlstatus für das aktuelle Feature ausgewählt wird. Die benutzerdefinierten Aktionen werden bei jeder Veröffentlichung des Ereignisses ausgeführt. Das SelectionTree-Steuerelement sendet Informationen an die benutzerdefinierte Aktion, indem die Werte der folgenden Eigenschaften festgelegt werden. Alle diese Eigenschaften werden gelöscht, wenn das SelectionTree-Steuerelement geschlossen wird.

Windows Installer 2.0: Nicht unterstützt. Das SelectionTree-Steuerelement veröffentlicht das Ereignis nicht und legt die folgenden Eigenschaften nicht fest.

Eigentum Beschreibung
MsiSelectionTreeSelectedFeature Der Name des ausgewählten Features im Feld "Feature" der Featuretabelle.
MsiSelectionTreeSelectedAction Der Installationsaktionsstatus des ausgewählten Features. Der Wert kann INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE oder INSTALLSTATE_ADVERTISED sein.
MsiSelectonTreeChildrenCount Anzahl der direkten untergeordneten Knoten.
MsiSelectionTreeInstallingChildrenCount Anzahl der direkten untergeordneten Knoten, die INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE oder INSTALLSTATE_ADVERTISED sind.
MsiSelectionTreeSelectedCost Kosten für die Installation des ausgewählten Features in Einheiten von 512 Byte.
MsiSelectionTreeChildrenCost Kosten für die Installation aller untergeordneten Features in Einheiten von 512 Byte.
MsiSelectionTreeSelectedPath Pfad, in dem das ausgewählte Feature installiert wird. Wird nur definiert, wenn das Feature als INSTALLSTATE_LOCAL installiert wird.

 

Anmerkung

Der Inhalt des Textfelds der Steuerelementtabelle wird nie vom SelectionTree-Steuerelement angezeigt. Stattdessen gibt dieses Feld das Format des Texts an, der vom Steuerelement angezeigt werden soll, und enthält eine Beschreibung des Steuerelements, das von Bildschirmüberprüfungsprogrammen verwendet wird. Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&Formatvorlage}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet. Die folgenden Informationen werden von Bildschirmüberprüfungsprogrammen als Beschreibung des Steuerelements gelesen. Siehe Barrierefreiheit.

 

Steuerelementattribute

Mit diesem Steuerelement können Sie die folgenden Attribute verwenden. Um den Wert eines Attributs mithilfe eines Ereignisses zu ändern, abonnieren Sie das Steuerelement in der EventMapping-Tabelle und listen Sie den Bezeichner des Attributs in der Attributspalte auf. Geben Sie den Bezeichner des ControlEvent in der Spalte "Ereignis" ein.

Attributkennzeichen Hexadezimales Bit Beschreibung
IndirectPropertyName Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Wenn das Bit des indirekten Attributs festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte "Eigenschaft" der Steuerelementtabelleaufgeführt ist.
Position Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten Breite, Höhe, X und Y der Steuerelementtabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung.
PropertyName- Der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs nicht festgelegt ist, wird der Wert der Eigenschaft mit diesem Namen angezeigt oder geändert. Dieses Attribut wird in der Eigenschaftsspalte der Steuerelementtabelleangegeben.
PropertyValue- Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Bit des indirekten Attributs nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Attribut "Indirect" festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, gibt das Steuerelement den neuen Wert wieder.
Zeigt Text in Bildschirmleseprogramme entsprechend dem Text an, der in die Textspalte der Steuerelementtabelleeingegeben wird. Siehe Barrierefreiheit.
Sichtbaren 0x00000000 0x00000001
 Ausgeblendetes Steuerelement. Sichtbares Steuerelement.
Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" in die Steuerelementtabelle ein,, um das Steuerelement bei der Erstellung sichtbar oder ausgeblendet zu machen.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleausblenden oder anzeigen.
Aktivierte 0x00000000 0x00000002
 Steuerelement in einem deaktivierten Zustand. Steuerelement in einem aktivierten Zustand.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des -Steuerelements ein,, um das Steuerelement beim Erstellen zu aktivieren.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleaktivieren oder deaktivieren.
sunken 0x00000000 0x00000004
 Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem versonnenen 3D-Look an.
Fügen Sie diese Bits in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein.
Indirekte 0x00000000 0x00000008
 Das Steuerelement zeigt den Wert der Eigenschaft in der Eigenschaftsspalte der Steuerelementtabellean oder ändert sie. Das Steuerelement zeigt den Wert der Eigenschaft an, die den Bezeichner enthält, der in der Spalte "Eigenschaft" der Steuerelementtabelle aufgeführt ist.
Bestimmt, ob auf die diesem Steuerelement zugeordnete Eigenschaft indirekt verwiesen wird.
RTLRO- 0x00000000 0x00000020
 Text im Steuerelement wird in leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in leserichtung von rechts nach links angezeigt.
RightAligned- 0x00000000 0x00000040
 Text im Steuerelement wird linksbündig ausgerichtet. Text im Steuerelement wird rechtsbündig ausgerichtet.
LeftScroll- 0x00000000 0x00000080
 Die Bildlaufleiste befindet sich auf der rechten Seite des Steuerelements. Die Bildlaufleiste befindet sich auf der linken Seite des Steuerelements.
BiDi- 0x000000E0 Legen Sie diesen Wert für eine Kombination der attribute RTLRO, RightAlignedund LeftScroll fest.

 

Bemerkungen

Dieses Steuerelement kann über die WC_TREEVIEW Klasse mithilfe der CreateWindowEx--Funktion erstellt werden. Es verfügt über die Formatvorlagen WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPund WS_GROUP.

Die Auswahlstruktur wird nur ausgefüllt, wenn die CostInitialize-Aktion und CostFinalize- Aktion aufgerufen wurde.

Die folgende Zeichenfolge in der UIText-Tabelle ist mit diesem Steuerelement verknüpft.

Ausdruck Beschreibung
AbsentPath
 Der Pfad, der für ein Element im fehlenden Zustand angezeigt wird.

 

Die folgenden sechs Zeichenfolgen werden verwendet, um die Anzahl der ausgewählten untergeordneten Elemente und die größe anzuzeigen, die dem hervorgehobenen Element zugeordnet ist:

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

Die folgenden Zeichenfolgen werden verwendet, um die verfügbaren Auswahloptionen für ein Element in einem Popupmenü anzuzeigen:

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

Die folgenden Zeichenfolgen werden verwendet, um die vorliegende Auswahl im SelectionDescription ControlEvent zu erläutern.

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

Die folgenden vier lokalisierten Zeichenfolgen werden beim Formatieren der Größe einer Datei verwendet:

  • Bytes
  • KB
  • MB
  • GB