Description

This function is used to create a modal dialog box. It processes an event loop, as long as the dialog box exists, then returns any result to the calling procedure.

Syntax

return value = Dialog_Box(dialogID, parentID, initparam)

Parameters

The Dialog_Box function has the following parameters.

ParameterDescription
DialogIDThe name of the form to open as a dialog box.
ParentIDIf valid, the new dialog box is owned by the specified parent. If parentID is null or invalid, Dialog_Box() returns without opening the form.
InitparamThis parameter is passed into the CREATE event of the form.

Remarks

A window created using the Dialog_Box function should be closed using the End_Dialog function.

See also

Create_Dialog()End_DialogGet_Dialog_Info()Set_Dialog_Info()PlaceDialog()Start_Window()End_Window()Start_MDIChild()

Example

Parent = @window
returnValues = Dialog_Box("APP_LOGIN", Parent, @username)