field

Met het field-object wordt één interactieve container beschreven waarmee gegevensinhoud kan worden vastgelegd en gepresenteerd.

Er is een groot aantal objecten beschikbaar in de Objectbibliotheek van Designer, omdat het veldobject de basis-XML-definitie is voor de volgende objecten:

  • Streepjescodes

  • Knop

  • Datum-/tijdveld

  • Decimaal veld

  • Handtekeningveld

  • Knop Verzenden via e-mail

  • Knop HTTP verzenden

  • Afbeeldingsveld

  • Numeriek veld

  • Streepjescode papierformulieren

  • Wachtwoordveld

  • Knop Afdrukken

  • Knop Opnieuw instellen

  • Tekstveld

U kunt eigen validatieberichten definiëren. Eén veld kan tot drie berichten bevatten, één voor de scripttest, afbeeldingstest en null-test. Als deze zijn opgegeven, kunnen ze worden benaderd met de volgende syntaxis:

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

U kunt deze validatieberichten ook benaderen met hun eigenschappen voor snelkoppelingen:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Als deze waarden niet zijn gevuld, genereert de processor een standaardbericht.

Een veld kan nooit meer dan één validatietest hebben bij een foutstatus. Validatietests worden in de volgende volgorde geëvalueerd en de evaluatie houdt op bij de eerste test waaraan niet wordt voldaan:

  1. nullTest

  2. formatTest

  3. scriptTest

Bovenliggende klasse

container-klasse

Eigenschappen

Naam

Beschrijving

Type

Toegang

{default}

Vertegenwoordigt de werkelijke waarde die wordt opgeslagen door een object.

Variabel

Lezen/Schrijven

access

Deze eigenschap bepaalt de toegang tot de inhoud van een containerobject, zoals een subformulier.

Tekenreeks

Lezen/Schrijven

accessKey

Hiermee wordt een sneltoets opgegeven die door een interactieve toepassing wordt gebruikt om de invoerfocus te verplaatsen naar een bepaald veldelement.

Tekenreeks

Lezen/Schrijven

anchorType

Geeft de locatie van het ankerpunt van de container wanneer dit is geplaatst met gepositioneerde indelingsstrategie.

Tekenreeks

Lezen/Schrijven

borderColor

Hiermee wordt de waarde van de randkleur voor dit veld opgegeven.

Tekenreeks

Lezen/Schrijven

borderWidth

Hiermee wordt de randbreedte voor dit veld opgegeven.

Tekenreeks

Lezen/Schrijven

colSpan

Hiermee wordt het aantal kolommen opgegeven dat door dit object in beslag wordt genomen wanneer het wordt gebruikt binnen een subformulier met het indelingstype rij.

Tekenreeks

Lezen/Schrijven

editValue

Hiermee wordt de te bewerken waarde voor dit veld opgegeven.

Tekenreeks

Lezen/Schrijven

errorText

Retourneert het validatiebericht voor de eerste mislukte validatietest, of een lege tekenreeks als dit veld alle validatietests met succes heeft doorstaan.

Tekenreeks

Lezen

fillColor

De achtergrondkleur van dit veld.

Tekenreeks

Lezen/Schrijven

fontColor

Hiermee wordt de voorgrondkleur van het veld opgegeven. Het is het equivalent van de expressie font.fill.color.value.

Tekenreeks

Lezen/Schrijven

formatMessage

Hiermee wordt de tekenreeks van het validatiebericht voor opmaak voor dit veld aangegeven.

Tekenreeks

Lezen/Schrijven

formattedValue

Hiermee wordt de opgemaakte waarde voor dit veld aangegeven.

Tekenreeks

Lezen/Schrijven

h

Een meetwaarde voor de hoogte van de indeling.

Tekenreeks

Lezen/Schrijven

hAlign

Hiermee wordt de horizontale uitlijning voor tekst aangegeven.

Tekenreeks

Lezen/Schrijven

length

Hiermee wordt het aantal objecten in de lijst opgegeven.

Geheel getal

Lezen

locale

De taal, de valutanotatie en de notatie voor tijd en datum die op de inhoud van het object moeten worden toegepast.

Tekenreeks

Lezen/Schrijven

mandatory

Hiermee wordt de nullTest-waarde voor dit veld opgegeven.

Tekenreeks

Lezen/Schrijven

mandatoryMessage

Hiermee waarschuwingstekst voor een verplicht veld opgegeven.

Tekenreeks

Lezen/Schrijven

