method MsgBox.Out (Prompt as String, [Buttons as Variant], [Title as Variant], [Image as Variant], [X as Variant], [Y as Variant])
Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

 TypeDescription 
   Prompt as String A String expression displayed as the message in the dialog box. The Prompt parameter may includes HTML format like explained bellow.  
   Buttons as Variant A long expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. If you omit Buttons, the default value is exOKOnly. The Buttons parameter is a combination of values in the OutStyle enumeration.   
   Title as Variant A String expression displayed in the title bar of the dialog box. The Title parameter may includes HTML format like explained bellow. The FitTitle property specifies whether the MessageBox or InputBox ensures that its title/caption fits the dialog's title  
   Image as Variant A string expression that indicates the path to a picture file being displayed, or a string expression that stores a picture in encoded base64 format. Use the eximages tool to save your picture as base64 encoded format.    
   X as Variant The X parameter could be a numeric or a string expression like follows:
  • If missing/omit, the dialog box is horizontally centered relative to active screen/monitor. 
  • If -1, the dialog is shown at the current cursor position ( x-coordinate ).
  • A Numeric expression that specifies, in pixels, the distance of the left edge of the dialog box from the left edge of the screen. 
  • A String expression that indicates the handle of the window to center relative to. You need to pass the handle of the window ( hWnd for /COM or Handle or hWnd for /NET ) as a string.

The FitToScreen property specifies whether the MessageBox ensures that it fits the screen ( current monitor ).

 
   Y as Variant The Y parameter could be a numeric or a string expression like follows:
  • If missing/omit, the dialog box is vertically centered relative to active screen/monitor. 
  • If -1, the dialog is shown at the current cursor position ( y-coordinate ).
  • A Numeric expression that specifies, in pixels, the distance of the upper edge of the dialog box from the top of the screen. 
  • A String expression that indicates the handle of the window to center relative to. You need to pass the handle of the window ( hWnd for /COM or Handle or hWnd for /NET ) as a string.

The FitToScreen property specifies whether the InputBox ensures that it fits the screen ( current monitor ).

 
 ReturnDescription 
  OutResultAn OutResult expression that indicates the identifier of button being clicked.  
Use the Out method to display a message box. Use the Load method to apply a new skin to your message box.  Use the Image parameter to assign a custom image to your message box. Use the Button and Image properties to change the caption/image of predefined buttons/icons. Use the Input method to let your users input text using a dialog box. Use the AutoClose property to specify the number of seconds to let the message box being visible.

The following samples aligns the message box as follow ( using /COM version ):

The following samples aligns the message box as follow ( using /NET version ):

The Prompt and Title arguments accepts the following HTML tags:

Also, newer HTML format supports decorative text like follows:

The following sample displays a critical-error message in a dialog box with Yes and No buttons:

If MsgBox1.Out("<b>Do you want to continue?</b>", OutStyle.exCritical Or OutStyle.exYesNo, "Error") = OutResult.exYes Then
    ' Performs some action
Else
    ' Performs some other action
End If


Send comments on this topic.
1999-2015 Exontrol.COM, Software. All rights reserved.