# -*- coding: iso-8859-1 -*-

#. // _by_msgbox.py

from win32ui import MessageBox

#. // Icônes.
MB_ICONERROR       = 16 # // Une icône de signe d'arrêt rouge apparaît dans la boîte de message.
MB_ICONEXCLAMATION = 48 # // Une icône de point d'exclamation jaune apparaît dans la boîte de message.
MB_ICONINFORMATION = 64 # // Une icône composée d'une lettre minuscule i dans un cercle bleu apparaît dans la boîte de message.
MB_ICONQUESTION    = 32 # // Une icône bleue de point d'interrogation apparaît dans la boîte de message.

#. // Choix des boutons ( OK est la valeur par défaut = 0 ).
MB_ABORTRETRYIGNORE = 2 # // La boîte de message contient trois boutons-poussoirs : Abandonner, Recommencer et Ignorer. 
MB_OKCANCEL         = 1 # // La boîte de message contient deux boutons poussoirs : OK et Annuler.
MB_RETRYCANCEL      = 5 # // La boîte de message contient deux boutons poussoirs : Recommencer et Annuler.
MB_YESNO            = 4 # // La boîte de message contient deux boutons-poussoirs : Oui et Non.
MB_YESNOCANCEL      = 3 # // La boîte de message contient trois boutons-poussoirs : Oui, Non et Annuler.

#. // Retour de la fonction.
MB_ABORT  = 3 # // Abandonner. 
MB_CANCEL = 2 # // Annuler.
MB_IGNORE = 5 # // Ignorer. 
MB_NO     = 7 # // Non.
MB_OK     = 1 # // OK.
MB_RETRY  = 4 # // Recommencer.
MB_YES    = 6 # // Oui.

#. // Boîte de dialogue avec options et valeur de retour.
def by_msgbox( cMessage, cTitre = "Message", nOptions = MB_ICONINFORMATION ):
   nChoice = MessageBox( cMessage, cTitre, nOptions )
   return nChoice

'''
Dernière modification : 2022-02-02

Harbour   : wapi_MessageBox()
dBasePlus : msgbox()
VBScript  : MsgBox()

[Exemple]

import sys
sys.path.append( "modules" )

from _by_msgbox import by_msgbox # // Boîte de dialogue avec options et valeur de retour.

#. // Icônes.
from _by_msgbox import MB_ICONERROR        # // Une icône de signe d'arrêt rouge apparaît dans la boîte de message.
from _by_msgbox import MB_ICONEXCLAMATION  # // Une icône de point d'exclamation jaune apparaît dans la boîte de message.
from _by_msgbox import MB_ICONINFORMATION  # // Une icône composée d'une lettre minuscule i dans un cercle bleu apparaît dans la boîte de message.
from _by_msgbox import MB_ICONQUESTION     # // Une icône bleue de point d'interrogation apparaît dans la boîte de message.

#. // Choix des boutons ( OK est la valeur par défaut = 0 ).
from _by_msgbox import MB_ABORTRETRYIGNORE  # // La boîte de message contient trois boutons-poussoirs : Abandonner, Recommencer et Ignorer. 
from _by_msgbox import MB_OKCANCEL          # // La boîte de message contient deux boutons poussoirs : OK et Annuler.
from _by_msgbox import MB_RETRYCANCEL       # // La boîte de message contient deux boutons poussoirs : Recommencer et Annuler.
from _by_msgbox import MB_YESNO             # // La boîte de message contient deux boutons-poussoirs : Oui et Non.
from _by_msgbox import MB_YESNOCANCEL       # // La boîte de message contient trois boutons-poussoirs : Oui, Non et Annuler.

#. // Retour de la fonction.
from _by_msgbox import MB_ABORT   # // Abandonner. 
from _by_msgbox import MB_CANCEL  # // Annuler.
from _by_msgbox import MB_IGNORE  # // Ignorer. 
from _by_msgbox import MB_NO      # // Non.
from _by_msgbox import MB_OK      # // OK.
from _by_msgbox import MB_RETRY   # // Recommencer.
from _by_msgbox import MB_YES     # // Oui.

nChoice = -1  # // Pour test.

#by_msgbox( "Bonjour" )

nChoice = by_msgbox( "Continuer", "Titre", MB_YESNO + MB_ICONQUESTION )

print()
if nChoice == MB_NO:
   print( "Retour = Non" )
else:
   print( "Retour = Oui" )
print()

[/Exemple]
'''