Steuerelement bearbeiten (Windows Installer)

Das Edit-Steuerelement ist ein Bearbeitungsfeld, das einer Zeichenfolgen- oder ganzzahligen Werteigenschaft zugeordnet ist. Geben Sie den Namen der Eigenschaft in die Property -Spalte der Control-Tabelleein.

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 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 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 Dies ist der 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 Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen { \ style} oder {&Style} voran. Wobei style ein Bezeichner ist, der in der TextStyle-Spalte der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, die DefaultUIFont-Eigenschaft jedoch als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Um die Anzahl der Zeichen anzugeben, die der Benutzer eingeben kann, fügen Sie {n} nach beliebigen Schriftartspezifikationen an. Wobei n eine positive ganze Zahl ist.
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 im 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-Tabelleaktivieren oder deaktivieren.
Sunken 0x00000000 0x00000004
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem eingesenkten 3D-Look an.
Schließen Sie diese Bits in das Bitwort in die Attributes -Spalte der Control-Tabelleein.
Indirekt 0x00000000 0x00000008
Das -Steuerelement zeigt den Wert der -Eigenschaft in der Property -Spalte der Control-Tabellean oder ändert sie. Das Steuerelement zeigt den Wert der Eigenschaft an, deren 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.
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 Attribute der Control-Tabelle ein, um dieses Attribut bei der Erstellung des Steuerelements festzulegen.
RTLRO 0x00000000 0x00000020
Text im Steuerelement wird in der Lesereihenfolge von links nach rechts angezeigt. Text im -Steuerelement wird in der Lesereihenfolge von rechts nach links angezeigt.
RightAligned 0x00000000 0x00000040
Der Text im -Steuerelement wird links ausgerichtet. Der 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.
Mehrzeiligen 0x00010000 Erstellt ein Bearbeitungssteuerelement mit mehreren Zeilen mit einer vertikalen Bildlaufleiste. Schließen Sie 65536 in das Bitwort in die Spalte Attribute des Steuerelements ein, um ein Steuerelement für die Bearbeitung mehrerer Zeilen mit einer vertikalen Bildlaufleiste zu erstellen.
Kennwort 0x00200000 Erstellt ein Bearbeitungssteuerelement für die Eingabe von Kennwörtern. Fügen Sie dem Wert in der Spalte Attribute der Control-Tabelle 2097152 hinzu, um ein Bearbeitungssteuerelement zu erstellen, das jedes Zeichen als Sternchen () anzeigt, * wenn sie in das Steuerelement eingegeben werden. Durch Festlegen des Kennwortattributs wird verhindert, dass das Installationsprogramm die dem Steuerelement Bearbeiten zugeordnete Eigenschaft in die Protokolldatei schreibt. Weitere Informationen finden Sie unter Verhindern, dass vertrauliche Informationen in die Protokolldatei geschrieben werden.

Bemerkungen

Dieses Steuerelement kann mithilfe der CreateWindowEx-Funktion aus der EDIT-Klasse erstellt werden. Sie verfügt über die Stile WS _ BORDER, WS _ CHILD, WS _ TABSTOP und WS _ GROUP.

Die Länge von Text, der eingegeben werden kann, kann begrenzt werden, indem eine Zahl von 0 bis 2147483646 in geschweiften Klammern am Anfang des Textfelds in der Control-Tabelleangegeben wird. Wenn das Textfeld beispielsweise mit beginnt, {80} ist die Länge der Zeichenfolge auf 80 Zeichen beschränkt. Wenn kein solcher Grenzwert in der Tabelle angegeben wird oder 0 angegeben ist, wird die Länge auf das maximal mögliche Limit (2147483646 Zeichen) festgelegt. Ein negativer oder nicht numerischer Wert generiert einen Fehler.

Aus Gründen der Kompatibilität mit Sprachausgaben müssen Sie beim Erstellen eines Dialogfelds mit einem Bearbeitungssteuerelement als erstes aktives Steuerelement das Textfeld, das zum Bearbeitungsfeld gehört, als erstes aktives Steuerelement in der Dialogtabellefestlegen. Da der statische Text nicht den Fokus erhalten kann, hat das Bearbeitungsfeld beim Erstellen des Dialogfelds den Fokus zunächst wie vorgesehen, aber dadurch wird sichergestellt, dass die Sprachausgaben die richtigen Informationen anzeigen.

Die dem Edit-Steuerelement zugeordnete Eigenschaft wird nur festgelegt, wenn das Steuerelement den Fokus verliert. Aus diesem Grund müssen Sie im Steuerelement eine Registerkarte auswählen oder ein anderes Steuerelement auswählen, damit die Eigenschaft aktualisiert wird.