InputBox

Die InputBox dient zur Anzeige und Bearbeitung von numerischen oder textuellen Werten.

InputBox 1:

Verwendung

Einsatz auf jeder beliebigen Seite, auf der numerische oder textuelle Werte angezeigt bzw. bearbeitet werden sollen.

Features

Numerische Eingabe

Ist der DataType gleich number, so wird die Benutzereingabe auf folgende Kriterien geprüft:

Ebenfalls können die Einheit und Anzahl der Nachkommastellen für einen numerischen Wert mit den Attributen Unit und Digits vorgegeben werden.

Attribute

Das Control erbt vom TextControl und hat somit dieselben Attribute. Dazu kommen folgende Attribute.

Feedback-Konzept

Das Control kann das Feedback-Konzept nutzen.

BA

BaObject

tchmi:framework#/definitions/Symbol

Symbol für BaObject zum Verwenden der generischen Funktionalitäten von TcHmiBa. Verknüpft ein einzelnes Objekt oder einen kompletten View (inkl. Kinder) mit dem Control.

InputBox 2:

Das Attribut ist nicht bei allen Controls anwendbar.

Common

DataType

tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.InputBox.InputDataType

Datentyp der InputBox. Ist auto ausgewählt, wird der Standardwert oder die erste Eingabe analysiert und der Datentyp entsprechend gesetzt. Ist number ausgewählt enthält Value nicht die Einheit.

Text (read-only)

tchmi:general#/definitions/String

Der angezeigte Text.

BaData

BaInterface

tchmi:framework#/definitions/Symbol

Symbol das das BaInterface des Controls erfüllt.

BaInterfaceSymbolNames

tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.InputBox.BaInterfaceSymbolNames

Bearbeiten der BaInterfaceSymbolNames.

Value

tchmi:framework#/definitions/TcHmi.BuildingAutomation.StringOrNumber

Aktueller Wert. Abhängig vom gewählten DataType ist der Wert numerisch oder textuell.

ValueFeedback

tchmi:framework#/definitions/TcHmi.BuildingAutomation.StringOrNumber

Feedback für den Wert.

UseValueFeedback

tchmi:general#/definitions/Boolean

Wenn TRUE, dann wird auf das Attribut ValueFeedback geachtet.

Number

MinValue

tchmi:general#/definitions/Number

Geringster zulässiger Eingabewert (wenn DataType gleich number).

MaxValue

tchmi:general#/definitions/Number

Größter zulässiger Eingabewert (wenn DataType gleich number).

Unit

tchmi:framework#/definitions/TcHmi.BuildingAutomation.StringOrNumber

Legt die Einheit hinter Value fest (wenn DataType gleich number). Mögliche Werte sind:

  • textuell (z.B. "°C")
  • numerisch (Enumerationswert von E_BA_Unit)

Digits

tchmi:general#/definitions/Number

Anzahl der Nachkommastellen (wenn DataType gleich number).

Events

Ereignis

Beschreibung

onStateChanged

Wird ausgelöst, wenn sich der Wert geändert hat.

onUserInteractionFinished

Wird ausgelöst, wenn der Benutzer die Eingabe beendet. Das bedeutet:

  • Eingabetaste wird betätigt
  • InputBox verliert Fokus