Navigation:  ThinBASIC Modules > Core (thinBasic Core Engine) > General functions >

MsgBox

Previous pageReturn to chapter overviewNext page

 

Description

 

Creates, displays, and operates a message box. The message box contains a message and title, along with any combination of predefined icons and push buttons. An optional Timeout period can be specified: after the specified period, if no reply from user, a specific timeout message will be returned allowing script to make default/automatic decisions.

 

Syntax

 

Result = MSGBOX([hParent,] Message [, Style [, Title [, Timeout [, UpdateCountDown, [, CountDownFormat ] ]] ] ] )

 

Returns

 

Number

 

Parameters

 

Name

Type

Optional

Meaning

hParent

Number

Yes

Handle to the owner window of the message box to be created. If this parameter is zero, the message box has no owner window.

Message

String

No

A string expression that contains the message to be displayed.

Style

Number

Yes

Specifies the contents and behavior of the dialog box. This parameter can be a combination of flags from the groups of flags specified into module equates.

Title

String

Yes

A string expression that contains the dialog box title.

If this parameter is an empty string, the default title "thinBasic" will be used.

Timeout

Number

Yes

Number of milliseconds after which the message box will automatically exit with a

%IDTIMEOUT return code.

UpdateCountDown

Number

Yes

Number of milliseconds time window for window caption count down update. If not present, no count down will be shown

CountDownFormat

String

Yes

Format of the count down. If not present a standard one will be used.

 

 

Remarks

 

Restrictions

 

See also

 

Examples

 

DIM RetCode AS LONG

 

RetCode = MSGBOX(0, "Do you want to procede with deletion?", _

                %MB_YESNOCANCEL OR %MB_ICONERROR, _

                "Please reply ...")

 

Select Case RetCode

Case %IDYES

  '...

Case %IDNO

  '...

Case %IDCANCEL

  '...

Case Else

  '...

End Select