votorola.s.gwt.scene

Class Scenes

java.lang.Object

Scenes

public final class Scenes
extends Object

Scenes for Crossforum Theatre. The navigable state of the UI is specified by switches (fragment parameters) in the history stack. Navigation includes structural modifications to the UI such as major component changes, or true navigation such as zoom and pan. It does not include decorative changes such as those caused by track selections in the surrounding stage. The switches currently reserved are:

Switch	Controlled state
a	Superaccount selection (deprecated).
c	Composition of the theatre UI.
s	Scoping of the scene and other scope dependent views such as the feed.

Constructor Summary

Constructors

Constructor and Description
Scenes() Creates the single instance of Scenes.

Method Summary

Methods

Modifier and Type	Method and Description
SingleSelectionModel<BiteJS>	biteSelection() The selection model for individual bites.
(package private) Switch	cCompositionSwitch() The 'c' composition switch.
(package private) void	clearMap() Clears the scene that is currently shown by setting it to Scene0.
static void	forceInitClass() Does nothing itself but the call forces static initialization of this class.
HistoryX	history() The URL history stacker.
static Scenes	i() The single instance of Scenes.
Scene	scene() The scene that is currently shown.
(package private) void	setScene(Scene newScene) Sets the scene that is currently shown.
static void	setUseRAC(boolean _to) Sets whether to show views and controls for resource accounting that are unfinished or deprecated.
Switch	sScopingSwitch() The 's' scoping switch.
static boolean	toUseRAC() Whether to show views and controls for resource accounting that are unfinished or deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

Scenes

Scenes()

Creates the single instance of Scenes.

Throws:

IllegalStateException - if an instance of Scenes was already constructed.

Method Detail

forceInitClass

public static void forceInitClass()

Does nothing itself but the call forces static initialization of this class.

i

public static Scenes i()

The single instance of Scenes.

biteSelection

public SingleSelectionModel<BiteJS> biteSelection()

The selection model for individual bites. Note that deselection is not supported (GWT 2.1). Instead try setSelected(BiteJS.EMPTY_BITE,true).

See Also:

Deselection

history

public HistoryX history()

The URL history stacker. To keep the URLs short, only gross structural changes ought to be encoded in bookmarkable form and stacked in history, not the merely "decorative" changes such as item selection.

Decorative state cannot be revisted through the history controls but neither can it be destroyed. A user's attempt to navigate a series of decorative changes by going backward in history will fail, resulting instead in a structural change. Going forward again will restore both the structure and the decorations, however, because decorative state is persistent as a rule.

cCompositionSwitch

Switch cCompositionSwitch()

The 'c' composition switch. It directly controls the composition of the theatre UI. It consists of two short mnemonics: the first for the feed and the second for the scene. For example, c=DG specifies a diff feed and a geomap.

If no value is specified, or if it is cleared at runtime, then the window location is replaced by a new URL with a switch specifing a default composition.

scene

public Scene scene()

The scene that is currently shown. The value is bound via the event bus to property name scene. It is never null, but it may briefly be set to Scene0 during component transitions.

clearMap

void clearMap()

Clears the scene that is currently shown by setting it to Scene0.

setScene

void setScene(Scene newScene)

Sets the scene that is currently shown.

sScopingSwitch

public Switch sScopingSwitch()

The 's' scoping switch. The format of the switch value depends on the particular scene shown. The value ultimately controls the scoping of the scene and other scope dependent views such as the feed. Scoping works through the intermediation of scoping models. Clients may register with those models either directly or indirectly to receive their events.

toUseRAC

@GWTConfigCallback
public static boolean toUseRAC()

Whether to show views and controls for resource accounting that are unfinished or deprecated.

See Also:

setUseRAC(boolean)

setUseRAC

@Warning(value="broken")
@GWTConfigCallback
public static void setUseRAC(boolean _to)

Sets whether to show views and controls for resource accounting that are unfinished or deprecated. This configuration method is for developers. Call it from the global configuration function voGWTConfig.s_gwt_scene like this for example:

   s_gwt_scene_Scenes_setUseRAC( true ); // default is false

You may also want to set the flag CountWAP.toSimulate, and recompile.

This is now broken. See the comments in the constructor of SacSelectionV.SacVCell.

See Also:

toUseRAC()