ch.aplu.android

Class GGConsole

java.lang.Object

ch.aplu.android.GGConsole

public class GGConsole
extends java.lang.Object

GGConsole is used to display a simple black screen to display lines of text like in a common system command shell. Lines too long to fit the screen are wrapped and the text will scroll up when the screen is full. Using the vertical scroll bars at the right border the text can be scrolled up and down. The screen orientation is fixed to PORTRAIT. All GameGrid toast messages are automatically displayed in in the GGConsole window.

To use a GGInputDialog, provide the console activity by Console.getActivity() and call GGInputDialog.show() with the activity parameter.

Constructor Summary

Constructors

Constructor and Description
GGConsole() Creates an Activity with a special console layout and the default typeface.
GGConsole(android.graphics.Typeface typeface) Creates an Activity with a special console layout and the given typeface.

Method Summary

Methods

Modifier and Type	Method and Description
static void	clear() Clears the content of the console.
static android.app.Activity	getActivity() Returns the ConsoleActivity after the console is initialized.
static GGConsole	init() Creates a GGConsole with default typeface and returns a reference to it.
static GGConsole	init(android.graphics.Typeface typeface) Creates a GGConsole with given typeface and returns a reference to it.
static void	println(java.lang.String text) Writes one line of text.
static java.lang.String	requestInput(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

Constructor Detail

GGConsole

public GGConsole()

Creates an Activity with a special console layout and the default typeface.

GGConsole

public GGConsole(android.graphics.Typeface typeface)

Creates an Activity with a special console layout and the given typeface.

Parameters:

typeface - to typeface to be used for the text view

Method Detail

init

public static GGConsole init()

Creates a GGConsole with default typeface and returns a reference to it.

Returns:

the reference to the GGConsole

init

public static GGConsole init(android.graphics.Typeface typeface)

Creates a GGConsole with given typeface and returns a reference to it.

Parameters:

typeface - to typeface to be used for the text view

Returns:

the reference to the GGConsole

getActivity

public static android.app.Activity getActivity()

Returns the ConsoleActivity after the console is initialized.

Returns:

the ConsoleActivity; null, if the console is not initialized

println

public static void println(java.lang.String text)

Writes one line of text. The next call will display the text on the next line.

Parameters:

text - the text to show.

clear

public static void clear()

Clears the content of the console.

requestInput

public static java.lang.String requestInput(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