MessageBox (FPScript)
Affiche une boîte à messages.
Syntaxe
MessageBox(Title, Text, [ Type = TYPE_OK ], [ Icon = ICON_NONE ], [ Timeout = 0 ] [ , ShowTimeout = FALSE ])
La syntaxe de la fonction MessageBox se compose des éléments suivants :
Section |
Description |
||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Title |
Chaîne de caractères avec un titre pour la boîte à messages. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
||||||||||||||||||||||||||||
Text |
Chaîne de caractères avec le texte de la boîte à messages. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
||||||||||||||||||||||||||||
Type |
Le type de boîte à messages. L'argument Type peut avoir les valeurs suivantes :
Si l'argument n'est pas spécifié, il est défini à la valeur par défaut TYPE_OK . |
||||||||||||||||||||||||||||
Icon |
Détermine l'icône à afficher à côté du texte. L'argument Icon peut avoir les valeurs suivantes :
Si l'argument n'est pas spécifié, il est défini à la valeur par défaut ICON_NONE . |
||||||||||||||||||||||||||||
Timeout |
Durée maximale d'affichage de la boîte à messages en secondes. Si vous mettez l'argument à 0 ou si vous l'omettez, la boîte à messages apparaîtra indéfiniment. Pour le groupe TYPE_YESNO et TYPE_ABORTRETRYIGNORE , le temps d'affichage ne peut pas être restreint. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. La valeur doit être supérieure ou égale à 0. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0 . |
||||||||||||||||||||||||||||
ShowTimeout |
Indique si le temps d'affichage restant doit apparaître dans le titre de la boîte de message. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut FALSE . |
Remarques
Le résultat est un nombre entier, qui détermine quel bouton est enfoncé. Si vous avez précisé l'argument Timeout, la valeur de retour BUTTON_TIMEOUT indiquera que la durée maximale d'affichage a été dépassée.
Si un argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.
La fonction renvoie l'une des valeurs suivantes :
Constante |
Signification |
|---|---|
BUTTON_TIMEDOUT |
Boîte à messages fermée pour cause de dépassement de temps de session. |
BUTTON_OK |
Le bouton OK a été enfoncé. |
BUTTON_CANCEL |
Le bouton Annuler (Cancel) a été enfoncé. |
BUTTON_ABORT |
Le bouton Abandonner (Abort) a été enfoncé. |
BUTTON_RETRY |
Le bouton Répéter a été enfoncé. |
BUTTON_IGNORE |
Le bouton Ignorer a été enfoncé. |
BUTTON_YES |
Le bouton Oui a été enfoncé. |
BUTTON_NO |
Le bouton Non a été enfoncé. |
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
MessageBox("Note", "A zero crossing could be found.")
Affiche une boîte à messages avec un bouton OK, mais sans icône.
MessageBox("Note", "Curve fitting was successful.", TYPE_OK, ICON_INFORMATION, 3.5, True)
Affiche une boîte à messages avec un bouton OK et une icône d'information. La boîte apparaîtra pendant 3,5 secondes au maximum. Le temps d'affichage restant apparaîtra dans le titre.
MessageBox("Warning", "No zero crossing could be found!", TYPE_OK, ICON_STOP)
Affiche une boîte à messages avec un bouton OK et une icône d'arrêt.
If MessageBox("Warning", "A zero crossing could be found.\nAbort computation anyway?", _
TYPE_YESNO2, ICON_QUESTION) == BUTTON_YES
Then Throw "Computation has been aborted by the user"
End
Affiche une boîte à messages avec les boutons Oui et Non et une icône représentant un point d'exclamation. Le bouton Non est présélectionné. Lorsque l'utilisateur clique sur le bouton Oui, une exception est déclenchée.