4D v14.3

OBJET LIRE TAILLE OPTIMALE

Accueil

 
4D v14.3
OBJET LIRE TAILLE OPTIMALE

OBJET LIRE TAILLE OPTIMALE 


 

OBJET LIRE TAILLE OPTIMALE ( {* ;} objet ; largeurOpti ; hauteurOpti {; largeurMaxi} ) 
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 Champ ou variable (si * est omis
largeurOpti  Entier long in Largeur optimale de l’objet
hauteurOpti  Entier long in Hauteur optimale de l’objet
largeurMaxi  Entier long in Largeur maximum de l’objet

La commande OBJET LIRE TAILLE OPTIMALE retourne dans les paramètres largeurOpti et hauteurOpti la largeur et la hauteur “optimales” de l’objet de formulaire désigné par les paramètres * et objet. Ces valeurs sont exprimées en pixels. Cette commande est particulièrement utile dans le cadre de l’affichage ou de l’impression d’états complexes, associée à la commande OBJET DEPLACER.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne de caractères). Si vous ne passez pas le paramètre *, vous indiquez que objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable (de type objet uniquement).

Les valeurs optimales retournées indiquent la taille minimale de l’objet pour que son contenu courant soit entièrement inclus dans ses limites. En général, ces valeurs n’ont de sens qu’avec des objets contenant du texte. Ce calcul tient compte de la police, de sa taille, de son style et du contenu de l’objet. Il tient compte également des césures et des retours chariot. A noter que dans le cas des boutons 3D, la commande fonctionne même si le bouton contient uniquement une icône.
Si l’objet spécifié est vide, la largeurOpti retournée est 0.

La taille retournée ne tient pas compte du cadre graphique éventuellement appliqué autour de l’objet ni des barres de défilement. Pour obtenir la taille réelle d’un objet à l’écran, il sera nécessaire d’ajouter l’épaisseur de ces éléments.

Le paramètre optionnel largeurMax vous permet d’attribuer une largeur maximale à l’objet. Si la largeur optimale de l’objet est supérieure à cette valeur, OBJET LIRE TAILLE OPTIMALE retourne largeurMax dans le paramètre largeurOpti et augmente la hauteur optimale en conséquence.

Les objets pris en charge par cette commande sont les suivants :

  • Zones de texte statiques
  • Textes insérés sous forme de références
  • Champs et variables de type Alpha, Texte, Réel, Entier, Entier long, Date, Heure, Booléens (cases à cocher et boutons radio)
  • Boutons

Pour tous les autres types d’objets de formulaires (zones de groupes, onglets, rectangles, droites, cercles/ellipses, zones externes, etc.), la commande OBJET LIRE TAILLE OPTIMALE retourne la taille courante de l’objet (définie dans l’éditeur de formulaires et éventuellement à l’aide de la commande OBJET DEPLACER).

Exemple  

Reportez-vous à l’exemple de la routine FIXER TAQUET IMPRESSION.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Objets (Formulaires)
Numéro : 717
Nom intl. : OBJECT GET BEST SIZE

 
HISTORIQUE 

Créé : 4D 2003
Renommé : 4D v12

 
VOIR AUSSI  

FIXER TAQUET IMPRESSION
OBJET DEPLACER

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Hérité de : TAILLE OBJET OPTIMALE ( 4D v11 SQL Release 6)