Skip to main content

Texteingabe konfigurieren

Visualisierungen unterstützen Eingaben über Maus/Gesten oder Tastatur sowie über virtuelle Tastaturen für Touch-Geräte.

Hinweis

0_Sample_Project Beispielprojekt für Benutzereingabe mit virtuellem Ziffernblock oder virtueller Tastatur

Die virtuellen Tastaturen in CODESYS verfügen über unterschiedliche Funktionalitäten. Welche Tastatur konkret verwendet werden soll, wird mithilfe des Eingabetyps ausgewählt. Dieser Eingabetyp wird applikationsweit im Visualisierungsmanager konfiguriert. Beim Programmieren der Benutzereingabe einer Visualisierung kann ein spezieller Eingabetyp ausgewählt werden.

Der Eingabetyp wird an folgenden Stellen konfiguriert:

  • Im Visualisierungsmanager können Sie unter der Einstellung Einstellungen für Standardtexteingabe eine Tastaturvisualisierung voreinstellen. Diese wird dann bei Bedarf von allen Visualisierungen in der Applikation aufgerufen. Das funktioniert, ohne dass Sie die Benutzereingaben der Visualisierungen weiter anpassen müssen.

  • In den einzelnen Visualisierungselementen, die auf Benutzereingaben reagieren, können Sie die Eigenschaft Eingabekonfiguration mit der Eingabeaktion Variable schreiben konfigurieren. Wählen Sie unter den verschiedenen virtuellen Tastaturen diejenige aus, die über den gewünschten Funktionsumfang verfügt.

Für weitere Informationen siehe:

Virtuelle Tastaturen

Tabelle 2. Dialoge aus der Bibliothek VisuDialogs

Eingabetyp

Virtuellen Tastatur

VisuDialogs.Numpad2

_visu_img_numpad2.png

Größe und Position können verschoben werden.

VisuDialogs.Numpad

_visu_img_numpad.png

VisuDialogs.Keypad2

Die Tastatur ist sprachspezifisch, was die Anordnung und Belegung der Tasten betrifft. Sie ist für die Sprachen Deutsch, Englisch (en-US) und Französisch vorbereitet. Eine Sprachumschaltung ist möglich.

Wenn zusätzlich eine physische Tastatur vorhanden ist, können damit Eingaben parallel erfolgen.

Die virtuelle Tastatur eignet sich für die Eingabe von Zahlenwerten. Während der Eingabe wird die Einhaltung des erwarteten Datentyps (Ganzzahl, Gleitkommazahl, Zeit oder Datum/Uhrzeit) überprüft.

Größe und Position können verschoben werden.

VisuDialogs.Keypad

_visu_img_keypad.png

VisuDialogs. NumpadExtended

Erweiterter Ziffernblock, für die Eingabe auch von Hexadezimalzahlen

VisuDialogs.TextinputWithLimits2

Der Dialog funktioniert gleich wie TextInputWithLimits, optisch erscheint er wie Numpad2/Keypad2

Größe und Position können verschoben werden.

VisuDialogs.TextinputWithLimits

Eingabe von Werten innerhalb eines Zahlenbereichs



Tipp

Mit dem Compiler-Define VISU_DIALOGS_NO_GENERAL_AUTO_SIZE_UPDATE können Änderungen an Dialogposition und Größe durch unterschiedliche Skalierung generell abgeschaltet werden.

Programmatische Optionen

Die virtuellen Tastaturen VisuDialogs.*2 können programmatisch geändert werden.

Tipp

Um sicherzustellen, dass Einstellungen auch bei Online-Change erhalten bleiben, ist es ratsam, diese im Visualisiuerngsmanager über die Funktionalität "Aufruf nach Visualisierungsinitialisierung" vorzunehmen.

