Core Function MsgBox

Revision as of 06:46, 27 November 2011

MsgBox( <message>, <title>, <flag>, <timeout> )

Description

Returns a string representation of an integer type converted to hexadecimal.

Parameters

message

The text of the message box.

title

The title of the message box.

The default title is "MessageBox".

flag

Optional; The flag indicates the type of message box and the possible button combinations. See remarks.

Default 64 (Information).

timeout

Optional; Timeout in seconds. After the timeout has elapsed the message box will be automatically closed.

Return Value

Success: Returns the ID of the button pressed.

Failure: Returns -1 if the message box timed out.

Button Pressed 		Return Value  
OK 			1 
CANCEL 			2 
ABORT 			3 
RETRY 			4 
IGNORE 			5 
YES 			6 
NO 			7 
TRY AGAIN 		10 
CONTINUE 		11 

Remarks

The flag parameter can be a combination of the following values:

decimal flag 	Button-related Result			Hexadecimal flag 
0		OK button 				0x0 
1 		OK and Cancel 				0x1 
2 		Abort, Retry, and Ignore 		0x2 
3 		Yes, No, and Cancel 			0x3 
4 		Yes and No 				0x4 
5 		Retry and Cancel 			0x5 
6 		Cancel, Try Again, Continue 		0x6 

decimal flag 	Icon-related Result 			Hexadecimal flag 
0 		(No icon) 				0x0 
16 		Stop-sign icon 				0x10 
32		Question-mark icon 			0x20 
48 		Exclamation-point icon 			0x30 
64		Icon consisting of an 'i' in a circle	0x40 

decimal flag 	Default-related Result 			Hexadecimal flag 
0 		First button is default button 		0x0 
256 		Second button is default button 		0x100 
512 		Third button is default button 		0x200 

decimal flag 	Modality-related Result 			Hexadecimal flag 
0		Application  				0x0 
4096 		System modal (dialog has an icon) 	0x1000 
8192 		Task modal 				0x2000 

decimal flag 	Miscellaneous-related Result 		Hexadecimal flag 
0 		(nothing else special) 			0x0 
262144 		MsgBox has top-most attribute set 	0x40000 
524288 		title and text are right-justified	0x80000 

Example

MsgBox("My Message");
MsgBox("My Message", "My Title");
MsgBox("My Message", "My Title", 32);
MsgBox("My Message", "My Title", 32, 3);
 
// Example making a messagebox with question message and a yes no then get the result
$Result = MsgBox("My Message", "My Title", 32 | 4); // Binary operator
If ( $Result == 6 ) // Yes
{
	MsgBox("You pressed yes");
}
Else If ( $Result == 7 ) // No
{
	MsgBox("You pressed no");
}
else
{
	MsgBox("Im not sure what you pressed....");
}