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