|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object facets.util.Tracer facets.core.superficial.TargetCore facets.core.superficial.SFrameTarget facets.core.superficial.app.SelectingFrame facets.core.superficial.app.ViewableFrame
public abstract class ViewableFrame
SelectingFrame
that can respond to input from SViewer
s and
ViewableAction
s.
ViewableFrame
extends its superclass by
allowing for response both to mouse-defined SViewer
input
and to non-mouse ViewableAction
s.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface facets.core.superficial.STarget |
---|
STarget.Targeted |
Nested classes/interfaces inherited from interface facets.core.superficial.Notifying |
---|
Notifying.Impact |
Field Summary |
---|
Fields inherited from class facets.core.superficial.SFrameTarget |
---|
framed |
Fields inherited from class facets.core.superficial.TargetCore |
---|
targets |
Fields inherited from interface facets.core.superficial.STarget |
---|
NONE |
Constructor Summary | |
---|---|
ViewableFrame(java.lang.String title,
java.lang.Object content)
Unique constructor. |
Method Summary | |
---|---|
boolean |
actionIsLive(SViewer viewer,
ViewableAction action)
Should the action be exposed as live in the surface? |
protected void |
actionTriggered(SViewer viewer,
ViewableAction action)
Propose an action in the viewer passed. |
protected boolean |
blockNotification()
Enables notification to be restricted to this member of the tree. |
java.lang.Object |
identity()
Return an object that is as far as possible unique for the implementation. |
Notifying.Impact |
impact()
Allows this Notifying to specify a default Notifying.Impact . |
Notifiable |
monitor()
The current Notifiable in the notification tree,
as set with setMonitor . |
protected static TypedNode |
newDebugContentNode(java.lang.String title,
java.lang.Object source)
|
protected static TypedNode |
newDebugContentNode(java.lang.String title,
java.lang.Object[] source)
|
protected static TypedNode |
newDebugMonitorNode(Notifiable monitor)
|
TypedNode |
newGraphNode()
Returns a descriptive node for use in debug object graph. |
protected SSelection |
newViewerSelection(SViewer viewer)
Return SSelection to be displayed by viewer. |
void |
notify(Notice notice)
Respond to the Notice passed. |
void |
notifyMonitor(Notifying.Impact impact)
Call notify on the parent monitor in the notification tree,
typically with itself as parameter to the Notice passed. |
void |
setMonitor(Notifiable monitor)
Attach the Notifying to a Notifiable parent
in the notification tree. |
ViewableAction[] |
viewerActions(SView view)
Return actions to be made available in a viewer |
protected void |
viewerSelectionChanged(SViewer viewer,
SSelection selection)
Respond to change in selection. |
protected void |
viewerSelectionEdited(SViewer viewer,
java.lang.Object edit,
boolean interim)
Respond to viewer edit. |
Methods inherited from class facets.core.superficial.app.SelectingFrame |
---|
defineSelection, selection, selectionFrame, setSelection |
Methods inherited from class facets.core.superficial.SFrameTarget |
---|
newDebugChildren, notifiesTargeter, setFramedState, title |
Methods inherited from class facets.core.superficial.TargetCore |
---|
elements, findMonitorOfType, isLive, join, lazyElements, newTargeter, setElements, setLive, toString, wantsFocus |
Methods inherited from class facets.util.Tracer |
---|
trace, trace, trace, trace, trace, traceDebug, traceDebug, traceObjectText, traceOutput, traceOutputWithClass |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface facets.core.superficial.Notifying |
---|
impact, monitor, notifyMonitor, setMonitor |
Methods inherited from interface facets.core.superficial.Notifiable |
---|
notify |
Constructor Detail |
---|
public ViewableFrame(java.lang.String title, java.lang.Object content)
title
- passed to superclasscontent
- passed to superclassMethod Detail |
---|
protected SSelection newViewerSelection(SViewer viewer)
SSelection
to be displayed by viewer.
Called by ViewerTargetCore.selection()
, should return some combination of
SFrameTarget.framed
SFrameTarget.framed
suitable for use by viewer
viewer
- requiring selection for return by SViewer.selection()
SelectingFrame.selection()
protected void viewerSelectionChanged(SViewer viewer, SSelection selection)
Called from ViewerTargetCore.selectionChanged(SSelection)
, must
interpret a new viewer selection in terms of the complete content.
Default implementation calls SelectingFrame.setSelection(SSelection)
with
selection
.
viewer
- in which the change took placeselection
- the new selection in the viewerprotected void viewerSelectionEdited(SViewer viewer, java.lang.Object edit, boolean interim)
Called from ViewerTargetCore.selectionEdited(SSelection, Object, boolean)
, may
respond by changing content state to match edit
.
Default implementation calls SFrameTarget.setFramedState(Object, boolean)
with
edit
.
viewer
- proposing the editedit
- may be multiple edits to match implementor
of SSelection
.interim
- if true
the edit forms part of a sequenceprotected void actionTriggered(SViewer viewer, ViewableAction action)
Default implementation is an invalid stub.
viewer
- the active vieweraction
- specifies the action proposedpublic boolean actionIsLive(SViewer viewer, ViewableAction action)
Default returns false
.
viewer
- the active vieweraction
- to be exposedpublic ViewableAction[] viewerActions(SView view)
view
- controls the viewerprotected static final TypedNode newDebugContentNode(java.lang.String title, java.lang.Object source)
protected static final TypedNode newDebugContentNode(java.lang.String title, java.lang.Object[] source)
protected static final TypedNode newDebugMonitorNode(Notifiable monitor)
public final TypedNode newGraphNode()
public Notifying.Impact impact()
Notifying
Notifying
to specify a default Notifying.Impact
.
impact
in interface Notifying
Notifying.Impact.DEFAULT
public java.lang.Object identity()
Identified
This will usually be a class instance counter.
identity
in interface Identified
public final Notifiable monitor()
Notifiable
in the notification tree,
as set with setMonitor
.
Complains if no parent has been set.
monitor
in interface Notifying
public void notify(Notice notice)
Notifiable
Notice
passed.
When this method is called, the Notifiable
should
respond based on
Notice
passed.
notify
in interface Notifiable
public final void notifyMonitor(Notifying.Impact impact)
Notifying
notify
on the parent monitor in the notification tree,
typically with itself as parameter to the Notice
passed.
Has no effect if no monitor has been set.
This is the usual means to trigger a surface retargeting, being called
by an exposing SFacet
on its target.
notifyMonitor
in interface Notifying
impact
- suggests the level of retargeting requiredprotected boolean blockNotification()
Checked by notify(Notice)
; default returns false
.
public final void setMonitor(Notifiable monitor)
Notifying
Notifying
to a Notifiable
parent
in the notification tree.
setMonitor
in interface Notifying
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |