Integer

Das Element 'Integer' erstellt ein Feld, in dem ein Benutzer einen Zahlenwert anzeigen oder eingeben kann.

Datenbindung

Sie können die Datenbindung für das Steuerelement 'Integer' in der Eigenschaftsregisterkarte für Allgemein festlegen oder ändern. Das Steuerelement ist an eine Variable Integer gebunden.

Konfigurationseigenschaften

Sie können Konfigurationseigenschaften für das Steuerelement 'Integer' über die Eigenschaftsregisterkarte für Konfiguration festlegen oder ändern (z. B. Darstellungs- und Verhaltenseigenschaften). Legen Sie auf der Registerkarte Ereignisse die Formelkonfiguration fest.

Anzeigegröße: Eine Konfigurationseigenschaft mit dem Symbol für Anzeigegrößen neben dem Namen der Eigenschaft kann verschiedene Werte für die einzelnen Anzeigegrößen aufweisen. Wenn Sie keinen Wert festlegen, wird der Wert der nächstgrößeren Anzeigegröße als Standardwert für die Anzeigegröße übernommen. Wenn Sie den Process Designer-Desktopeditor (veraltet) verwenden, legen Sie den Wert für die große Anzeigegröße fest. Alle anderen Anzeigegrößen übernehmen diesen Wert.

Motivdefinitionen: Motivdefinitionen geben die Farben und Stile für ein Steuerelement an und bestimmen die Darstellung des Steuerelements. Sie können den Look-and-feel von Steuerelementen im Motiv-Editor voranzeigen. Weitere Informationen finden Sie unter Motive.

Die Darstellungskonfigurationseigenschaften für das Steuerelement 'Integer' werden in der folgenden Tabelle aufgeführt:

Tabelle 1. Darstellungskonfigurationseigenschaften für das Element 'Integer'
Darstellungskonfigurationseigenschaft	Beschreibung	Datentyp
Breite	Die Breite des Steuerelements. Sie können die Breite in px (Pixel), in % (Prozent) oder in em-Einheiten angeben. Beispiele: 50 px, 20 % oder 0,4 em. Wenn kein Einheitentyp angegeben ist, wird px angenommen.	`String`
Größenstil	Die Größe des Texts in dem Steuerelement.	`String`
Bezeichnungsplatzierung	Die Bezeichnungsplatzierung für dieses Steuerelement. Eine Platzierung auf der linken Seite ändert die angegebene Breite des Steuerelements.	`String`

Die Verhaltenskonfigurationseigenschaften für das Steuerelement 'Integer' werden in der folgenden Tabelle aufgeführt:

Tabelle 2. Verhaltenskonfigurationseigenschaften für das Element 'Integer'
Verhaltenskonfigurationseigenschaft	Beschreibung	Datentyp
Tabulatorindex	Der Tabulatorsequenzindex. Tabulatorindizes beginnen bei 1 und dürfen auch vereinzelt festgelegt werden. Sie können beispielsweise 1, 5 oder 10 verwenden. Die Eigenschaft 'Tabulatorindex' steuert die Tabulatorsequenz, wenn Sie durch Drücken der Tabulatortaste zwischen Coach-Bereichen wechseln.	`Integer`
Platzhaltertext	Der Platzhaltertext, der angezeigt wird, wenn kein Wert eingegeben wurde.	`String`
Numerische Formatierung	Bestimmt, ob das Tausendertrennzeichen auf den Ländereinstellungen des aktuellen Benutzers basiert oder als angepasste Konfigurationsoption angegeben werden soll. Die verfügbaren Optionen sind Automatisch und Angepasst.	`String`
Tausendertrennzeichen ausblenden	Blendet das Tausendertrennzeichen aus. Standardmäßig ist diese Option nicht ausgewählt.	`Boolean`
Tausendertrennzeichen	Trennt die Tausender in Zifferngruppen. Gängige Tausendertrennzeichen im englischen Sprachraum sind Kommas. Abhängig von der Benutzerländereinstellung können andere Symbole wie im deutschen Sprachraum übliche Punkte oder benutzerdefinierte Zeichen als Tausendertrennzeichen verwendet werden.	`String`
Präfix	Ein Symbol, das dem numerischen Eingabewert vorangestellt wird.	`String`
Erweiterung	Ein Symbol, das dem numerischen Eingabewert nachgestellt wird.	`String`

