ch.aplu.android

Class GGInputDialog

java.lang.Object

ch.aplu.android.GGInputDialog

public class GGInputDialog
extends java.lang.Object

Class to show a modal dialog with an edit field and two buttons (Ok, Cancel). Because by Android system design modal dialogs are not supported, this workaround is only permitted when invoked by the main thread (in the main() method).

If a GGConsole is opened, provide the console activity by Console.getActivity() and use call show() with the activity parameter.

When the dialog is shown, the current screen orientation is saved, but the device may be flipped to enter the text in the user preferred orientation. When Ok or Cancel is clicked, the saved screen orientation is restored and fixed in order to avoid the restart of the main thread.

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	show(android.app.Activity activity, java.lang.String title, java.lang.String prompt, java.lang.String init) Same as show(String title, String prompt, String init) with given activity.
static java.lang.String	show(java.lang.String title, java.lang.String prompt) Same as show(String title, String prompt, String init) with init = "".
static java.lang.String	show(java.lang.String title, java.lang.String prompt, java.lang.String init) Halts the main thread and shows the modal dialog box and a Ok and Cancel button.

Methods inherited from class java.lang.Object

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

Method Detail

show

public static java.lang.String show(android.app.Activity activity,
                    java.lang.String title,
                    java.lang.String prompt,
                    java.lang.String init)

Same as show(String title, String prompt, String init) with given activity.

Parameters:

activity - the activity where to show the dialog

title - the title text of the dialog box

prompt - the prompt text of the dialog box

init - the text shown in the edit field when the box pops-up

Returns:

the trimmed text in the edit field; null if the Cancel button is pressed

show

public static java.lang.String show(java.lang.String title,
                    java.lang.String prompt,
                    java.lang.String init)

Halts the main thread and shows the modal dialog box and a Ok and Cancel button. When the Ok button is pressed, the current text in the edit field is returned (empty string, if the field is empty) and the main thread continues to run. The screen orientation is fixed to what is was before, even when the screen is rotated while the dialog is shown.

Parameters:

title - the title text of the dialog box

prompt - the prompt text of the dialog box

init - the text shown in the edit field when the box pops-up

Returns:

the text in the edit field; null if the Cancel button is pressed

show

public static java.lang.String show(java.lang.String title,
                    java.lang.String prompt)

Same as show(String title, String prompt, String init) with init = "".