OBJECT SET ENTERABLE

4D v16.3


OBJECT SET ENTERABLE ( {* ;} objet ; saisissable )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une table, un champ ou une variable
objet	Objet de formulaire	Nom d'objet (si * spécifié) ou Table ou Champ ou Variable (si * omis)
saisissable	Booléen	Vrai = saisissable ; Faux = non saisissable

Description

OBJECT SET ENTERABLE rend saisissable ou non saisissable le ou les objet(s) de formulaire désigné(s) par objet.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d'objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre objet est une table, un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de table, de champ ou de variable (champ ou variable objet uniquement). Pour plus d'informations sur les noms d'objets, reportez-vous à la section Objets de formulaires.

L'utilisation de cette commande est équivalente à la sélection de l'option Saisissable pour un champ ou une variable dans la Liste des propriétés de l'éditeur de formulaires. OBJECT SET ENTERABLE fonctionne avec un sous-formulaire uniquement si elle se trouve dans la méthode formulaire du sous-formulaire.

Lorsque zoneSaisie est saisissable (Vrai), l'utilisateur peut y placer le curseur pour saisir des données. Lorsque zoneSaisie est non saisissable (Faux), l'utilisateur ne peut pas placer le curseur dans la zone et ne peut donc pas saisir de valeurs.

La commande OBJECT SET ENTERABLE permet également d’activer par programmation le mode “Saisie en liste” pour les sous-formulaires et les formulaires liste affichés par les commandes MODIFY SELECTION et DISPLAY SELECTION :

Pour les sous-formulaires, vous pouvez passer dans le paramètre objet soit le nom de la table du sous-formulaire, soit le nom de l’objet sous-formulaire lui-même, par exemple : OBJECT SET ENTERABLE(*;"Sousform";Vrai)
Pour les formulaires liste, vous devez passer le nom de la table du formulaire dans le paramètre objet, par exemple : OBJECT SET ENTERABLE([MaTable];Vrai).

Rendre un objet non saisissable n'empêche pas sa modification par programmation.

Note : Vous rendez une cellule de list box non saisissable en passant la valeur -1 à $0 dans l'événement On Before Data Entry, cf. paragraphe Gestion de la saisie.

Exemple 1

L'exemple suivant définit un champ de type d'expédition suivant le poids d'un colis expédié. Si le colis pèse un kilo ou moins, l'expéditeur sera La Poste et le champ est rendu non saisissable. Sinon, le champ est rendu saisissable.

 If([Expédition]Poids<=1)

    [Expédition]Type:="La Poste"

    OBJECT SET ENTERABLE([Expédition]Type;False)

 Else

    OBJECT SET ENTERABLE([Expédition]Type;True)

 End if

Exemple 2

Voici la méthode objet d’une case à cocher placée dans l’en-tête d’une liste pour contrôler le mode Saisie en liste :

 C_BOOLEAN(bSaisissable)

 OBJECT SET ENTERABLE([Table1];bSaisissable)

Voir aussi

_o_DISABLE BUTTON
_o_ENABLE BUTTON
OBJECT Get enterable
OBJECT SET VISIBLE