CreateDialog

Hello World

Content:
- Methods

Custom dialogs appear on top of the app and thus can be used to show temporary information or collect data from the user. They are also useful for displaying configuration or settings controls.

dlg = app.CreateDialog( title, options ) → app object: Dialog

Dialogs are resizeable and you can also change the look of them so that they fit in with the theme of your application.

A custom dialog needs a layout to add the controls to. Use the CreateLayout method of the app object to add a layout.

layDlg = app.CreateLayout( type, options );
dlg.AddLayout( layDlg );

If you have added all your controls to the dialog layout you can use the Show method to show the dialog.

Normally the user can cancel the dialog by pressing the BACK button of the device, but you can disable that option by using the “NoCancel” option. In order to close the dialog now, you have to call Dismiss.

Example - Demo click to expand contents

function OnStart()
{
    dlg = app.CreateDialog( "Custom Dialog" );

    layDlg = app.CreateLayout( "linear", "VCenter,FillXY" );
    layDlg.SetSize( 0.7, 0.3 );
    dlg.AddLayout( layDlg );

    chk = app.CreateCheckBox( "Check Box" );
    chk.SetMargins( 0, 0.02, 0, 0.02 );
    layDlg.AddChild( chk );

    btnDlg = app.CreateButton( "Close Dialog", 0.6, 0.1 );
    btnDlg.SetOnTouch( btnDlg_OnTouch );
    layDlg.AddChild( btnDlg );

    dlg.Show();
}

function btnDlg_OnTouch()
{
    dlg.Dismiss();
}

Copy All