SelectionTree-Steuerelement
Dieses Steuerelement ermöglicht es einem*einer Benutzer*in, den Auswahlstatus der in der Featuretabelle aufgeführten Features zu ändern. Das Steuerelement ist einer Zeichenfolgenwerteigenschaft zugeordnet, die der*die Benutzer*in über ein Durchsuchen-Dialogfeld festlegen kann. Sie können das Steuerelement einer Eigenschaft zuordnen, indem Sie den Namen der Eigenschaft in die Eigenschaft-Spalte der Tabelle „Control“ eingeben.
Das SelectionTree-Steuerelement veröffentlicht automatisch die folgenden Steuerungsereignisse 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 über keine Knoten verfügt, veröffentlicht das Steuerelement diese Ereignisse und löscht den Inhalt der Steuerelemente, die das Ereignis abonnieren. Diese ControlEvents müssen nicht in der Tabelle „ControlEvent“ aufgeführt werden.
| Steuerelementereignis | BESCHREIBUNG |
|---|---|
| SelectionAction | Veröffentlicht eine Zeichenfolge aus der UIText-Tabelle, die das hervorgehobene Element beschreibt. |
| SelectionBrowse | Generiert ein Durchsuchen-Dialogfeld, das zum Ändern des Pfads des hervorgehobenen Elements verwendet wird. |
| SelectionDescription | Veröffentlicht eine Zeichenfolge aus der Featuretabelle, die das hervorgehobene Element beschreibt. |
| SelectionNoItems | Löscht den beschreibenden Text oder deaktiviert die Schaltflächen eines veralteten Elements. |
| SelectionPath | Veröffentlicht den Pfad des hervorgehobenen Elements. |
| SelectionPathOn | Gibt an, ob dem aktuell ausgewählten Feature ein Auswahlpfad zugeordnet ist oder nicht. |
| SelectionSize | Veröffentlicht die Größe des hervorgehobenen Elements. |
Ab den 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.
| Steuerelementereignis | 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 benutzerdefinierte Aktionen ausführt, die in der ControlEvent-Tabelle aufgeführt sind. Das SelectionTree-Steuerelement veröffentlicht dieses Ereignis immer dann, wenn sich die Featureauswahl im Steuerelement ändert oder wenn ein anderer Auswahlstatus für das aktuelle Feature ausgewählt wird. Die benutzerdefinierten Aktionen werden jedes Mal ausgeführt, wenn das Ereignis veröffentlicht wird. 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.
| Eigenschaft | BESCHREIBUNG |
|---|---|
| MsiSelectionTreeSelectedFeature | Der Name des ausgewählten Features im Feature-Feld 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 Bytes. |
| MsiSelectionTreeChildrenCost | Kosten für die Installation aller untergeordneten Features in Einheiten von 512 Bytes. |
| MsiSelectionTreeSelectedPath | Pfad, in dem das ausgewählte Feature installiert wird. Wird nur definiert, wenn das Feature als INSTALLSTATE_LOCAL installiert wird. |
Hinweis
Der Inhalt des Textfelds der Control-Tabelle wird vom SelectionTree-Steuerelement nie angezeigt. Dieses Feld gibt stattdessen den Textstil an, der vom Steuerelement angezeigt werden soll, und enthält eine Beschreibung des Steuerelements, das von den Lesehilfen verwendet wird. Um die Schriftart und den Schriftstil einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der TextStyle-Spalte der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die DefaultUIFont-Eigenschaft als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Die folgenden Informationen werden von Lesehilfen als Beschreibung des Steuerelements gelesen. Siehe Barrierefreiheit.
Steuerelementattribute
Sie können die folgenden Attribute mit diesem Steuerelement verwenden. Um den Wert eines Attributs mithilfe eines Ereignisses zu ändern, abonnieren Sie das Steuerelement für ein ControlEvent in der EventMapping-Tabelle , und listen Sie den Bezeichner des Attributs in der Spalte Attribut auf. Geben Sie den Bezeichner von ControlEvent in die Spalte Ereignis ein.
| Attributbezeichner | Hexadezimales Bit | BESCHREIBUNG |
|---|---|---|
| IndirectPropertyName | Der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Indirect-Attributbit festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert ihn. Wenn das indirekte Attributbit festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte Property der Tabelle Control aufgeführt ist. | |
| Position | Position des Steuerelements im Dialogfeld. Geben Sie Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten „Width“, „Height“, „X“ und „Y“ der Tabelle Control ein. Verwenden Sie Installationseinheiten für Länge und Entfernung. |
|
| PropertyName | Der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Indirect-Attributbit nicht gesetzt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen entsprechend. Dieses Attribut wird in der Spalte Property der Tabelle Control angegeben. | |
| PropertyValue | Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Attributbit Indirect nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Attributbit Indirect festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, spiegelt das Steuerelement den neuen Wert wider. | |
| Text | Zeigt Text in Sprachausgaben entsprechend dem in der Text-Spalte der Tabelle Control eingegebenen Text an. Siehe Barrierefreiheit. | |
| Visible | 0x00000000 0x00000001 |
Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit in das Bitwort der Spalte Attributes in der Tabelle Control ein, damit das Steuerelement bei seiner Erstellung sichtbar oder ausgeblendet wird. Sie können ein Steuerelement auch mithilfe der Tabelle ControlCondition ausblenden oder anzeigen. |
| Aktiviert | 0x00000000 0x00000002 |
Steuerelement in einem deaktivierten Zustand. Steuerelement in einem aktivierten Zustand. Fügen Sie dieses Bit in das Bitwort in die Spalte Attributes der Tabelle Control ein, um das Steuerelement bei der Erstellung zu aktivieren. Sie können ein Steuerelement auch mithilfe der Tabelle ControlCondition aktivieren oder deaktivieren. |
| Sunken | 0x00000000 0x00000004 |
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem vertieften 3D-Effekt an. Fügen Sie diese Bits in das Bitwort in die Attributes-Spalte der Control-Tabelle ein. |
| Indirekt | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte Property der Tabelle Control an oder ändert diese. Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte Property der Tabelle Control an oder ändert diesen. Bestimmt, ob indirekt auf die diesem Steuerelement zugeordnete Eigenschaft verwiesen wird. |
| RTLRO | 0x00000000 0x00000020 |
Text im Steuerelement wird in der Leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in der Leserichtung von rechts nach links angezeigt. |
| RightAligned | 0x00000000 0x00000040 |
Text im Steuerelement wird links ausgerichtet. Text im Steuerelement wird rechts ausgerichtet. |
| LeftScroll | 0x00000000 0x00000080 |
Die Scrollleiste befindet sich auf der rechten Seite des Steuerelements. Die Scrollleiste befindet sich auf der linken Seite des Steuerelements. |
| BiDi | 0x000000E0 | Legen Sie diesen Wert für eine Kombination der Attribute RTLRO, RightAligned und LeftScroll fest. |
Bemerkungen
Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der WC_TREEVIEW-Klasse erstellt werden. Es verfügt über die Stile WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOP und WS_GROUP.
Die Auswahlstruktur wird nur aufgefüllt, wenn die Aktionen CostInitialize und CostFinalize aufgerufen wurden.
Die folgende Zeichenfolge in der UIText-Tabelle bezieht sich auf dieses Steuerelement.
| Begriff | BESCHREIBUNG |
|---|---|
| AbsentPath |
Der Pfad, der für ein Element im Zustand „Nicht vorhanden“ 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 vorhandene Auswahl im ControlEvent SelectionDescription zu erläutern.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Die folgenden vier lokalisierten Zeichenfolgen werden verwendet, um die Größe einer Datei zu formatieren:
- Byte
- KB
- MB
- GB
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für