Formulare › Der Formulardesigner › Events der Formularelemente

Events der Formularelemente

onBlur

Tritt ein, wenn ein Formularelement den Fokus verliert. Zum Beispiel enthält ein Formular ein Feld mit der Bezeichnung "Anwendername". Ein Anwender erstellt mit der Tabulatortaste den Fokus im Feld oder indem er darauf klickt. Das Event "onBlur" tritt auf, wenn der Anwender eine der folgenden Aktionen ausführt:

• Der Anwender klickt auf ein anderes Objekt oder in ein anderes Fenster.
• Der Anwender drückt die Tabulatortaste, um zum nächsten Feld zu navigieren (zum Beispiel das Feld Kennwort).

onChange

Tritt ein, wenn ein Formularelement den Fokus verliert und der neue Wert eines Formularelements nicht mit dem alten Wert übereinstimmt. Zum Beispiel enthält ein Formular ein Feld mit der Bezeichnung "Menge", das den Wert 10 hat. Nachdem der Anwender den Wert auf 15 geändert hat, verschiebt er den Fokus nicht auf ein anderes Feld. Das Event "onChange" tritt nur ein, wenn der Anwender eine der folgenden Aktionen ausführt:

• Der Anwender klickt auf ein anderes Objekt oder in ein anderes Fenster.
• Der Anwender drückt die Tabulatortaste, um zum nächsten Feld zu navigieren.

onClick

Tritt ein, wenn ein Anwender auf ein Formularelement klickt. Ein gültiger Klick enthält sowohl das Event "onMouseDown" als auch "onMouseUp" auf dem gleichen Objekt. Diese Anforderung verhindert, dass Funktionen oder anderer Code versehentlich abgerufen werden bzw. wird, da die Maus auf dem klickbaren Objekt bleiben muss.

onFocus

Tritt ein, wenn ein Formularelement Fokus empfängt. Um den Fokus zu erstellen, navigiert der Anwender mit der Tabulatortaste zu dem Formularelement oder er klickt darauf. Sie können auch Skripte oder Codes schreiben, um Fokus in einem Feld zu erstellen.

onKeyDown

Tritt ein, wenn ein Anwender das erste Mal auf eine Taste drückt (beispielsweise, wenn ein Anwender mit der Tabulatortaste zu einem Namensfeld navigiert oder darauf klickt). Ein Skript, das dem Event "onKeyDown" für das Namensfeld zugeordnet ist, warnt Anwender, wenn sie versuchen, Zahlentasten zu drücken.

onKeyPress

Tritt ein, wenn ein Anwender auf eine Taste drückt und diese gedrückt hält. Das Event "onKeyPress" tritt z. B. ein, wenn ein Anwender mit der Tabulatortaste zu einem Auswahlfeld mit der Bezeichnung "Name" navigiert oder darauf klickt und alphabetische Tasten drückt. Ein Skript, das dem Event "onKeyPress" für das Namensfeld zugeordnet ist, geht die Namen durch, die mit der gedrückten alphabetischen Taste übereinstimmen.

onKeyUp

Tritt ein, wenn ein Anwender eine gedrückte Taste wieder loslässt. Das Event "onKeyUp" tritt z. B. ein, wenn ein Anwender mit der Tabulatortaste zu einem Spinner-Feld mit der Bezeichnung "Temperature" navigiert oder darauf drückt. Ein Skript, das dem Event zugeordnet ist, erhöht oder reduziert den Feldwert jedes Mal, wenn der Anwender eine bestimmte Taste drückt und loslässt.

onload

Tritt ein, wenn das Formular zum ersten Mal geöffnet wird, damit der Anwender es ausfüllen kann.

onLookup

Tritt ein, wenn ein Anwender in einem Suchfeld auf "Durchsuchen" klickt, um Werte anzuzeigen, die basierend auf anderen Feldwerten berechnet werden (oder wie vom Skript angegeben "gesucht" werden).

onMouseDown

Tritt ein, wenn ein Anwender mit der linke Maustaste auf ein Formularelement klickt.

onMouseMove

Tritt ein, wenn ein Anwender den Mauszeiger innerhalb der Grenze eines Formularelements bewegt.

onMouseOut

Tritt ein, wenn ein Anwender den Mauszeiger außerhalb der Grenze eines Formularelements bewegt.

onMouseOver

Tritt ein, wenn ein Anwender den Mauszeiger über einem Formularelement bewegt und dann aufhört, die Maus zu bewegen.

onMouseUp

Tritt ein, wenn ein Anwender die linke Maustaste loslässt, nachdem er mit der Maustaste auf ein Formularelement geklickt hat.

onMouseWheel

Tritt ein, wenn ein Anwender mit einem Mausrad ausgestattet ist und das Rad vor oder zurück rollt, um im Formularelement einen Bildlauf durchzuführen.

onsubmit

Tritt ein, wenn der Anwender das Formular sendet. Durch folgende Aktionen kann das Formular gesendet werden:

• Der Anwender klickt auf die Schaltfläche "Senden".
• Der Anwender drückt eine bestimmte Taste oder eine Kombination von Tasten.
• Der Wert eines Feldes ändert sich.
• Der Anwender erreicht in der Registerkartenreihenfolge das Ende des Formulars.

onValidate

Tritt ein, wenn der zugeordnete Code einen Feldwert anhand der Geschäftsregeln überprüft, bevor eine der folgenden Aktionen eintritt:

• Der Feldwert wird im Datenpuffer gespeichert.
• Der Feldwert in die Datenbank geschrieben.

Zum Beispiel navigiert der Anwender mit der Tabulatortaste zu einem Seriennummernfeld, das mit den Buchstaben "SN" anfangen und 10 numerische Ziffern enthalten muss, oder klickt darauf. Bevor der Anwender mit der Tabulatortaste ins nächsten Feld wechseln kann oder neben das Feld klickt, werden die Daten durch das Event "onValidate" und den zugeordneten Code überprüft. Sie können den Anwender warnen, wenn die Seriennummer nicht den Validierungsregeln entspricht, sodass er die Eingabe anpassen kann.

Sie können "onValidate" für eine anwenderspezifische Validierung der Feldeingabe verwenden. Um zum Beispiel sicherzustellen, dass eine Feldeingabe mindestens drei Zeichen lang ist, können Sie eine anwenderspezifische Funktion im Dialogfeld "Skript" schreiben:

validateValue:function(_val) {

if(_val.length < 3) {
return "Geben Sie in diesem Feld mehr als drei Zeichen ein";
} else {
return null;
}

Schließen Sie im Formulardesigner den Attributwert "onValidate" für das Textfeld ein, für das die Validierung ausgeführt werden soll. Zum Beispiel:

ca_fd.js.validateValue(_val)

Die anwenderspezifische Funktion ersetzt den erforderlichen Parameter "_val" durch den richtigen Feldwert, wenn das Skript ausgeführt wird.

Wenn das Validierungsskript einen Nullwert zurückgibt, besteht die Feldeingabe die Validierung. Andernfalls schlägt die Validierung der Feldeingabe fehl, und das Skript gibt einen Fehler zurück (z. B. "Geben Sie in diesem Feld mehr als drei Zeichen ein").