Programmatische Optionen

  • Um das Standardlayout programmatisch zu ändern oder um eigene Layouts zu erweitern, können Sie die Variable Dialog_Variables.g_ptLanguageSpecificSettings nutzen.

  • Um die Umschaltzeit der erweiterten Tastaturzeichen zu konfigurieren, können Sie die Variable VisuDialogs.Dialog_Variables.g_DialogSettings.tKeyboardCharSwitchTime nutzen.

  • Um die Schaltfläche „Text löschen“ zu deaktivieren, können Sie die Variable Dialog_Variables.g_DialogSettings.xDisableClearTextButton verwenden.

  • Um das Feld für die Passwortanzeige zu deaktivieren, können Sie die Variable Dialog_Variables.g_DialogSettings.xDisablePasswordVisibilityButton verwenden.

  • Die Uhrzeit in Zeit-Dialogen kann im 12-Stunden-Format (z. B. 3:00 PM) oder im 24-Stunden-Format (z. B. 15:00) angegeben werden. Standardmäßig hängt das Format von der Spracheinstellung des Clients ab.

    Sie können die Variable Dialog_Variables.g_ptLanguageSpecificSettings verwenden, um das Format zu ändern.

    Wenn Sie mehr unterschiedliche Spracheinstellungen definieren möchten, können Sie ein eigenes Array vom Typ VisuDlg_LanguageSpecificSetting deklarieren und zuweisen.

Texteingabe über das Standardverfahren konfigurieren

Konfiguration durch Eingabetyp = Standard

Wenn für den Datentyp STRING die Kodierung in UTF-8 aktiviert ist, dann sind Texte mit sprachspezifische Zeichen erlaubt. Sowohl bei der Eingabe als auch bei der Ausgabe können dann Texte mit sprachspezifische Zeichen wie beispielsweise Umlautzeichen oder chinesische Schriftzeichen angegeben werden. Sie können die UTF-8-Kodierung in Dialog: Projekteinstellungen: Compile-Optionen aktivieren.

Voraussetzung: Ein Projekt mit Visualisierung ist geöffnet. Die CODESYS TargetVisu verfügt über keine Tastatur.

  1. Deklarieren Sie im Programm PLC_PRG eine Eingabevariable.

    Deklaration

    VAR_INPUT 
    stInput : STRING; 
END_VAR

  2. Fügen Sie in der Visualisierung eine Schaltfläche ein und selektieren Sie das Element.

  3. Konfigurieren Sie die Eigenschaft Texte → Text mit Text input: %s

  4. Konfigurieren Sie die Eigenschaft Textvariablen → Textvariable mit PLC_PRG.stInput.

  5. Klicken Sie in der Eigenschaft Eingabekonfiguration → OnMouseClick auf Konfigurieren.

    Der Dialog Eingabekonfiguration öffnet sich. Unterhalb des Titels wird das ausgewählte Eingabeereignis ausgegeben.

  6. Wählen Sie die Aktion Variable schreiben.

  7. Wählen Sie in der Implementierung der Aktion unter Eingabetyp den Wert Standard aus.

    Die Eingabe ist wie üblich konfiguriert.

  8. Übersetzen, laden und starten Sie die Applikation als CODESYS TargetVisu .

    Die Visualisierung öffnet sich.

  9. Klicken Sie als Visualisierungsbenutzer auf die Schaltfläche.

    Ein Eingabefeld erscheint und zusätzlich eine virtuelle Tastatur, die eine Texteingabe mit Maus ermöglicht.

  10. Übersetzen, laden und starten Sie die Applikation als CODESYS WebVisu.

    Die Visualisierung öffnet sich.

  11. Klicken Sie als Visualisierungsbenutzer auf die Schaltfläche.

    Ein Eingabefeld erscheint und fordert zur Texteingabe auf.

Texteingabe speziell für die virtuelle Tastatur Visudialogs.Keypad konfigurieren

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Deklarieren Sie im Programm PLC_PRG eine Eingabevariable.

    Deklaration

    VAR_INPUT 
    stInput : STRING; 