Beispiel

Um die Formatierung einer ganzen Zahl anzugeben, die Sie in Ihrem Coach anzeigen möchten, fügen Sie ein Steuerelement 'Integer' zum Coach-Layout hinzu und legen dessen Konfigurationseigenschaften wir folgt fest:

Stellen Sie unter Darstellung den Größenstil auf Standard und die Bezeichnungsplatzierung auf Oben ein.
Stellen Sie unter Verhalten das Tausendertrennzeichen auf , (Komma) und das Präfix auf $ ein.
Speichern Sie die Änderungen.

Als Ergebnis des Eingabewerts 1500 wird $1,500 angezeigt.

Ereignisse

Auf der Registerkarte Ereignisse können Sie Formelkonfigurationseigenschaften und die Ereignishandler für das Steuerelement festlegen oder ändern. Sie können Ereignisse festlegen, die programmgesteuert ausgelöst werden sollen oder wenn ein Benutzer mit dem Steuerelement interagiert. Informationen dazu, wie Codeereignisse definiert werden, finden Sie im Abschnitt Benutzerdefinierte Ereignisse.

Die Formelkonfigurationseigenschaften für das Steuerelement 'Integer' werden in der folgenden Tabelle aufgeführt:

Tabelle 3. Formelkonfigurationseigenschaften für das Element 'Integer'
Formelkonfigurationseigenschaft	Beschreibung	Datentyp
Wertformel	Die Formel, die angibt, wie der Wert im Steuerelement angezeigt werden soll. Sie können statische `String`-Werte oder Formeln oder Aggregatfunktionen verwenden. Weitere Informationen zu Formeln finden Sie unter Formeln.	`String`

Das Steuerelement 'Integer' verfügt über die folgenden Typen von Ereignishandlern:

Bei Laden: Aktivierung erfolgt beim Laden der Seiten. Beispiel:
```
me.setValue(0.00);
```
Bei Änderung: Aktivierung erfolgt, wenn der Wert sich ändert. Beispiel:
```
${Decimal1}.setValue(oldValue); ${Decimal2}.setValue(newValue);
```
Bei Fokus: Aktivierung erfolgt, wenn der Fokus auf das Feld für ganze Zahlen gerichtet wird. Beispiel:
```
${Tooltip1}.setTooltipVisible(true)
```
Bei Verwischen: Aktivierung erfolgt, wenn das Ganzzahlfeld den Fokus verliert. Beispiel:
```
${Tooltip1}.setTooltipVisible(false);
```
Bei Formatierung: Aktivierung erfolgt, wenn der Benutzer eine angepasste Formatierung auf die Eingabewerte anwendet. Die Formatierung basiert auf dem return-Wert der Anweisung. Beispiel:
```
var neg = me.getValue() < 0; if (neg){return "(" + formattedValue + ")"}
```

Abhängig vom jeweiligen Ereignis können Sie JavaScript-Logik verwenden, um die Wirkungsweise des Steuerelements zu ändern. Weitere Informationen zur Verwendung von Ereignissen bei Steuerelementen finden Sie im Abschnitt Benutzerdefinierte Ereignisse.

Methoden

Ausführliche Informationen zu den verfügbaren Methoden für das Element 'Integer' finden Sie unter Integer - JavaScript-API.

Zusätzliche Ressourcen

Informationen zum Erstellen eines Coach finden Sie unter Coaches erstellen.
Informationen zu Standardeigenschaften (Allgemein, Konfiguration, Positionierung, Sichtbarkeit und HTML-Attribute) finden Sie unter Eigenschaften für Coach-Ansichten.