SelectionTree-Steuerelement
Mit diesem Steuerelement kann ein Benutzer den Auswahlstatus der in der Featuretabelleaufgeführten Features ändern. Das -Steuerelement ist einer Zeichenfolgenwerteigenschaft zugeordnet, die der Benutzer über das Dialogfeld Durchsuchenfestlegen kann. Sie können das Steuerelement einer Eigenschaft zuordnen, indem Sie den Namen der Eigenschaft in der Property -Spalte der Control-Tabelleeingeben.
Das SelectionTree-Steuerelement veröffentlicht automatisch die folgenden Steuerelementereignisse auf Windows XP oder früheren Betriebssystemen. Das SelectionTree-Steuerelement veröffentlicht diese Ereignisse, wenn das ausgewählte Element von einem Knoten auf einen anderen geändert wird. Wenn die Auswahlstruktur keine Knoten enthält, veröffentlicht das Steuerelement diese Ereignisse und löscht den Inhalt der Steuerelemente, die das Ereignis abonnieren. Diese ControlEvents müssen nicht in der ControlEvent-Tabelleaufgeführt werden.
| Steuerungsereignis | BESCHREIBUNG |
|---|---|
| SelectionAction | Veröffentlicht eine Zeichenfolge aus der UIText-Tabelle, die das hervorgehobene Element beschreibt. |
| SelectionBrowse | Generiert ein Dialogfeld Durchsuchen, in dem der Pfad des hervorgehobenen Elements geändert 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 für das hervorgehobene Element. |
| SelectionPathOn | Veröffentlicht, ob dem aktuell ausgewählten Feature ein Auswahlpfad zugeordnet ist. |
| 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 zusätzlich 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.
| Steuerungsereignis | 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-Tabelleaufgeführt sind. Das SelectionTree-Steuerelement veröffentlicht dieses Ereignis immer dann, wenn sich die Funktionsauswahl im Steuerelement ändert oder wenn ein anderer Auswahlzustand 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: Wird 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 Feld Feature der Tabelle Feature. |
| 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, unter dem das ausgewählte Feature installiert wird. Wird nur definiert, wenn das Feature als INSTALLSTATE LOCAL installiert _ wird. |
Hinweis
Der Inhalt des Felds Text der Control-Tabelle wird nie vom SelectionTree-Steuerelement angezeigt. Stattdessen gibt dieses Feld den Textstil an, der vom Steuerelement angezeigt werden soll, und enthält eine Beschreibung des Steuerelements, das von Bildschirmüberprüfungs-Hilfsprogrammen verwendet wird. Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen { \ style} oder {&Format} voran. Wobei style ein Bezeichner ist, der in der TextStyle-Spalte der TextStyle-Tabelleaufgeführt ist. Wenn keines davon vorhanden ist, die DefaultUIFont-Eigenschaft jedoch als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Die folgenden Informationen werden von Bildschirmüberprüfungs-Hilfsprogrammen als Beschreibung des Steuerelements gelesen. Weitere Informationen finden Sie unter 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 Attribute auf. Geben Sie den Bezeichner des ControlEvent in der Spalte Ereignis ein.
| Attributbezeichner | Hexadezimalbit | BESCHREIBUNG |
|---|---|---|
| IndirectPropertyName | Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Indirekte Attributbit festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Wenn das Indirekte Attributbit festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Property -Spalte der Control-Tabelleaufgeführt ist. | |
| Position | Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten Width, Height, X und Y der Control-Tabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung. |
|
| PropertyName | Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Indirekte Attributbit nicht festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Dieses Attribut wird in der Property -Spalte der Control-Tabelleangegeben. | |
| PropertyValue | Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Indirekte Attributbit nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Indirekte Attributbit festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, spiegelt das Steuerelement den neuen Wert wider. | |
| Text | Zeigt Text in Screenreadern entsprechend dem Text an, der in die Text -Spalte der Control-Tabelleeingegeben wurde. Weitere Informationen finden Sie unter Barrierefreiheit. | |
| Visible | 0x00000000 0x00000001 |
Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit in das Bitwort der Attributes -Spalte in die Control-Tabelle ein, um das Steuerelement beim Erstellen sichtbar oder ausgeblendet zu machen. Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleausblenden 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 Attribute des Steuerelements ein, um das Steuerelement bei der Erstellung zu aktivieren. Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelle aktivieren oder deaktivieren. |
| Sunken | 0x00000000 0x00000004 |
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem versenkten 3D-Look an. Schließen Sie diese Bits in das Bitwort in die Spalte Attribute der Control-Tabelle ein. |
| Indirekt | 0x00000000 0x00000008 |
Das -Steuerelement zeigt den Wert der -Eigenschaft in der Property -Spalte der Control-Tabellean oder ändert diesen. Das -Steuerelement zeigt den Wert der Eigenschaft an, in der der Bezeichner in der Spalte Eigenschaft der Control-Tabelle aufgeführt ist, oder ändert diesen. Bestimmt, ob indirekt auf die diesem Steuerelement zugeordnete Eigenschaft verwiesen wird. |
| RTLRO | 0x00000000 0x00000020 |
Text im Steuerelement wird in der Lese reihenfolge von links nach rechts angezeigt. Text im Steuerelement wird in der Lese reihenfolge 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 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, RightAlignedund LeftScroll fest. |
Hinweise
Dieses Steuerelement kann mithilfe der CreateWindowEx-Funktion aus der WC _ TREEVIEW-Klasse erstellt werden. Sie verfügt über die Formate 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 Aktion CostInitialize und die Aktion 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 fehlenden Zustand angezeigt wird. |
Die folgenden sechs Zeichenfolgen werden verwendet, um die Anzahl der ausgewählten unteren Elemente und die dem hervorgehobenen Element zugeordnete Größe anzuzeigen:
- 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 aktuelle Auswahl im SelectionDescription ControlEvent zu erläutern.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Die folgenden vier lokalisierten Zeichenfolgen werden zum Formatieren der Größe einer Datei verwendet:
- Byte
- KB
- MB
- GB