field

Objektet field beskriver en interaktiv behållare som kan lagra och presentera datainnehåll.

Vad gäller objekt som är tillgängliga i Objektbiblioteket i Designer så är fältobjektet den grundläggande XML-definitionen för följande objekt:

  • Streckkoder

  • Knapp

  • Datum-/tidfält

  • Decimalfält

  • Signaturfält

  • Skicka-knapp för e-post

  • Skicka-knapp (HTTP)

  • Bildfält

  • Numeriskt fält

  • Streckkod för pappersformulär

  • Lösenordsfält

  • Skriv ut-knapp

  • Återställ-knapp

  • Textfält

Du kan definiera anpassade valideringsmeddelanden. Ett enskilt fält kan innehålla upp till tre meddelanden - ett vardera för skripttest, bildtext och null-test. När du har specificerat dessa får du tillgång till dem med följande syntax:

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

Du kan även komma åt dessa valideringsmeddelanden med deras kortkommandoegenskaper:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Om du inte fyller i dessa värden skapas ett standardmeddelande.

Ett fält kan ha högst ett valideringstest i ett felläge vid en given tidpunkt. Valideringstesterna utvärderas i följande ordning, och utvärderingen stoppas vid det första testet som misslyckas:

  1. nullTest

  2. formatTest

  3. scriptTest

Överordnad klass

container-klass

Egenskaper

Namn

Beskrivning

Typ

Åtkomst

{default}

Motsvarar det faktiska värde som lagrats av ett objekt.

Varierar

Läs/Skriv

access

Kontrollerar användaråtkomst till ett behållarobjekt, t.ex. ett delformulär.

Sträng

Läs/Skriv

accessKey

Specificerar en acceleratorstangent som används av ett interaktivt program för att flytta fokuseringen av indata till ett speciellt fältelement.

Sträng

Läs/Skriv

anchorType

Anger platsen för behållarens fästpunkt när den placeras med positionerad layoutstrategi.

Sträng

Läs/Skriv

borderColor

Specificerar kantfärgens värde för det här fältet.

Sträng

Läs/Skriv

borderWidth

Specificerar kantbredden för det här fältet.

Sträng

Läs/Skriv

colSpan

Specificerar antal kolumner som omfattas av det här objektet när det används inuti ett delformulär med en radlayouttyp.

Sträng

Läs/Skriv

editValue

Anger redigeringsvärdet för fältet.

Sträng

Läs/Skriv

errorText

Returnerar valideringsmeddelandet för det första misslyckade valideringstestet, eller en tom sträng om det här fältet har gått igenom alla valideringstester.

Sträng

Läs

fillColor

Bakgrundsfärgens värde för det här fältet.

Sträng

Läs/Skriv

fontColor

Anger förgrundsfärgens värde för fältet. Motsvarigheten till uttrycket font.fill.color.valueexpression.

Sträng

Läs/Skriv

formatMessage

Anger meddelandesträngen för formatvalidering för det här fältet.

Sträng

Läs/Skriv

formattedValue

Anger förgrundsfärgens formaterade värde för fältet.

Sträng

Läs/Skriv

h

Mått på layoutens höjd.

Sträng

Läs/Skriv

hAlign

Anger vågrät textjustering.

Sträng

Läs/Skriv

length

Anger antal objekt i listan.

Heltal

Läs

locale

Anger formatering av språk, valuta och tid/datum som ska användas för objektets innehåll.

Sträng

Läs/Skriv

mandatory

Anger nullTest-värde för fältet.

Sträng

Läs/Skriv

mandatoryMessage

Anger den obligatoriska meddelandesträngen för det här fältet.

Sträng

Läs/Skriv

maxH

Anger den maximala höjden för layoutändamål.

Sträng

Läs/Skriv

maxW

Anger den maximala bredden för layoutändamål.

Sträng

Läs/Skriv

minH

Anger minimihöjden för layoutändamål.

Sträng

Läs/Skriv

minW

Anger minimibredden för layoutändamål.

Sträng

Läs/Skriv

parentSubform

Anger fältets överordnade delformulär (sida).

Objekt

Läs

presence

Anger synligheten hos ett objekt.

Sträng

Läs/Skriv

rawValue

Anger det oformaterade värdet av aktuellt objekt.

Varierar

Läs/Skriv

relevant

Kontrollerar om ett formulärobjekt inkluderas när ett formulär skrivs ut.

Sträng

Läs/Skriv

rotate

Roterar objektet kring ankarpunkten med den angivna vinkeln.

Sträng

Läs/Skriv

selectedIndex

Index för det först markerade objektet.

Heltal

Läs/Skriv

use

Anropar en prototyp.

Sträng

Läs/Skriv

usehref

Anropar en extern prototyp.

Sträng

Läs/Skriv

validationMessage

Anger valideringsmeddelandesträngen för det här fältet.

Sträng

Läs/Skriv

vAlign

Anger lodrät textjustering.

Sträng

Läs/Skriv

w

Mått som anger layoutens bredd.

Sträng

Läs/Skriv

x

Anger x-koordinaten, i behållarens ankarpunkt vid det övre, vänstra hörnet i den överordnade behållaren när den placeras med positionerad layout.

Sträng

Läs/Skriv

y

Anger Y-koordinaten, i behållarens fästpunkt vid det övre, vänstra hörnet i den överordnade behållaren när den placeras med positionerad layout.

Sträng

Läs/Skriv

Metoder

Namn

Beskrivning

Returnerar

additem

Lägger till nya objekt i det aktuella formulärfältet. Den här metoden lägger t ex till nya objekt i en nedrullningsbar lista.

Tomt

boundItem

Hämtar det bundna värdet för ett visst visningsobjekt i en nedrullningsbar lista eller listruta.

Sträng

clearItems

Tar bort alla objekt från fältet. Den tar t ex bort objekten som finns i en nedrullningsbar lista eller listruta.

Tomt

deleteItem

Tar bort det angivna objektet.

Boolesk

execCalculate

Kör alla skript i händelsen calculate i det angivna objektet och alla underliggande objekt.

Tomt

execEvent

Kör objektets event-skript.

Tomt

execInitialize

Kör alla skript i händelsen initialize i det angivna objektet och alla underliggande objekt.

Tomt

execValidate

Kör alla skript i händelsen validate i det angivna objektet och alla underliggande objekt.

Tomt

getDisplayItem

Hämtar objekttexten för det angivna objektindexet.

Sträng

getItemState

Returnerar urvalstillståndet för det angivna objektet.

Boolesk

getSaveItem

Hämtar datavärdet för det angivna objektindexet.

Sträng

setItemState

Anger urvalstillståndet för det angivna objektet.

Tomt

setItems

Lägger till nya objekt och värden i det aktuella formulärfältet. Den här metoden lägger t ex till nya objekt och värden som argument i en nedrullningsbar lista.

Tomt