field

L'oggetto field descrive un singolo contenitore interattivo in grado di acquisire e presentare contenuto dati.

In termini di oggetti disponibili nella Libreria oggetti di Designer, l'oggetto campo rappresenta la definizione XML base per i seguenti oggetti:

Codici a barre
Pulsante
Campo data/ora
Campo decimale
Campo firma
Pulsante Invia per e-mail
Pulsante Invia per HTTP
Campo immagine
Campo numerico
Codice a barre moduli carta
Campo password
Pulsante Stampa
Pulsante Reimposta
Campo di testo

L'utente può definire messaggi di convalida personalizzati. In un campo è possibile includere fino a tre messaggi, rispettivamente per la verifica di script, immagini e valore null. Se vengono specificati, sono accessibili tramite la sintassi seguente:

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

È inoltre possibile accedere a questi messaggi di convalida tramite le proprietà dei relativi collegamenti:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Se mancano questi valori, viene composto automaticamente un messaggio predefinito.

In un qualsiasi momento dato, un campo deve presentare non più di una verifica di convalida con esito negativo. Le verifiche di convalida vengono eseguite nell'ordine di seguito; il processo viene interrotto in corrispondenza della prima verifica con esito negativo:

Gerarchia degli oggetti

Modello

Oggetti secondari

Classe principale

container, classe

Proprietà

Nome	Descrizione	Tipo	Accesso
{default}	Rappresenta il valore reale memorizzato da un oggetto.	Varie	Lettura/scrittura
access	Controlla l'accesso degli utenti al contenuto di un oggetto contenitore, ad esempio un sottomodulo.	Stringa	Lettura/scrittura
accessKey	Specifica un tasto acceleratore utilizzato da un'applicazione interattiva per spostare lo stato attivo su un particolare elemento del campo.	Stringa	Lettura/scrittura
anchorType	Indica la posizione del punto di ancoraggio del contenitore quando questo viene posizionato utilizzando una strategia di layout posizionato.	Stringa	Lettura/scrittura
borderColor	Specifica il valore del colore dei bordi per questo campo.	Stringa	Lettura/scrittura
borderWidth	Specifica la larghezza dei bordi per questo campo.	Stringa	Lettura/scrittura
colSpan	Specifica il numero di colonne su cui si estende l'oggetto quando viene utilizzato all'interno di un sottomodulo con layout di tipo riga.	Stringa	Lettura/scrittura
editValue	Specifica il valore di modifica per il campo.	Stringa	Lettura/scrittura
errorText	Restituisce il messaggio di convalida relativo alla prima verifica di convalida non riuscita, oppure una stringa vuota se tutte le verifiche di convalida del campo specificato hanno restituito un esito positivo.	Stringa	Leggi
fillColor	Specifica il valore del colore di sfondo per il campo.	Stringa	Lettura/scrittura
fontColor	Specifica il valore del colore in primo piano per il campo. È l'equivalente dell'espressione font.fill.color.value.	Stringa	Lettura/scrittura
formatMessage	Specifica la stringa del messaggio di convalida del formato per il campo.	Stringa	Lettura/scrittura
formattedValue	Specifica il valore formattato per il campo.	Stringa	Lettura/scrittura
h	Misura dell'altezza per il layout.	Stringa	Lettura/scrittura
hAlign	Specifica l'allineamento orizzontale del testo.	Stringa	Lettura/scrittura
length	Specifica il numero di oggetti nell'elenco.	Numero intero	Leggi
locale	Specifica la lingua, la valuta e il formato di data/ora da utilizzare per il contenuto dell'oggetto.	Stringa	Lettura/scrittura
mandatory	Specifica il valore nullTest per il campo.	Stringa	Lettura/scrittura
mandatoryMessage	Specifica la stringa del messaggio obbligatorio per il campo.	Stringa	Lettura/scrittura
maxH	Specifica l'altezza massima ai fini del layout.	Stringa	Lettura/scrittura
maxW	Specifica la larghezza massima ai fini del layout.	Stringa	Lettura/scrittura
minH	Specifica l'altezza minima ai fini del layout.	Stringa	Lettura/scrittura
minW	Specifica la larghezza minima ai fini del layout.	Stringa	Lettura/scrittura
parentSubform	Specifica il sottomodulo principale (pagina) del campo.	Oggetto	Leggi
presence (presenza)	Specifica la visibilità dell'oggetto.	Stringa	Lettura/scrittura
rawValue	Specifica il valore non formattato dell'oggetto corrente.	Varie	Lettura/scrittura
relevant	Determina sa un particolare oggetto modulo deve essere incluso nella stampa del modulo.	Stringa	Lettura/scrittura
rotate	Ruota l'oggetto intorno al punto di ancoraggio per il numero di gradi specificato.	Stringa	Lettura/scrittura
selectedIndex	Indice del primo elemento selezionato.	Numero intero	Lettura/scrittura
use	Richiama un prototipo.	Stringa	Lettura/scrittura
usehref	Richiama un prototipo esterno.	Stringa	Lettura/scrittura
validationMessage	Specifica la stringa del messaggio di convalida per il campo.	Stringa	Lettura/scrittura
vAlign	Specifica l'allineamento verticale del testo.	Stringa	Lettura/scrittura
w	Misura che specifica la larghezza per il layout.	Stringa	Lettura/scrittura
x	Specifica la coordinata X del punto di ancoraggio del contenitore, rispetto all'angolo superiore sinistro del contenitore primario, quando viene inserito utilizzando un layout posizionato.	Stringa	Lettura/scrittura
y	Specifica la coordinata Y del punto di ancoraggio del contenitore, rispetto all'angolo superiore sinistro del contenitore primario, quando viene inserito utilizzando un layout posizionato.	Stringa	Lettura/scrittura

Metodi

Nome	Descrizione	Valore restituito
addItem	Aggiunge nuove voci al campo modulo corrente. Ad esempio, questo metodo aggiunge nuove voci ad un elenco a discesa.	Vuoto
boundItem	Ottiene il valore associato di una specifica voce di visualizzazione di un elenco a discesa o di una casella di riepilogo.	Stringa
clearItems	Rimuove tutte le voci dal campo. Ad esempio, rimuove tutti gli elementi contenuti in un elenco a discesa o in una casella di riepilogo.	Vuoto
deleteItem	Elimina l’elemento specificato.	Booleano
execCalculate	Esegue qualsiasi script nell'evento calculate associato all'oggetto specificato e a eventuali oggetti secondari.	Vuoto
execEvent	Esegue lo script di evento dell'oggetto.	Vuoto
execInitialize	Esegue qualsiasi script nell'evento initialize associato all'oggetto specificato e a eventuali oggetti secondari.	Vuoto
execValidate	Esegue qualsiasi script nell'evento validate associato all'oggetto specificato e a eventuali oggetti secondari.	Vuoto
getDisplayItem	Recupera il testo visualizzato dell'elemento per l'indice dell'elemento specificato.	Stringa
getItemState	Restituisce lo stato di selezione dell'elemento specificato.	Booleano
getSaveItem	Recupera il valore dei dati per l'indice dell'elemento specificato.	Stringa
setItemState	Imposta lo stato di selezione dell'elemento specificato.	Vuoto
setItems	Aggiunge nuove voci e valori al campo modulo corrente. È ad esempio possibile utilizzare questo metodo per aggiungere nuove voci e nuovi valori come argomenti a un elenco a discesa.	Vuoto