maxH

Hiermee wordt de maximale hoogte voor de indeling aangegeven.

Tekenreeks

Lezen/Schrijven

maxW

Hiermee wordt de maximale breedte voor de indeling aangegeven.

Tekenreeks

Lezen/Schrijven

minH

Hiermee wordt de minimale hoogte aangegeven ten behoeve van de indeling.

Tekenreeks

Lezen/Schrijven

minW

Hiermee wordt de minimale breedte aangegeven ten behoeve van de indeling.

Tekenreeks

Lezen/Schrijven

parentSubform

Hiermee wordt het bovenliggende subformulier (pagina) van dit veld opgegeven.

Object

Lezen

presence

Hiermee wordt de zichtbaarheid van een object opgegeven.

Tekenreeks

Lezen/Schrijven

rawValue

Hiermee wordt de niet-opgemaakte waarde van de huidige tekening aangegeven.

Variabel

Lezen/Schrijven

relevant

Hiermee wordt bepaald of een formulierobject wordt opgenomen wanneer het formulier wordt afgedrukt.

Tekenreeks

Lezen/Schrijven

rotate

Hiermee roteert u het object met een specifieke hoek rond het fixeerpunt.

Tekenreeks

Lezen/Schrijven

selectedIndex

De index van het eerste geselecteerde item.

Geheel getal

Lezen/Schrijven

use

Hiermee wordt een prototype aangeroepen.

Tekenreeks

Lezen/Schrijven

usehref

Hiermee wordt een extern prototype aangeroepen.

Tekenreeks

Lezen/Schrijven

validationMessage

Hiermee wordt de berichttekstreeks voor dit veld opgegeven.

Tekenreeks

Lezen/Schrijven

vAlign

Hiermee wordt de verticale uitlijning voor tekst aangegeven.

Tekenreeks

Lezen/Schrijven

w

Een meetwaarde waarmee de breedte van de indeling wordt aangegeven.

Tekenreeks

Lezen/Schrijven

x

Hiermee wordt de x-coördinaat opgegeven van het ankerpunt van de container ten opzichte van de linkerbovenhoek van de bovenliggende container bij een gepositioneerde indeling.

Tekenreeks

Lezen/Schrijven

y

Hiermee wordt de Y-coördinaat opgegeven van het ankerpunt van de container, gezien vanuit de linkerbovenhoek van de bovenliggende container, wanneer deze wordt geplaatst met gepositioneerde indeling.

Tekenreeks

Lezen/Schrijven

Methoden

Naam

Beschrijving

Geeft als resultaat

addItem

Hiermee worden nieuwe items aan het huidige formulierveld toegevoegd. Met deze methode voegt u bijvoorbeeld items toe aan een vervolgkeuzelijst.

Leeg

boundItem

Hiermee wordt de gebonden waarde van een bepaald weergave-item van een vervolgkeuzelijst of keuzelijst opgehaald.

Tekenreeks

clearItems

Hiermee worden alle items uit het veld verwijderd. Zo worden bijvoorbeeld alle items in een keuzelijst of een vervolgkeuzelijst verwijderd.

Leeg

deleteItem

Hiermee wordt het item verwijderd.

Boolean

execCalculate

Hiermee worden alle scripts in de gebeurtenis calculate van het opgegeven object en alle onderliggende objecten uitgevoerd.

Leeg

execEvent

Hiermee wordt het script voor gebeurtenissen van het object uitgevoerd.

Leeg

execInitialize

Hiermee worden alle scripts in de gebeurtenis initialize van het opgegeven object en alle onderliggende objecten uitgevoerd.

Leeg

execValidate

Hiermee worden alle scripts in de gebeurtenis validate van het opgegeven object en alle onderliggende objecten uitgevoerd.

Leeg

getDisplayItem

Hiermee wordt de itemweergavetekst voor de opgegeven itemindex opgehaald.

Tekenreeks

getItemState

Hiermee wordt de selectiestatus van het opgegeven item als resultaat gegeven.

Boolean

getSaveItem

Hiermee wordt de gegevenswaarde voor de opgegeven itemindex opgehaald.

Tekenreeks

setItemState

Hiermee wordt de selectiestatus van het opgegeven item als resultaat ingesteld.

Leeg

setItems

Hiermee worden nieuwe items en waarden aan het huidige formulierveld toegevoegd. Met deze methode voegt u bijvoorbeeld nieuwe items en waarden als argumenten toe aan een vervolgkeuzelijst.

Leeg