Steuerelement bearbeiten (Windows Installer)
Das Bearbeitungssteuerelement ist ein Bearbeitungsfeld, das einer Zeichenfolgen- oder ganzzahligen Werteigenschaft zugeordnet ist. Geben Sie den Namen der Eigenschaft in die Spalte "Eigenschaft" der Steuerelementtabelleein.
Steuerelementattribute
Mit diesem Steuerelement können Sie die folgenden Attribute verwenden. Um den Wert eines Attributs mithilfe eines Ereignisses zu ändern, abonnieren Sie das Steuerelement in der EventMapping-Tabelle und listen Sie den Bezeichner des Attributs in der Attributspalte auf. Geben Sie den Bezeichner des ControlEvent in der Spalte "Ereignis" ein.
| Attributkennzeichen | Hexadezimales Bit | Beschreibung |
|---|---|---|
| IndirectPropertyName | Dies ist der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Wenn das Bit des indirekten Attributs festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte "Eigenschaft" der Steuerelementtabelleaufgeführt ist. | |
| Position | Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten Breite, Höhe, X und Y der Steuerelementtabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung. |
|
| PropertyName- | Dies ist der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs nicht festgelegt ist, wird der Wert der Eigenschaft mit diesem Namen angezeigt oder geändert. Dieses Attribut wird in der Eigenschaftsspalte der Steuerelementtabelleangegeben. | |
| PropertyValue- | Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Bit des indirekten Attributs nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Attribut "Indirect" festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, gibt das Steuerelement den neuen Wert wieder. | |
| Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&style}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet. Um die Anzahl der Zeichen anzugeben, die der Benutzer eingeben kann, fügen Sie {n} nach allen Schriftartspezifikationen an. Dabei ist n eine positive ganze Zahl. |
||
| Sichtbaren | 0x00000000 0x00000001 |
Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" in die Steuerelementtabelle ein,, um das Steuerelement bei der Erstellung sichtbar oder ausgeblendet zu machen. Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleausblenden oder anzeigen. |
| Aktivierte | 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 beim Erstellen 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 versonnenen, 3D-Look an. Fügen Sie diese Bits in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein. |
| Indirekte | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Eigenschaftsspalte der Steuerelementtabellean oder ändert sie. Das Steuerelement zeigt den Wert der Eigenschaft an, die den Bezeichner enthält, der in der Spalte "Eigenschaft" der Steuerelementtabelle aufgeführt ist. Bestimmt, ob auf die diesem Steuerelement zugeordnete Eigenschaft indirekt verwiesen wird. |
| ganze Zahl | 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 Steuerelementtabelle ein,, um dieses Attribut beim Erstellen des Steuerelements festzulegen. |
| RTLRO- | 0x00000000 0x00000020 |
Text im Steuerelement wird in leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in leserichtung 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 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. |
| MultiLine- | 0x00010000 | Erstellt ein Steuerelement zum Bearbeiten mehrerer Zeilen mit einer vertikalen Bildlaufleiste. Schließen Sie 65536 in das Bitwort in die Spalte "Attribute" des Steuerelements ein, um ein Steuerelement für mehrere Zeilenbearbeitung mit einer vertikalen Bildlaufleiste zu erstellen. |
| Kennwort | 0x00200000 | Erstellt ein Bearbeitungssteuerelement zum Eingeben von Kennwörtern. Fügen Sie 2097152 dem Wert in der Spalte "Attribute" der Steuerelementtabelle hinzu, um ein Bearbeitungssteuerelement zu erstellen, das jedes Zeichen als Sternchen (*) anzeigt, während sie in das Steuerelement eingegeben werden. Durch Festlegen des Kennwortattributs wird verhindert, dass das Installationsprogramm die dem Bearbeitungssteuerelement 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. Es verfügt über die Formatvorlagen WS_BORDER, WS_CHILD, WS_TABSTOPund WS_GROUP.
Die Textlänge, die eingegeben werden kann, kann begrenzt werden, indem eine Zahl von 0 bis 2147483646 in geschweiften Klammern am Anfang des Textfelds in der Steuerelementtabelleeingefügt wird. Wenn das Textfeld beispielsweise mit {80}beginnt, ist die Länge der Zeichenfolge auf 80 Zeichen begrenzt. Wenn in der Tabelle kein solcher Grenzwert angegeben wird oder 0 angegeben ist, wird die Länge auf die maximal mögliche Länge (2147483646 Zeichen) festgelegt. Ein negativer oder nicht numerischer Wert generiert einen Fehler.
Aus Gründen der Kompatibilität mit Bildschirmsprachausgaben müssen Sie beim Erstellen eines Dialogfelds mit einem Bearbeitungssteuerelement als erstes aktives Steuerelement das Textfeld festlegen, das zum Bearbeitungsfeld gehört, zum ersten aktiven Steuerelement in der Dialogtabelle. Da der statische Text den Fokus nicht übernehmen kann, hat das Bearbeitungsfeld beim Erstellen des Bearbeitungsfelds den Fokus anfangs wie beabsichtigt, stellt jedoch sicher, dass Bildschirmsprachausgaben die richtigen Informationen anzeigen.
Die dem Bearbeitungssteuerelement zugeordnete Eigenschaft wird nur festgelegt, wenn das Steuerelement den Fokus verliert. Daher müssen Sie über das Steuerelement tabstoppen oder ein anderes Steuerelement auswählen, damit die Eigenschaft aktualisiert werden soll.