@GWTConfig public interface TheatreInitializer
gwt.js
) receives a call to either A
initFrom
and then initFromComplete
, or B
initTo
and then initToComplete
, but never both A and B.Modifier and Type | Method and Description |
---|---|
void |
initFrom(Stage s,
boolean rPending)
Here the prop or other component initializes its own properties by reference to a
previously initialized stage.
|
void |
initFromComplete(Stage s,
boolean rPending)
Signals that
initFrom was called for all props and that immediate
initialization of the stage is complete and the associated events have fired. |
void |
initTo(Stage s)
Here the prop or other component initializes the properties of the stage.
|
void |
initTo(Stage s,
TheatrePage r)
Here the prop or other component initializes the properties of the stage.
|
void |
initToComplete(Stage s,
boolean rPending)
Signals that
initTo was called for all props and that immediate
initialization of the stage is complete and the associated events have fired. |
void |
initUltimately(Stage s,
TheatrePage r)
Signals that deferred resolution of the referrer is now complete.
|
void initFrom(Stage s, boolean rPending)
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initFrom
. It may be defined in the
gwt.js configuration script, for
example.
rPending
- whether the referrer (if any) remains to be resolved. If this
flag is true, then initialization will eventually complete at initUltimately; otherwise it will
complete earlier at initFromComplete.void initFromComplete(Stage s, boolean rPending)
initFrom
was called for all props and that immediate
initialization of the stage is complete and the associated events have fired.
Referrer resolution may yet follow depending on the value of
rPending
. This method is called only when the state is initialized
by restoration, i.e. in those cases where initFrom
is called.
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initFromComplete
. It may be defined in
the gwt.js configuration script, for
example.
rPending
- true if initialization will eventually complete at initUltimately; false if this is the end
of it.void initTo(Stage s)
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initTo
. It may be defined in the
gwt.js configuration script, for
example.
void initTo(Stage s, TheatrePage r)
r
parameter. The prop will also provide a means of selecting other
differences and of re-selecting the original one, such that the user need never
navigate back and re-transit the link for this purpose.
A prop ought generally to avoid transferring a given property from a referrer when it already has a non-default value on the destination, whether set by the scene or by another prop. By the same token, an initializer that sets a default value for a property, such as actor name, will typically null the ordinary value to ensure that the default is immediately exhibited. It is recommended however that defaults be set earlier, e.g. during module initialization.
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initTo
. It may be defined in the
gwt.js configuration script, for
example.
r
- the theatre page that linked to this page (referrer), or null if
there was none.void initToComplete(Stage s, boolean rPending)
initTo
was called for all props and that immediate
initialization of the stage is complete and the associated events have fired.
Referrer resolution may yet follow depending on the value of
rPending
. This method is called only when the state is initialized
from scratch, i.e. in those cases where initTo
is called.
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initToComplete
. It may be defined in
the gwt.js configuration script, for
example.
rPending
- true if initialization will eventually complete at initUltimately; false if this is the end
of it.void initUltimately(Stage s, TheatrePage r)
rPending
was asserted in one of the
previous initialization calls. Resolution is never deferred longer than 5000 milliseconds.
The equivalent JavaScript callback is the global function
voGWTConfig.s_gwt_stage_Stage_initUltimately
. It may be defined in
the gwt.js configuration script, for
example.
r
- the theatre page that linked to this page (referrer), or null if
there was none. The prop may transfer state from the referrer as noted for
initTo
(stage,referrer), but with the
further stipulation that any state changes by the user subsequent to the
completion of immediate initialization ought to be honoured and not
overidden.