Février 2002 (Release 6)

Cette fonction retourne l’état du bouton spécifié par ID (de la fenêtre courante), ou bien la valeur de la barre de défilement spécifiée par ID (de la fenêtre courante). Si le paramètre ID est omis, la fonction renvoie la valeur précédente de la barre de défilement la plus récemment cliquée.

Pour les boutons standards, BUTTON(ID) renvoie l’une des valeurs suivantes :

constante	Valeur	Signification
_grayBtn	0	Le bouton est grisé et inactif.
_activeBtn	1	Le bouton est actif (cliquable). Si c'est une case à cocher, elle n'est pas cochée. Si c'est un bouton radio, il n'est pas noirci.
_markedBtn	2	Le bouton est actif (cliquable). Si c'est une case à cocher, elle est cochée. Si c'est un bouton radio, il est noirci.

Avec le Runtime Appearance et les boutons poussoirs créés au moyen de la commande APPEARANCE BUTTON, l'état du bouton n'est pas retourné, vous devez utiliser la fonction de la Toolbox FN IsControlActive(BUTTON&(ID)) pour savoir si un tel bouton est actif ou grisé.

La fonction BUTTON étendue permet l’accès à diverses caractéristiques introduites par l’Appearance Manager. Utilisez les sélecteurs en conjonction avec le numéro de référence du bouton pour obtenir ce type d’information. Par exemple, pour connaître la valeur minimale d’un bouton dont le numéro de référence serait 10, vous pourriez écrire le code suivant :

Si la fonction BUTTON est appelée et que le paramètre ID ne référence aucun bouton existant, vous obtiendrez un message d’erreur “Fonction BUTTON() appelée pour un bouton non-existant”; si le paramètre selecteur n’est pas valide, vous verrez le message “Paramètre incorrect pour la fonction BUTTON()” Le tableau qui suit, liste les valeurs possibles que vous pouvez attribuer au paramètre selecteur.

selecteur	Description
< zéro	Retourne le numéro de référence du nième sous-contrôle imbriqué. La valeur absolue du paramètre est utilisée comme index. Exemple : SousControleRef = BUTTON(_monSuperControle,-3) REM retourne le numéro de référence du 3e sous-contrôle imbriqué dans le bouton _monSuperControle
_FBGetCtlRawValue	Retourne la valeur actuelle du contrôle. À la différence de la fonction standard BUTTON qui ajoute 1 à la valeur du contrôle, cette version retourne la valeur brute sans altération.
_FBGetCtlMinimum	Retourne la valeur minimale autorisée pour ce contrôle.
_FBGetCtlMaximum	Retourne la valeur maximale autorisée pour ce contrôle.
_FBGetCtlPage	Retourne la valeur page écran d'une barre de défilement.
_FBGetRootControl	Retourne le contrôle racine (root control) de la fenêtre.
_FBCountSubControls	Compte le nombre de contrôles imbriqués dans un super contrôle.
_FBGetSuperControl	Retourne le numéro de référence du super contrôle (parent).
_FBGetControlDate	Assigne à la chaîne Pascal globale gFBControlText$ le contenu sous forme textuelle d'un contrôle date. Idem pour l'heure et le record global gFBControlSeconds. Consultez la section "Boutons date et heure" à la commande APPEARANCE BUTTON.
_FBGetControlTime	Assigne à la chaîne Pascal globale gFBControlText$ le contenu sous forme textuelle d'un contrôle date. Idem pour l'heure et le record global gFBControlSeconds. Consultez la section "Boutons date et heure" à la commande APPEARANCE BUTTON.
_FBGetControlTEHandle	Retourne un handle sur le champ texte d'un contrôle qui possède un tel champ.
_FBGetBevelControlMenuHandle	Retourne le handle sur le menu d'un bouton biseauté à menu local.
_FBGetBevelControlMenuVal	Retourne la sélection courante d'un bouton biseauté à menu local.
_FBGetBevelControlLastMenu	Retourne l'identifiant de menu de la dernière sélection opérée dans bouton biseauté à menu local.
_FBGetControlMenuHandle	Retourne le handle sur le menu d'un bouton menu local standard.
_FBGetControlMenuID	Retourne la sélection courante d'un bouton menu local standard.