Edit-Steuerelement (Windows Installer)

Das Edit-Steuerelement ist ein Bearbeitungsfeld, das einer Eigenschaft mit einem Zeichenfolgen- oder Integerwert zugeordnet ist. Geben Sie den Namen der Eigenschaft in die Spalte „Property“ der Tabelle Control ein.

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 Dies ist der 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 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 Attributbit Indirect festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. 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 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 Spalte TextStyle der Tabelle TextStyle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die DefaultUIFont-Eigenschaft als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Um die Anzahl der Zeichen anzugeben, die Benutzer*innen eingeben können, fügen Sie an alle Schriftartspezifikationen {n} an. Dabei ist „n“ eine positive ganze Zahl.
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-Look an.
Fügen Sie diese Bits in das Bitwort in die Spalte Attributes der Tabelle Control 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.
Integer 0x00000000 0x00000010
Die dem Steuerelement zugeordnete Eigenschaft ist ein Zeichenfolgenwert. Die dem Steuerelement zugeordnete Eigenschaft ist ein ganzzahliger Wert.
Fügen Sie dieses Bit in das Bitwort der Spalte „Attributes“ der Control-Tabelle ein, um dieses Attribut beim Erstellen des Steuerelements festzulegen.
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 auf eine Kombination der Attribute RTLRO, RightAligned und LeftScroll fest.
MultiLine 0x00010000 Erstellt ein Edit-Steuerelement mit mehreren Zeilen und einer vertikalen Scrollleiste. Fügen Sie „65.536“ in das Bitwort in der Spalte „Attributes“ der Tabelle Control ein, um ein mehrzeiliges Edit-Steuerelement mit einer vertikalen Scrollleiste zu erstellen.
Kennwort 0x00200000 Erstellt ein Edit-Steuerelement für die Eingabe von Kennwörtern. Addieren Sie 2.097.152 zum Wert in der Spalte „Attributes“ der Tabelle Control, um ein Edit-Steuerelement zu erstellen, das jedes Zeichen bei der Eingabe in das Steuerelement als Sternchen (*) darstellt. Das Festlegen des Password-Attributs verhindert, dass das Installationsprogramm die dem Edit-Steuerelement zugeordnete Eigenschaft in die Protokolldatei schreibt. Weitere Informationen finden Sie unter Verhindern, dass vertrauliche Informationen in die Protokolldatei geschrieben werden.

Bemerkungen

Dieses Steuerelement kann aus der EDIT-Klasse mit der CreateWindowEx-Funktion erstellt werden. Es verfügt über die Stile WS_BORDER, WS_CHILD, WS_TABSTOP und WS_GROUP.

Sie können die Länge des Texts begrenzen, der eingegeben werden kann, indem Sie eine Zahl zwischen 0 und 2.147.483.646 in geschweiften Klammern am Anfang des Textfelds in der Tabelle Control einfügen. Wenn das Textfeld beispielsweise mit {80} beginnt, ist die Länge der Zeichenfolge auf 80 Zeichen beschränkt. Wenn in der Tabelle kein solcher Grenzwert oder 0 (null) angegeben wurde, wird die Länge auf die maximal mögliche Länge (2.147.483.646 Zeichen) festgelegt. Ein negativer oder nicht numerischer Wert generiert einen Fehler.

Um die Kompatibilität mit Sprachausgaben zu gewährleisten, müssen Sie beim Erstellen eines Dialogfelds mit einem Edit-Steuerelement als erstes aktives Steuerelement das Textfeld, das zum Bearbeitungsfeld gehört, als erstes aktives Steuerelement in der Tabelle Dialog festlegen. Da der Fokus nicht auf statischen Text festgelegt werden kann, hat beim Erstellen des Dialogfelds zunächst wie beabsichtigt das Bearbeitungsfeld den Fokus. Dadurch wird sichergestellt, dass bei der Sprachausgabe die richtigen Informationen verwendet werden.

Die dem Edit-Steuerelement zugeordnete Eigenschaft wird nur festgelegt, wenn das Steuerelement den Fokus verliert. Daher müssen Sie das Steuerelement per TAB-Taste verlassen oder ein anderes Steuerelement auswählen, damit die Eigenschaft aktualisiert wird.