UDF > WinAPIEx > Dialog >


_WinAPI_MessageBoxCheck

Affiche une boîte de message qui donne à l'utilisateur la possibilité de supprimer d'autres occurrences

#include <WinAPIDlg.au3>
_WinAPI_MessageBoxCheck ( $iType, $sTitle, $sText, $sRegVal [, $iDefault = -1 [, $hParent = 0]] )

Paramètres

$iType Les flags qui précisent le contenu et le comportement de la boîte de message.

Vous devez spécifier les boutons à afficher en définissant un seul des flags suivants:
$MB_OK
$MB_OKCANCEL
$MB_YESNO

Vous pouvez afficher facultativement une icône en définissant un seul des flags suivants:
$MB_ICONEXCLAMATION
$MB_ICONHAND
$MB_ICONINFORMATION
$MB_ICONQUESTION
$sTitle La chaîne qui contient le titre de la boîte de message.
$sText La chaîne qui contient le message qui sera affiché.
$sRegVal La chaîne qui contient une valeur chaîne unique à associer à ce message.
$iDefault [optionnel] La valeur retournée par la fonction lorsque l'utilisateur a choisi de "ne plus afficher ce message". Si l'utilisateur n'a pas choisi cette option, la boîte de message s'affiche et la fonction ignore $iDefault.
$hParent [optionnel] La handle de fenêtre propriétaire de la boîte de message.

Valeur de retour

Succès: Si l'utilisateur a déjà choisi de supprimer la boîte de message, la fonction retourne immédiatement la valeur assignée à $iDefault, sinon, elle retourne l'une des constantes $ID_*.
Échec: Retourne (-1).

Remarques

Cette fonction enregistre les boîtes de message que l'utilisateur a choisi de supprimer sous la clé de Registre suivante:

HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\LowRegistry\\DontShowMeThisDialogAgain

Voir aussi

Consultez SHMessageBoxCheck dans la librairie MSDN.

Exemple

#include <MsgBoxConstants.au3>
#include <WinAPIDlg.au3>

Local $iResult = _WinAPI_MessageBoxCheck($MB_ICONINFORMATION, 'MyProg', '_WinAPI_MessageBoxCheck()', 'MyProg')

ConsoleWrite('Retour: ' & $iResult & @CRLF)