Affiche une boîte à messages.
Syntaxe
MessageBox(Title, le Text, le [ Type Variable TYPE_OK ], le [ Icon Variable ICON_NONE ], le [ Timeout Variable 0 ] [ , le ShowTimeout Variable 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 les types de messages des groupes TYPE_YESNO et TYPE_ABORTRETRYIGNORE la durée d'affichage ne peut pas être limitée. 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 utilisez l'argument Timeout a été indiqué, la valeur de retour indique BUTTON_TIMEOUT indique 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", "The curve fit 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("Warnung", "Es wurde ein Nulldurchgang gefunden.\nSoll die Berechnung trotzdem abgebrochen werden?", _
TYPE_YESNO2, ICON_QUESTION) == BUTTON_YES Then
Throw "Berechnung wurde vom Anwender abgebrochen"
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.