Navigation:  thinBasic Modules > UI (User Interface) > DIALOGSs >

DIALOG SHOW MODAL

Previous pageReturn to chapter overviewNext page

 

Description

 

Display and activate a dialog previously created with DIALOG NEW ..., allowing it to receive user input and messages.

The DIALOG SHOW MODAL statement blocks (halts) until the dialog is destroyed with DIALOG END.

 

Syntax

 

DIALOG SHOW MODAL hwnd [[,] CALL cbFunction]

 

Returns

 

None

 

Parameters

 

Name

Type

Optional

Meaning

hwnd

Number

No

Handle of the dialog created with DIALOG NEW ... statement

cbFunction

Function

Yes

Name of the function that to which dialog messages will be routed to.

The nominated callback function name must be a CALLBACK FUNCTION or a run-time  error will occur.

The name of the callback function can be also specified as a string expression allowing great flexibility.

 

Remarks

 

The DIALOG SHOW MODAL statement blocks (halts) until the dialog is destroyed with DIALOG END.

During the duration of the dialog, the Callback Function code is executed in response to messages for the dialog.

 

If a parent was specified in the DIALOG NEW statement, the parent window is disabled until the modal dialog is destroyed.

 

Restrictions

 

See also

 

Examples

 

'----------------------------------------------------