field

Das field-Objekt beschreibt einen einzelnen interaktiven Container, der Dateninhalte erfassen und darstellen kann.

Das Feldobjekt gehört zu den Objekten, die in der Objektbibliothek von Designer verfügbar sind. Es stellt die grundlegende XML-Definition für die folgenden Objekte dar:

  • Barcodes

  • Schaltfläche

  • Datums-/Uhrzeitfeld

  • Dezimalfeld

  • Unterschriftsfeld

  • E-Mail-Senden-Schaltfläche

  • HTTP-Senden-Schaltfläche

  • Bildfeld

  • Numerisches Feld

  • Papierformular-Barcode

  • Kennwortfeld

  • Drucken-Schaltfläche

  • Zurücksetzen-Schaltfläche

  • Textfeld

Sie können benutzerdefinierte Prüfmeldungen definieren. Ein Feld kann bis zu drei Meldungen enthalten (u. a. für die Skript- und Musterprüfung sowie für die Prüfung auf leeres Feld). Sind diese Meldungen festgelegt, können Sie mit Hilfe der folgenden Syntax darauf zugreifen:

field.validate.message.scriptTest.value 
field.validate.message.formatTest.value 
field.validate.message.nullTest.value

Sie können auf diese Prüfmeldungen auch über die entsprechenden Kurzbefehl-Eigenschaften zugreifen:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Wenn diese Werte nicht aufgefüllt sind, erstellt der Prozessor eine Standardmeldung.

Ein Feld kann zu einer bestimmten Zeit eine Maximalzahl von Überprüfungen in einem Fehlerstatus aufweisen. Diese Überprüfungen werden in der folgenden Reihenfolge ausgewertet, wobei die Auswertung beim ersten fehlgeschlagenen Test angehalten wird:

  1. nullTest

  2. formatTest

  3. scriptTest

Übergeordnete Klasse

container-Klasse

Eigenschaften

Name

Beschreibung

Typ

Zugriff

{default}

Stellt den eigentlichen Wert dar, der von einem Objekt gespeichert wird.

Variabel

Lesen/Schreiben

access

Steuert den Benutzerzugriff auf den Inhalt eines Containers, beispielsweise ein Teilformular.

Zeichenfolge

Lesen/Schreiben

accessKey

Gibt eine Zugriffstaste an, die von einer interaktiven Anwendung zum Verschieben des Eingabefokus auf ein bestimmtes Feldelement verwendet wird.

Zeichenfolge

Lesen/Schreiben

anchorType

Gibt die Position des Verankerungspunkts des Containers an, wenn er anhand eines positionierten Layouts platziert wird.

Zeichenfolge

Lesen/Schreiben

borderColor

Gibt den Rahmenfarbwert für dieses Feld an.

Zeichenfolge

Lesen/Schreiben

borderWidth

Gibt die Rahmenbreite für dieses Feld an.

Zeichenfolge

Lesen/Schreiben

colSpan

Gibt bei der Verwendung in einem Teilformular mit einer Layoutzeile die Anzahl der Spalten an, die dieses Objekt umfasst.

Zeichenfolge

Lesen/Schreiben

editValue

Gibt den Bearbeitungswert für das Feld an.

Zeichenfolge

Lesen/Schreiben

errorText

Gibt die Überprüfungsmeldung für den ersten fehlgeschlagenen Test zur Überprüfung oder eine leere Zeichenfolge zurück, wenn dieses Feld alle Tests zur Überprüfung bestanden hat.

Zeichenfolge

Lesen

fillColor

Der Wert für die Hintergrundfarbe für dieses Feld.

Zeichenfolge

Lesen/Schreiben

fontColor

Gibt den Wert für die Vordergrundfarbe des Feldes an. Entspricht dem Ausdruck font.fill.color.value.

Zeichenfolge

Lesen/Schreiben

formatMessage

Gibt die Zeichenfolge der Meldung zur Formatprüfung für dieses Feld an.

Zeichenfolge

Lesen/Schreiben

formattedValue

Gibt den formatierten Wert für das Feld an.

Zeichenfolge

Lesen/Schreiben

h

Eine Maßeinheit für die Höhe des Layouts.

Zeichenfolge

Lesen/Schreiben

hAlign

Gibt die horizontale Textausrichtung an.

Zeichenfolge

Lesen/Schreiben

length

Gibt die Anzahl der Objekte in der Liste an.

Ganzzahliger Wert

Lesen

locale

Gibt die für den Inhalt des Objekts zu verwendende Sprache und Währung sowie das zu verwendende Uhrzeit-/Datumsformat an.

