La commande APPEARANCE BUTTON installe un nouveau contrôle dans la fenêtre d’affichage courante, ou modifie les caractéristiques d’un contrôle existant. Après avoir créé un bouton à l’aide de la commande APPEARANCE BUTTON, vous pouvez utiliser la fonction DIALOG pour déterminer si l’utilisateur a cliqué dessus. Vous pouvez utiliser la commande BUTTON CLOSE si vous souhaitez supprimer un bouton sans fermer la fenêtre.

Lorsque vous créez un bouton avec un identifiant spécifique (dans une fenêtre donnée), vous devez spécifier tous les paramètres jusqu’à y compris le type. Si, ultérieurement, vous souhaitez modifier les caractéristiques du bouton, vous devez exécuter à nouveau la commande BUTTON avec le même identifiant, et spécifier un ou plusieurs paramètres (à l’exception du type qui ne peut pas être changé). Le bouton sera réaffiché avec les nouvelles caractéristiques que vous aurez spécifiées; les paramètres que vous aurez omis ne seront pas modifiés.

id&	un nombre entier positif ou négatif dont la valeur absolue est dans l’intervalle 1 à 2147483647. Le nombre que vous assignez doit être différent de celui assigné à tout autre bouton ou barre de défilement présents dans la fenêtre. Les valeurs négatives construisent les boutons dans un état invisible. Les valeurs positives les construisent dans un état visible.
etat	l’état du bouton peut prendre les valeurs suivantes: _grayBtn (0/désactivé) _activebtn (1/défaut/actif) _markedBtn(2/sélectionné)
valeur, min, max	généralement ce sont des valeurs entières précisant la valeur initiale, le minimum et le maximum pour ce contrôle.
titre$	une expression chaîne de caractères. Ce paramètre n’est pas utilisé pour attribuer le texte des boutons définis avec _kControlStaticTextProc ou _kControlEditTextProc. Voir DEF SETBUTTONTEXTSTRING pour savoir comment cela peut s’accomplir.
rect	un rectangle en coordonnées locales à la fenêtre que vous pouvez exprimer sous deux formes : (x1,y1)-(x2,y2) Deux points diagonalement opposés. @rectAdresse& Une expression sur un entier long ou un pointeur sur une variable qui pointe sur une structure de 8 octets telle qu’une variable de type RECT.
type	L’un des nombreux types listés dans le texte qui suit.

A la création d’un bouton, les valeurs par défaut attribuées aux paramètres éventuellement manquants sont :

Vous pouvez masquer le contrôle avec l’une des commandes BUTTON -1 ou APPEARANCE BUTTON -1 et vous pouvez désactiver le contrôle avec soit BUTTON 1, _grayBtn ou APPEARANCE BUTTON 1, _grayBtn. Les panneaux utilisateurs sont masqués et révélés selon qu’ils doivent apparaître à l’écran ou non lorsque l’utilisateur interagit avec les onglets. Les boutons de groupe affectent aussi l’ensemble des boutons qu’ils fédèrent.

Pour lire la valeur d’un bouton de l’Appearance, utilisez soit x = BUTTON(id) ou x = BUTTON(id, _FBGetCtlRawValue)

Les routines utilitaires suivantes vous aideront à accéder aux informations relatives aux contrôles du runtime Appearance :

L’Appearance Manager (le Gestionnaire d’Apparence) a introduit de nombreuses définitions de contrôles. Bien que l’intention ici ne soit pas de documenter complètement tous les nouveaux boutons introduits par Apple, un grand nombre d’entre eux sont illustrés ci-après avec des exemples de code montrant comment les implémenter.

Boutons poussoirs :

Du fait que l’Appearance Manager est disponible à la fois avec le Système 9 et OS X, vous constaterez des différences notoires dans la manière dont les contrôles sont affichés à l’écran. Les boutons poussoirs sont montrés ci-dessous dans les deux versions du système.

Le code source qui suit a été utilisé pour générer l’affichage ci-dessus 

Tous les types de boutons (et leurs variations) ne sont pas montrés ici. Par exemple, le contrôle qui affiche une flèche indiquant la présence d’un menu a été construit avec un petit biseau. Il aurait pu être créé avec un biseau plus grand comme ceci :

Les autres types de boutons que vous pouvez explorer sont :

Avec l’Appearance Manager vous avez la possibilité de grouper des éléments, de les placer sur des “placards” (pancartes), ou de les séparer par des lignes de division. L’exemple suivant crée des boutons sur un fond blanc de manière à ce que vous puissiez voir plus facilement le dessin qui est effectué par la définition du contrôle. Nous commençons par le code source utilisé pour créer les boutons :

Une partie de la puissance des boutons de l’Appearance Manager tient au fait qu’un bouton peut être inclus dans un autre. En désactivant ou masquant le bouton parent (appelé super contrôle) on peut automatiquement activer ou masquer tous les boutons qu’il englobe. Chaque fenêtre possède un contrôle principal dit contrôle racine (root control). L’exemple qui suit construit une fenêtre avec un bouton groupe radio parent qui contiendra trois boutons radio. Nous pouvons déterminer lequel des trois boutons a été sélectionné en récupérant la valeur (via la fonction BUTTON) du bouton parent.

Cases à cocher :

En dehors de la différence évidente dans leur aspect physique avec l’Appearance Manager, les cases à cocher suivent les règles d’utilisation qu’elles ont toujours suivies. Toutefois, il y a une notable exception à cette règle avec la possibilité de leur donner une valeur “mixte”.

Ce type de case contient un tiret au lieu d’une coche pour montrer qu’une partie, et non l’ensemble, des éléments appartenant à la sélection courante possède une caractéristique particulière.

Ceci implique une nouvelle valeur maximale possible de 2 pour ce type de contrôle (_kControlCheckBoxMixedValue = 2).

Voici les valeurs possibles d’une case à cocher :

Les boutons de la copie d’écran ci-dessus ont été créés avec les lignes de code suivantes :

Vous ne pouvez pas utiliser la commande BUTTON bRef,etat pour modifier l’état des boutons dont le type est soit _kControlGroupBoxCheckBoxProc ou bien _kControlGroupBoxSecondaryCheckBoxProc. Utilisez APPEARANCE BUTTON bRef,,state-1 à la place. (BUTTON bRef,0 et BUTTON bRef,1 pourront cependant respectivement désactiver ou activer le bouton ).

Boutons heure et date :

En plus des boutons traditionnels, l’Appearance Manager peut créer des boutons qui gèrent les dates et les heures. Des structures de données spécifiques sont maintenues pour accéder à l’information contenue dans ces contrôles. En examinant quelques exemples simples vous pourrez très vite les maîtriser.

La fonction BUTTON améliorée vous sera utile pour extraire les données complexes des contrôles, et en particulier ici les deux instructions suivantes :

L’utilisation de l’une ou l’autre de ces syntaxes remplira un record global date/heure nommé gFBControlLongDate et un autre nommé gFBControlSeconds. gFBControlSeconds est une variable signée sur 64 bits qui peut être sauvegardée dans un fichier ou utilisée dans une variable qui nécessite un stockage compressé.

Le format de gFBControlLongDate est celui d’une structure LongDateRec qui se présente ainsi :

Après avoir appelé la fonction BUTTON pour examiner le contenu d’un contrôle, vous pouvez extraire des portions d’informations de la structure date/heure comme suit :

Une autre variable est maintenue pour contenir le texte spécifique d’un contrôle date/heure. Le contenu de gFBControlText (une chaîne Pascal) est déterminé par le second paramètre de la fonction BUTTON. Lorsque la constante _FBGetControlDate est utilisée, le contenu est une date. Lorsque la constante _FBGetControlTime est utilisée, le contenu est une heure.

Lorsque vous créez un contrôle Date/Heure en spécifiant un type particulier, vous devez aussi spécifier une valeur initiale au contrôle parmi les valeurs suivantes :

Les instructions utilisées pour créer l’exemple ci-dessus sont les suivantes :

Pour extraire et afficher le contenu d’un contrôle, les instructions suivantes peuvent être utilisées :

Etat d’attente :

L’Appearance Manager propose plusieurs méthodes pour indiquer à l’utilisateur que votre application est occupée à exécuter une tâche particulière. Ceci inclue les flèches poursuite ou tournoyantes et les barres de progression à durée finie ou indéterminée. Le contrôle flèches tournoyantes est facile à créer et à gèrer. Chaque fois que votre programme exécute sa boucle événementielle principale, les flèches sont alors animées. Les instructions suivantes créent un contrôle flèches tournoyantes : APPEARANCE BUTTON bRef,_activeBtn,0,0,1,,@r,_kControlChasingArrowsProc

Les barres de progression sont aussi facilement créées, mais vous devez vous rappeler un certain nombre de choses : en premier lieu, une barre de progression opère dans un intervalle allant de -32768 à +32767. Si votre tâche nécessite un plus grand nombre d’étapes, vous devrez calculer un quotient pour conserver les valeurs à l’intérieur de cet intervalle. Ensuite, votre programme doit se charger de mettre à jour la barre de progression. Ceci est aussi simple que d’assigner une nouvelle valeur à un bouton, mais c’est toutefois du code qu’il vous faudra écrire.

Les valeurs maximale et minimale du contrôle deviennent les valeurs maximale et minimale de la barre de progression. La valeur initiale ou la valeur courante indiquent le taux de progression. Dans l’exemple ci-dessus, le bouton a été créé à l’aide du code source suivant :

La valeur minimale était 0, et le maximum 100. Au moment de sa création, la valeur du contrôle était 50, si bien que le contrôle affiche une progression de 50%, à la moitié de la valeur maximale. Pour indiquer l’étape suivante dans la progression, nous pourrions écrire l’instruction ci-dessous :

Les barres de progression à durée indéterminée sont plus complexes. Après la création d’un tel contrôle, vous devez assigner une nouvelle valeur à une donnée interne du contrôle. Le code source qui suit vous montre comment :

Sélecteurs d’intervalle (glissières et flèches) :

Il y a plusieurs variantes de glissières. Toutes se réfèrent à la simple constante _kControlSliderProc. Les paramètres supplémentaires ajoutés à cette constante déterminent les caractéristiques de la glissière. Les constantes pour les variantes sont les suivantes : _kControlSliderLiveFeedback _kControlSliderHasTickMarks _kControlSliderReverseDirection _kControlSliderNonDirectional Pour créer une glissière dont l’indicateur pointe vers le haut et qui possède des marques de division, le type suivant pourrait être utilisé : _kControlSliderProc + _kControlSliderHasTickMarks + _kControlSliderReverseDirection

Les glissières verticales sont créées en construisant un bouton dont la hauteur est plus grande que la largeur. L’orientation est gérée automatiquement par le système.

Les lignes qui suivent montrent comment l’affichage ci-dessus a été créé :

Lorsque le bouton à glissière est créé, le nombre de marques de division est déterminé par la valeur initiale du contrôle. Après que le contrôle a été créé, sa valeur est réinitialisée à la valeur minimale assignée au contrôle. L’intervalle des valeurs possibles pour une glissière s’étend de -32768 à +32767. Il vous revient de déterminer le nombre de marques de division en tenant compte de la taille du contrôle et de l’intervalle de ses valeurs possibles (minimum/maximum).

Les petites flèches (montrées dans l’illustration ci-avant) sont utilisées pour incrémenter ou décrémenter une valeur généralement affichée dans un champ d’édition associé. La version actuelle de ce contrôle dans OS X ne permet pas de variations dans la hauteur du contrôle. La hauteur du contrôle doit être de 22 pixels exactement, toute autre valeur donne des résultats inattendus.

Menus locaux :

Il y a deux types de menus locaux distincts : bouton biseauté à menu local et menu local standard. L’utilisation de l’un ou l’autre de ces types de contrôle doit être guidée par les besoins de votre application et les règles concernant l’interface utilisateur édictées par Apple (Human Interface Guide Lines). Les boutons biseautés sont créés comme suit :

Lorsqu’un bouton biseauté à menu local est créé, la valeur initiale du contrôle correspond au numéro identifiant de la ressource de menu associée. Pour extraire l’information d’un tel contrôle, trois instructions spécifiques peuvent être utilisées avec la fonction BUTTON :

Boutons à menu local :

