com.softwareag.mobile.runtime.toolkit.ui

Class AbstractAlertDialog

java.lang.Object

com.softwareag.mobile.runtime.toolkit.ui.AbstractAlertDialog

All Implemented Interfaces:

com.softwareag.mobile.runtime.nui.nUIConstants, com.softwareag.mobile.runtime.nui.nUIEventListener

public abstract class AbstractAlertDialog
extends java.lang.Object
implements com.softwareag.mobile.runtime.nui.nUIEventListener

The AbstractAlertDialog acts as a super class for all generated alert dialogs. It provides the open() and close() methods as well as the default event listener implementation. An application can only have one dialog open at a time.
To open/close the dialog call:

 AbstractAlertDialog dialog = ...;
 dialog.open();
 

Or use the methods provided by the AbstractApplicationController:

 AbstractAlertDialog dialog = ...;
 AbstractApplicationController.getInstance().openDialog(dialog);
 

To create the AbstractAlertDialog, the user has to deliver an instance of the IDialogDelegate interface with the constructor. Each abstract view controller implements this interface per default. This also means that there a two ways of creating the dialog:

• Create the dialog from within a view controller.

   final AbstractAlertDialog dialog = new MyDialog(this);
   

• Outside a view controller, pass the instance of IDialogDelegate.

   final AbstractAlertDialog dialog = new MyDialog(new MyDialogDelegate());
   

By using the first approach, the dialog closes if the user presses a button. The default behavior can be changed by overriding the IDialogDelegate.onAlertDialogButtonPressed(AbstractAlertDialog, int) method from a specific view controller or delegate implementation. The passed AbstractAlertDialog represents the current instance. The integer value corresponds to the button id, the user entered in the outline editor. This id, stored in the Constants interface, can be used to determine different behaviors for different buttons, e.g.:

 public void onAlertDialogButtonPressed(final AbstractAlertDialog dialog,
                final int id) {
        switch (id) {
        case Constants.BUTTON_1:
                // ...
                break;
        case Constants.BUTTON_2:
                // ...
                break;
        }
 }
 

This class is also just a wrapper for the Mobile Designer nUIAlertDialog. Each sub class has to override the getDialog() method to create the underlying nUIAlertDialog.

Version:

9.7.0.0000-0116

Field Summary

Fields inherited from interface com.softwareag.mobile.runtime.nui.nUIConstants

bottom, center, centre, CREATE, CUSTOM_EVENT_CODE0, EVT_BACK_BUTTON, EVT_COMPLETED_EDIT, EVT_DOUBLE_TAP, EVT_GAIN_FOCUS, EVT_LONG_PRESS, EVT_LOSE_FOCUS, EVT_ON_ADDITION, EVT_POST_EDIT, EVT_PRE_EDIT, EVT_SWIPE_LEFT, EVT_SWIPE_RIGHT, EVT_TIMER_COMPLETE, EVT_TRANSITION_FROM_COMPLETE, EVT_TRIGGER, EVT_TRIGGER_HTTP_FAIL, EVT_TRIGGER_HTTP_SUCCESS, GESTURE_DOUBLE_TAP, GESTURE_LONG_PRESS, GESTURE_NONE, GESTURE_SWIPE, left, MAX_DY_FOR_SWIPE, MIN_DX_FOR_SWIPE, MIN_SCROLL_START_THRESHOLD, NO_YES, OFF_ON, POINTER_STATE_DRAGGED, POINTER_STATE_PRESSED, POINTER_STATE_PRESSED_AND_RELEASED, POINTER_STATE_RELEASED, REMOVE, right, size_absolute, size_huge, size_large, size_medium, size_relative, size_small, size_tiny, style_bold, style_default, style_italic, style_underlined, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, top

Constructor Summary

Constructors

Constructor and Description
AbstractAlertDialog(IDialogDelegate delegate) Creates a new AbstractAlertDialog by passing an IDialogDelegate.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes this dialog.
abstract com.softwareag.mobile.runtime.nui.nUIAlertDialog	getDialog() Returns the Mobile Designer nUIAlertDialog this class wraps.
boolean	nUIEventCallback(com.softwareag.mobile.runtime.nui.nUIObject object, int eventType) Creates this AbstractAlertDialog by passing the IDialogDelegate implementation.
void	open() Opens this dialog.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractAlertDialog

public AbstractAlertDialog(IDialogDelegate delegate)

Creates a new AbstractAlertDialog by passing an IDialogDelegate. The delegate must not be null.

Parameters:

delegate -

Method Detail

nUIEventCallback

public boolean nUIEventCallback(com.softwareag.mobile.runtime.nui.nUIObject object,
                       int eventType)

Creates this AbstractAlertDialog by passing the IDialogDelegate implementation.

Specified by:

nUIEventCallback in interface com.softwareag.mobile.runtime.nui.nUIEventListener

Parameters:

delegate - The specific event delegate implementation.

Returns:

Should the object continue with its default behaviour for this event

open

public void open()

Opens this dialog.

See Also:

AbstractApplicationController#openDialog()

close

public void close()

Closes this dialog.

See Also:

AbstractApplicationController.closeDialog()

getDialog

public abstract com.softwareag.mobile.runtime.nui.nUIAlertDialog getDialog()

Returns the Mobile Designer nUIAlertDialog this class wraps.

Returns: