4D Doc Center : OBJET FIXER SAISISSABLE

4D v14.3

OBJET FIXER SAISISSABLE


OBJET FIXER SAISISSABLE ( {* ;} 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

OBJET FIXER SAISISSABLE 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 Propriétés des objets.

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. OBJET FIXER SAISISSABLE 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 OBJET FIXER SAISISSABLE permet également d’activer par programmation le mode “Saisie en liste” pour les sous-formulaires et les formulaires liste affichés par les commandes MODIFIER SELECTION et VISUALISER 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 : OBJET FIXER SAISISSABLE(*;"Sousform";Vrai)
Pour les formulaires liste, vous devez passer le nom de la table du formulaire dans le paramètre objet, par exemple : OBJET FIXER SAISISSABLE([MaTable];Vrai).

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

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.

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

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

    OBJET FIXER SAISISSABLE([Expédition]Type;Faux)

 Sinon

    OBJET FIXER SAISISSABLE([Expédition]Type;Vrai)

 Fin de si

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_BOOLEEN(bSaisissable)

 OBJET FIXER SAISISSABLE([Table1];bSaisissable)