Main Page | Modules | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

Message box operations
[Window creating/destroying]

Functions

Function Documentation

void GUIAPI MessageBeep (  DWORD  dwBeep  ) 
 

Makes a sound of beep.

This function makes a sound of beep. We ignore dwBeep argument so far.

Parameters:
dwBeep The beep type, ignored so far.
See also:
Beep, Ping, Tone

int GUIAPI MessageBox (  HWND  hParentWnd,
const char *  pszText,
const char *  pszCaption,
DWORD  dwStyle
) 
 

Displays a message box within one, two, or three push buttons.

This function displays a message box within one, two, or three buttons, and returns the identifier of the button clicked by the user. You can pass dwStyle argument with different values to control the number of buttons, the button titles, and so on.

Parameters:
hParentWnd The handle to the hosting main window.
pszText The message text will be displayed in the message box.
pszCaption The caption of the message box.
dwStyle The style of the message box, can be one or'ed value of the following styles:
  • MB_OK
    Create a message box within only one button whose title is "OK".
  • MB_OKCANCEL
    Create a message box within two buttons whose title are "OK" and "Cancel" respectively.
  • MB_YESNO
    Create a message box within two buttons whose title are "Yes" and "No" respectively.
  • MB_RETRYCANCEL
    Create a message box within two buttons whose title are "Retry" and "Cancel" respectively.
  • MB_ABORTRETRYIGNORE
    Create a message box within three buttons whose title are "Abort", "Retry" and "Ignore" respectively.
  • MB_YESNOCANCEL
    Create a message box within three buttons whose title are "Yes", "No" and "Cancel" respectively.
  • MB_CANCELASBACK
    Title "Cancel" replaced with title "Previous".
  • MB_ICONHAND
    Display a hand/stop icon in the message box.
  • MB_ICONQUESTION
    Display a question mark icon in the message box.
  • MB_ICONEXCLAMATION
    Display a exclamation mark icon in the message box.
  • MB_ICONASTERISK
    Display an information icon in the message box.
  • MB_ICONINFORMATION
    Display an information icon in the message box.
  • MB_ICONSTOP
    Display a hand/stop icon in the message box.
  • MB_DEFBUTTON1
    The first push button acts as the default button.
  • MB_DEFBUTTON2
    The second push button acts as the default button.
  • MB_DEFBUTTON3
    The third push button acts as the default button.
  • MB_ALIGNCENTER
    The message box is center aligned.
  • MB_ALIGNTOPLEFT
    The message box is upper-left aligned.
  • MB_ALIGNBTMLEFT
    The message box is lower-left aligned.
  • MB_ALIGNTOPRIGHT
    The message box is upper-right aligned.
  • MB_ALIGNBTMRIGHT
    The message box is lower-right aligned.
  • MB_BASEDONPARENT
    A flag indicates that the alignments above are based on the hosting window, not the desktop.
Returns:
The identifier of the button clicked by user, can be one of the following values:
  • IDOK
    The "OK" button clicked.
  • IDCANCEL
    The "Cancel" or "Previous" button clicked.
  • IDABORT
    The "Abort" button clicked.
  • IDRETRY
    The "Retry" button clicked.
  • IDIGNORE
    The "Ignore" button clicked.
  • IDYES
    The "Yes" button clicked.
  • IDNO
    The "No" button clicked.
Note:
This function will call GetSysText to translate the button titles to localized text.
See also:
GetSysText, DialogBoxIndirectParam

Generated on Mon Jun 26 14:21:40 2006 for MiniGUI V2.0.3 API Reference by  doxygen 1.4.2