END_VAR

  2. Fügen Sie in der Visualisierung eine Schaltfläche ein und selektieren Sie das Element.

  3. Konfigurieren Sie die Eigenschaft Texte → Text mit Text input: %s

  4. Konfigurieren Sie die Eigenschaft Textvariablen → Textvariable mit PLC_PRG.stInput.

  5. Klicken Sie in der Eigenschaft Eingabekonfiguration → OnMouseClick auf Konfigurieren.

    Der Dialog Eingabekonfiguration öffnet sich. Unterhalb des Titels wird das ausgewählte Eingabeereignis ausgegeben.

  6. Wählen Sie die Aktion Variable schreiben.

  7. Wählen Sie in der Implementierung der Aktion unter Eingabetyp die Visualisierung Visudialogs.Keypad aus.

    Als Eingabegerät ist die virtuelle Tastatur Visudialogs.Keypad ausgewählt.

  8. Übersetzen, laden und starten Sie die Applikation.

    Die Visualisierung öffnet sich.

  9. Klicken Sie als Visualisierungsbenutzer auf die Schaltfläche.

    Die virtuelle Tastatur erscheint und ermöglicht eine Texteingabe mit der Maus.

    _visu_img_call_virtual_keypad.png

Zahleneingabe speziell für virtuellen Ziffernblock konfigurieren

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Deklarieren Sie im Programm PLC_PRG eine Eingabevariable.

    Deklaration

    VAR_INPUT 
    iInput : INT; 
END_VAR

  2. Öffnen Sie die Visualisierung und fügen Sie ein Element Rechteck hinzu.

  3. Selektieren Sie das Element im Editor.

    In der Ansicht Eigenschaften sind die Eigenschaften sichtbar.

  4. Konfigurieren Sie die Eigenschaft Texte → Text mit Number input: %i

  5. Konfigurieren Sie die Eigenschaft Textvariablen → Textvariable mit PLC_PRG.iInput.

  6. Klicken Sie unter der Eigenschaft Eingabekonfiguration in der Zeile, die das Eingabeereignis OnMouseClick enthält, auf die Schaltfläche Konfigurieren.

    Der Dialog Eingabekonfiguration öffnet sich. Unterhalb des Titels wird das ausgewählte Eingabeereignis ausgegeben.

  7. Selektieren Sie dort in der Liste der möglichen Aktionen die gewünschte Aktion Variable schreiben und klicken Sie auf das Symbol _visu_img_add_selected_alarm_group.png.

    Die Aktion erscheint in der Liste der auszuführenden Aktionen. Im Fensterbereich rechts der Liste erscheint die noch leere Implementierung der Aktion.

  8. Wählen Sie folgende Einstellungen:

    Eingabetyp auf VisuDialogs.Numpad.

    Variable zur Bearbeitung auswählen auf Textausgabevariable verwenden.

    Dialogtitel auf 'My virtual numpad'.

  9. Beenden Sie den Dialog mit OK.

    Die Benutzereingabe ist konfiguriert.

  10. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Wenn Sie als Benutzer auf das Rechteck klicken, öffnet sich der Ziffernblock.

    _visu_img_call_virtual_numpad.png

Standardtexteingabe definieren

Voraussetzung: Ein Projekt mit Visualisierung und Benutzereingabekonfiguration ist geöffnet. Dabei ist für alle Folgeaktionen Variable schreiben bei der Einstellung Eingabetyp der Wert Standard ausgewählt.

  1. Doppelklicken Sie auf den Visualisierungsmanager.

  2. Klicken Sie in Registerkarte Einstellungen unter Gruppe Standardtexteingabe in die Auswahllisten und weisen Sie Visualisierungen zu.

    Diese Visualisierungen sind als Standardtexteingabe definiert. Wenn eine Darstellungsvariante über keine Tastatur verfügt, werden diese Visualisierungen aufgerufen, ohne dass Sie die Benutzereingabe dafür anpassen müssen.

In diesem Abschnitt: