Syntaxe :
DEF BUTTONHELPSETTEXT ( btnID%|& , messageAide$ )
Révision :
Mai, 2003 (Release 8)
Description :
Cette routine associe la chaîne messageAide$ au bouton spécifié par son identifiant bntID.
Comportement des applications Carbon
Avec Carbon, les info-bulles remplacent avantageusement les bulles d'aide, mais quel que soit le mécanisme qui doit être mis en œuvre, les messages d'aide se doivent de fournir une information concise et précise sur l'action déclenchée par le bouton située directement sous le pointeur de la souris. Les info-bulles sont affichées automatiquement par le système quand aucun autre événement de plus grande priorité n'est en attente de traitement et elles disparaissent de l'écran aussitôt qu'une interaction de l'utilisateur avec l'application doit être gérée.
Du fait que les info-bulles sont beaucoup plus subtiles que les démodées bulles d'aide, Apple a décidé que leur statut serait d'être visibles par défaut. Vous pouvez changer ce statut à l'aide la routine DEF BUTTONHELPSHOW.
La chaîne messageAide$ peut contenir des caractères d'échappement pour, d'une part, paramètrer l'alignement de l'info-bulle, mais aussi pour établir un message alternatif ou supplémentaire qui d'ordinaire apparaît lorsque la touche Commande est maintenue enfoncée. Le format de la chaîne peut se définir comme ceci :
"messageAide[\§[+]supplementMessage][@codeAlignement]" où :
\§ indique la fin du premier message d'aide et le début du second. Optionnellement, vous pouvez ajouter le second message au premier avec le symbole +.
\@codeAlignement indique la position de l'info-bulle relative au bouton auquel elle est associée. Vous pouvez utiliser l'un des codes d'alignement suivants : (T, L, B, R et C signifient respectivement haut, gauche, bas, droite et centre) :
T; L; B; R; LC(CL); RC(CR); TL; TR; LT; LB; BL; BR; RT; RB.
Par exemple, la chaîne ci-dessous produirait une info-bulle qui s'afficherait en haut du bouton. Avec la touche Commande appuyée, un message supplémentaire serait adjoint au message original :
Comportement des applications Carbon
Avec Carbon, les info-bulles remplacent avantageusement les bulles d'aide, mais quel que soit le mécanisme qui doit être mis en œuvre, les messages d'aide se doivent de fournir une information concise et précise sur l'action déclenchée par le bouton située directement sous le pointeur de la souris. Les info-bulles sont affichées automatiquement par le système quand aucun autre événement de plus grande priorité n'est en attente de traitement et elles disparaissent de l'écran aussitôt qu'une interaction de l'utilisateur avec l'application doit être gérée.
Du fait que les info-bulles sont beaucoup plus subtiles que les démodées bulles d'aide, Apple a décidé que leur statut serait d'être visibles par défaut. Vous pouvez changer ce statut à l'aide la routine DEF BUTTONHELPSHOW.
La chaîne messageAide$ peut contenir des caractères d'échappement pour, d'une part, paramètrer l'alignement de l'info-bulle, mais aussi pour établir un message alternatif ou supplémentaire qui d'ordinaire apparaît lorsque la touche Commande est maintenue enfoncée. Le format de la chaîne peut se définir comme ceci :
"messageAide[\§[+]supplementMessage][@codeAlignement]" où :
\§ indique la fin du premier message d'aide et le début du second. Optionnellement, vous pouvez ajouter le second message au premier avec le symbole +.
\@codeAlignement indique la position de l'info-bulle relative au bouton auquel elle est associée. Vous pouvez utiliser l'un des codes d'alignement suivants : (T, L, B, R et C signifient respectivement haut, gauche, bas, droite et centre) :
T; L; B; R; LC(CL); RC(CR); TL; TR; LT; LB; BL; BR; RT; RB.
Par exemple, la chaîne ci-dessous produirait une info-bulle qui s'afficherait en haut du bouton. Avec la touche Commande appuyée, un message supplémentaire serait adjoint au message original :
message = "Quittez la démo\§+et ça me fera des vacances\@T"
Comportement en PPC (à partir de Mac OS 8.5)
Les applications PPC utilisent le mécanisme des bulles d'aide pour afficher le message associé à un bouton donné. Cependant, une étape supplémentaire est requise pour que la bulle d'aide apparaisse effectivement à l'écran. Quand votre gestionnaire d'événement de dialogue intercepte un événement de curseur, vous devez appeler la routine DEF BUTTONHELPDISPLAY si le pointeur de la souris survole le bouton concerné dans la fenêtre active. Si l'affichage des bulles d'aide a été activé par l'utilisateur au niveau du système, alors le message est affiché. Notez que le message d'aide supplémentaire est ignoré en PPC.
Les applications PPC utilisent le mécanisme des bulles d'aide pour afficher le message associé à un bouton donné. Cependant, une étape supplémentaire est requise pour que la bulle d'aide apparaisse effectivement à l'écran. Quand votre gestionnaire d'événement de dialogue intercepte un événement de curseur, vous devez appeler la routine DEF BUTTONHELPDISPLAY si le pointeur de la souris survole le bouton concerné dans la fenêtre active. Si l'affichage des bulles d'aide a été activé par l'utilisateur au niveau du système, alors le message est affiché. Notez que le message d'aide supplémentaire est ignoré en PPC.
Exemple :
DEF BUTTONHELPSETTEXT (_quitterBtn, "Shutdown the application")
Note :
Vous devez inclure le fichier “Subs Help tags.Incl” dans votre projet pour rendre cette commande accessible à votre programme.