4D Doc Center : OBJET FIXER TITRE

4D v14.3

OBJET FIXER TITRE


OBJET FIXER TITRE ( {* ;} objet ; libellé )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d'objet (si * est spécifié) ou Variable (si * est omis)
libellé	Chaîne	Nouveau libellé de l'objet

Description

La commande OBJET FIXER TITRE change le libellé du ou des objets(s) spécifié(s) dans le paramètre objet et le remplace par la valeur définie dans le paramètre libellé.

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 ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable (variable objet uniquement). Pour plus d'informations sur les noms d'objets, reportez-vous à la section Objets de formulaires.

OBJET FIXER TITRE peut s'appliquer à tous les types d'objets simples contenant un libellé :

boutons et boutons 3D,
cases à cocher et cases à cocher 3D,
boutons radio et boutons radio 3D,
en-têtes de list box,
textes statiques,
zones de groupe.

Généralement, cette commande s'applique à un objet à la fois. La zone de libellé de l'objet doit être assez grande pour pouvoir accueillir le texte ; sinon, le texte est tronqué.

N'utilisez pas de retours chariot dans libellé.

Si vous souhaitez définir un libellé sur plusieurs lignes, utilisez le caractère "\" ("\\" dans l'éditeur de code) comme retour à la ligne. Cette possibilité est permise pour les boutons 3D, cases à cocher 3D, boutons radio 3D et les en-têtes de list box.

Note : Passez "\\\" si vous souhaitez utiliser le caractère "\" dans le libellé.

Exemple 1

L'exemple suivant est la méthode objet d'un bouton de recherche situé dans la zone de pied de page d'un formulaire sortie affiché par la commande MODIFIER SELECTION. La méthode effectue une recherche dans une table et active ou inactive le bouton intitulé bSuppr et change son titre, en fonction des résultats de la recherche :

 CHERCHER([Personnes];[Personnes]Nom=vNom)

 Au cas ou

    :(Enregistrements trouves([Personnes])=0) // Personne n'a été trouvé

       OBJET FIXER TITRE(bSuppr;" Supprimer")

       OBJET FIXER ACTIVATION(bSuppr;Faux)

    :(Enregistrements trouves([Personnes])=1) // Une personne a été trouvée

       OBJET FIXER TITRE(bSuppr;"Supprimer la personne")

       OBJET FIXER ACTIVATION(bSuppr;Vrai)

    :(Enregistrements trouves([Personnes])>1) // Plusieurs personnes ont été trouvées

       OBJET FIXER TITRE(bSuppr;"Supprimer les personnes")

       OBJET FIXER ACTIVATION(bSuppr;Vrai)

 Fin de cas

Exemple 2

Vous souhaitez insérer des libellés sur deux lignes :

 OBJET FIXER TITRE(*;"entete1";"Tri ascendant \\\ \\Tri descendant")

 OBJET FIXER TITRE(*;"bouton1";"Cliquez ici \\pour imprimer")