Les menus locaux standards suivent une syntaxe légèrement différente. La valeur minimale devient l’identifiant de la ressource de menu associée. La valeur maximale représente la largeur assignée au titre du menu. Si vous passez -12345 comme identifiant de menu aucune ressource ne sera recherchée pour l’associer au contrôle, vous pourrez alors construire le menu et assigner ultérieurement son handle à la structure interne du contrôle avec une instruction du type suivant :

Vous pouvez également passer -1 comme valeur maximale du contrôle, la largeur du titre de menu sera alors calculée automatiquement pour vous. Si vous passez zéro comme valeur maximale, le titre du menu ne sera pas affiché. Après la création du contrôle, vous pouvez assigner ses valeurs courantes, minimale et maximale pour attibuer la largeur correcte au menu.

Le bouton menu local de l’illustration ci-dessus a été créé avec le code suivant :

La fonction BUTTON vous permet de retrouver le handle pointant sur le menu associé. Rappelez-vous que les boutons menus locaux standards et les boutons biseautés nécessitent des constantes différentes pour accéder à cette information.

L’article courant peut être retrouvé de la manière suivante :

Listes :

Généralement, les listes utilisent une ressource auxilliaire qui définit leur format. Cette ressource possède le type "ldes". Vous pouvez créer une telle ressource à l’aide de Resorcerer 2.4 ou une version ultérieure ou bien en créant le modèle adéquat avec tout autre éditeur de ressources. Vous pouvez également formater un handle de telle sorte qu’il corresponde à une structure "ldes" et le sauvegarder en tant que ressource. Le numéro identifiant de ressource doit être passé dans le paramètre valeur lorsque le contrôle est créé. Vous pouvez aussi passer zéro comme valeur, auquel cas l’Appearance Manager ne recherchera pas de ressource pour construire le contrôle liste. La liste sera créée avec des valeurs par défaut et utilisera la définition standard LDEF (0). Vous pouvez modifier la liste en récupérant son handle. Vous pouvez attribuer une définition de liste (LDEF) à l’aide de la constante _kControlListBoxLDEFTag en conjonction avec la commande DEF SETBUTTONDATA.

Une ressource ldes est définie comme suit :

L’exemple qui suit, crée un contrôle liste à partir d’une ressource dont le numéro identifiant est 256, puis la liste est remplie avec des éléments textuels.

Pour simplifier cet exemple. Resorcerer a été utilisé pour créer la ressource ldes.

Boutons à onglets :

Les boutons à onglets nécessitent plus de travail que les autres contrôles. Cela tient au fait que ce type de bouton comprend en réalité plusieurs contrôles imbriqués qui doivent fonctionner harmonieusement. Il y a tout d’abord le contrôle principal. Lors de sa création, vous spécifiez le nombre d’onglets qu’il contient avec le paramètre représentant la valeur maximale. Généralement, il est préférable de créer ce contrôle dans un état invisible en spécifiant un numéro de référence négatif, vous pourrez ensuite l’afficher à l’aide de la commande BUTTON avec, cette fois-ci, un numéro de référence positif.

Après la création du contrôle principal, vous devez attribuer un titre à chaque onglet à l’aide de la commande DEF SETBUTTONDATA. Puis, les panneaux utilisateurs (user panes) sont insérés. Ils sont imbriqués dans le contrôle principal avec la commande DEF EMBEDBUTTON. Les boutons qui résident dans un panneau spécifique doivent être créés et aussi imbriqués dans le panneau utilisateur auquel ils appartiennent.

Lorsqu’un événement de dialogue est intercepté, la valeur du contrôle principal correspond au rang de l’onglet cliqué dans la liste des onglets. Votre programme doit passer en revue tous les panneaux imbriqués afin de les montrer ou les masquer de telle sorte que l’affichage corresponde à l’onglet qui aura été cliqué, c’est-à-dire au choix de l’utilisateur.

Etudiez l’exemple qui suit pour voir comment on peut gérer un bouton à onglets. Examinez le gestionnaire de dialogue qui traite l’interaction de l’utilisateur avec les boutons.

Il y a différents styles de boutons à onglets :

Cet exemple utilise _kControlTabSmallProc, mais vous pouvez expérimenter les autres types et examiner les résultats.