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 :

  1. nullTest

  2. formatTest

  3. scriptTest

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