field

L’objet field décrit un conteneur interactif unique pouvant récupérer et présenter un contenu de données.

En termes d’objets disponibles dans la Bibliothèque d’objets de Designer, l’objet de champ est la définition XML de base pour les objets suivants :

Codes à barres
Bouton
Date/Heure
Champ décimal
Champ de signature
Bouton Envoyer par messagerie
Bouton Envoyer via HTTP
Champ d’image
Champ numérique
Code à barres de formulaires pour support papier
Champ du mot de passe
Bouton Imprimer
Bouton Réinitialiser
Champ de texte

Vous pouvez définir des messages de validation personnalisés. Un champ unique peut contenir jusqu’à trois messages, un pour le test de script, pour le test d’image et pour le test null. Une fois spécifiés, ils peuvent être accédés au moyen de la syntaxe suivante :

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

Vous pouvez aussi accéder à ces messages de validation à l’aide de leurs propriétés raccourci.

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Lorsque ces valeurs ne sont pas remplies, le processeur construit un message par défaut.

Un champ peut avoir au maximum un test de validation en état d’échec à un moment donné. Les tests de validation sont évalués dans l’ordre suivant, et l’évaluation s’arrête au premier test qui échoue :

Hiérarchie des objets

Modèle

Objets enfant

Classe parent

container, classe

Propriétés

Nom	Description	Type	Accès
{default}	Représente la valeur réelle stockée par un objet.	Variable	Lecture/écriture
access	Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.	Chaîne	Lecture/écriture
accessKey	Spécifie une touche d’accès rapide utilisée par une application interactive pour déplacer la cible d’action vers un élément de champ particulier.	Chaîne	Lecture/écriture
anchorType	Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.	Chaîne	Lecture/écriture
borderColor	Indique la valeur de la couleur de la bordure pour ce champ.	Chaîne	Lecture/écriture
borderWidth	Indique la largeur de la bordure pour ce champ.	Chaîne	Lecture/écriture
colSpan	Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.	Chaîne	Lecture/écriture
editValue	Indique la valeur d’édition pour le champ.	Chaîne	Lecture/écriture
errorText	Renvoie le message de validation du premier test de validation ayant échoué ou une chaîne vide si ce champ a passé avec succès tous les tests de validation.	Chaîne	Lecture
fillColor	Valeur de la couleur d’arrière-plan pour ce champ.	Chaîne	Lecture/écriture
fontColor	Spécifie la valeur de la couleur de premier plan pour ce champ. Elle équivaut à l’expression font.fill.color.value.	Chaîne	Lecture/écriture
formatMessage	Indique la chaîne de message pour la validation du format pour ce champ.	Chaîne	Lecture/écriture
formattedValue	Indique la valeur formatée pour le champ.	Chaîne	Lecture/écriture
h	Mesure de la hauteur pour la disposition.	Chaîne	Lecture/écriture
hAlign	Indique l’alignement de texte horizontal.	Chaîne	Lecture/écriture
length	Indique le nombre d’objets dans la liste.	Entier	Lecture
locale	Indique la langue, la devise et le format de date/heure à utiliser pour le contenu de l’objet.	Chaîne	Lecture/écriture
mandatory	Indique la valeur nullTest pour le champ.	Chaîne	Lecture/écriture
mandatoryMessage	Indique la chaîne de message obligatoire pour ce champ.	Chaîne	Lecture/écriture
maxH	Indique la hauteur maximale à des fins de disposition.	Chaîne	Lecture/écriture
maxW	Indique la largeur maximale à des fins de disposition.	Chaîne	Lecture/écriture
minH	Indique la hauteur maximale à des fins de disposition.	Chaîne	Lecture/écriture
minW	Indique la largeur maximale à des fins de disposition.	Chaîne	Lecture/écriture
parentSubform	Indique le sous-formulaire (page) parent du champ.	Objet	Lecture
presence	Indique si un objet est visible ou non.	Chaîne	Lecture/écriture
rawValue	Indique la valeur non formatée de l’objet actuel.	Variable	Lecture/écriture
relevant	Contrôle si un objet de formulaire est inclus dans l’opération d’impression.	Chaîne	Lecture/écriture
rotate	Fait pivoter l’objet autour de son point d’ancrage selon l’angle indiqué.	Chaîne	Lecture/écriture
selectedIndex	Index du premier élément sélectionné.	Entier	Lecture/écriture
use	Appelle un prototype.	Chaîne	Lecture/écriture
usehref	Appelle un prototype externe.	Chaîne	Lecture/écriture
validationMessage	Indique la chaîne de message de validation pour ce champ.	Chaîne	Lecture/écriture
vAlign	Indique l’alignement de texte vertical.	Chaîne	Lecture/écriture
w	Mesure indiquant la largeur pour la disposition.	Chaîne	Lecture/écriture
x	Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.	Chaîne	Lecture/écriture
y	Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.	Chaîne	Lecture/écriture

Méthodes

Nom	Description	Renvoie
addItem	Ajoute de nouveaux éléments au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments à une liste déroulante.	Vide
boundItem	Récupère la valeur liée d’un élément d’affichage spécifique dans une liste déroulante ou une zone de liste.	Chaîne
clearItems	Supprime tous les éléments du champ. Cette méthode supprime par exemple tous les éléments contenus dans une zone de liste ou une liste déroulante.	Vide
deleteItem	Supprime l’élément spécifié.	Booléen
execCalculate	Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.	Vide
execEvent	Exécute le script d’événement de l’objet.	Vide
execInitialize	Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.	Vide
execValidate	Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.	Vide
getDisplayItem	Récupère le texte d’affichage de l’élément pour l’index d’élément spécifié.	Chaîne
getItemState	Renvoie l’état de sélection de l’élément spécifié.	Booléen
getSaveItem	Récupère la valeur de données pour l’index d’élément spécifié.	Chaîne
setItemState	Définit l’état de sélection de l’élément spécifié.	Vide
setItems	Ajoute de nouveaux éléments et de nouvelles valeurs au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments et des valeurs comme arguments à une liste déroulante.	Vide