Zeichenfolge

Lesen/Schreiben

mandatory

Gibt den nullTest-Wert für das Feld an.

Zeichenfolge

Lesen/Schreiben

mandatoryMessage

Gibt die obligatorische Meldungszeichenfolge für dieses Feld an.

Zeichenfolge

Lesen/Schreiben

maxH

Gibt die maximale Höhe für Layoutzwecke an.

Zeichenfolge

Lesen/Schreiben

maxW

Gibt die maximale Breite für Layoutzwecke an.

Zeichenfolge

Lesen/Schreiben

minH

Gibt die minimale Höhe für Layoutzwecke an.

Zeichenfolge

Lesen/Schreiben

minW

Gibt die minimale Breite für Layoutzwecke an.

Zeichenfolge

Lesen/Schreiben

parentSubform

Gibt das übergeordnete Teilformular (Seite) für dieses Feld an.

Objekt

Lesen

presence

Gibt an, ob ein Objekt sichtbar ist.

Zeichenfolge

Lesen/Schreiben

rawValue

Gibt den unformatierten Wert des aktuellen Objekts an.

Variabel

Lesen/Schreiben

relevant

Steuert, ob ein Formularobjekt beim Drucken des Formulars einbezogen wird.

Zeichenfolge

Lesen/Schreiben

rotate

Dreht das Objekt im angegebenen Winkel um seinen Verankerungspunkt.

Zeichenfolge

Lesen/Schreiben

selectedIndex

Die Indexposition des ersten ausgewählten Elements.

Ganzzahliger Wert

Lesen/Schreiben

use

Ruft einen Prototyp auf.

Zeichenfolge

Lesen/Schreiben

usehref

Ruft einen externen Prototyp auf.

Zeichenfolge

Lesen/Schreiben

validationMessage

Gibt die Meldungszeichenfolge für die Überprüfung für dieses Feld an.

Zeichenfolge

Lesen/Schreiben

vAlign

Gibt die vertikale Textausrichtung an.

Zeichenfolge

Lesen/Schreiben

w

Eine Maßeinheit für die Breite des Layouts.

Zeichenfolge

Lesen/Schreiben

x

Gibt die X-Koordinate des Container-Verankerungspunkts im Verhältnis zur oberen, linken Ecke des übergeordneten Containers bei der Platzierung in einem positionierten Layout an.

Zeichenfolge

Lesen/Schreiben

y

Gibt die Y-Koordinate eines Container-Verankerungspunkts im Verhältnis zur oberen, linken Ecke des übergeordneten Containers bei der Platzierung in einem positionierten Layout an.

Zeichenfolge

Lesen/Schreiben

Methoden

Name

Beschreibung

Rückgabe

addItem

Fügt dem aktuellen Formularfeld neue Elemente hinzu. Mit dieser Methode werden beispielsweise einer Dropdown-Liste neue Elemente hinzugefügt.

Leer

boundItem

Ruft den Bindewert eines bestimmten Anzeigeelements aus einer Dropdown-Liste oder aus einem Listenfeld ab.

Zeichenfolge

clearItems

Entfernt alle Elemente aus dem Feld. Es werden beispielsweise alle Elemente aus der Dropdown-Liste oder aus dem Listenfeld entfernt.

Leer

deleteItem

Löscht das angegebene Element.

Boolesch

execCalculate

Führt Skripten für das calculate-Ereignis des angegebenen Objekts und etwaiger untergeordneter Objekte aus.

Leer

execEvent

Führt das Ereignisskript des Objekts aus.

Leer

execInitialize

Führt Skripten für das initialize-Ereignis des angegebenen Objekts und etwaiger untergeordneter Objekte aus.

Leer

execValidate

Führt Skripten für das validate-Ereignis des angegebenen Objekts und etwaiger untergeordneter Objekte aus.

Leer

getDisplayItem

Ruft den Elementanzeigetext für den angegebenen Elementindex ab.

Zeichenfolge

getItemState

Gibt den Auswahlstatus des angegebenen Elements zurück.

Boolesch

getSaveItem

Ruft den Datenwert für den angegebenen Elementindex ab.

Zeichenfolge

setItemState

Legt den Auswahlstatus des angegebenen Elements fest.

Leer

setItems

Fügt dem aktuellen Formularfeld neue Elemente und Werte hinzu. Mit dieser Methode werden beispielsweise einer Dropdown-Liste neue Elemente und Werte als Argumente hinzugefügt.

Leer