4D v16.3

OBJECT SET TITLE

Accueil

 
4D v16.3
OBJECT SET TITLE

OBJECT SET TITLE 


 

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

La commande OBJECT SET TITLE 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.

OBJECT SET TITLE 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é.

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 MODIFY 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 :

 QUERY([Personnes];[Personnes]Nom=vNom)
 Case of
    :(Records in selection([Personnes])=0) // Personne n'a été trouvé
       OBJECT SET TITLE(bSuppr;" Supprimer")
       OBJECT SET ENABLED(bSuppr;False)
    :(Records in selection([Personnes])=1) // Une personne a été trouvée
       OBJECT SET TITLE(bSuppr;"Supprimer la personne")
       OBJECT SET ENABLED(bSuppr;True)
    :(Records in selection([Personnes])>1) // Plusieurs personnes ont été trouvées
       OBJECT SET TITLE(bSuppr;"Supprimer les personnes")
       OBJECT SET ENABLED(bSuppr;True)
 End case

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

 OBJECT SET TITLE(*;"entete1";"Tri ascendant \\\ \\Tri descendant")
 OBJECT SET TITLE(*;"bouton1";"Cliquez ici \\pour imprimer")



Voir aussi  

_o_DISABLE BUTTON
_o_ENABLE BUTTON
OBJECT Get title

 
PROPRIÉTÉS 

Produit : 4D
Thème : Objets (Formulaires)
Numéro : 194

 
HISTORIQUE 

Modifié : 4D v6
Renommé : 4D v12

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)