|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectfacets.util.Tracer
facets.core.superficial.TargeterCore
facets.core.superficial.app.IndexingTargeter
facets.core.superficial.app.AreaTargeter
facets.core.superficial.app.SContentRootTargeter
public class SContentRootTargeter
Heads the targeter tree for a content area.
The SAreaTarget
root of each content area tree in a surface
must return from SAreaTarget.newTargeter()
an appropriate
SContentRootTargeter
to create and manage the targeter tree for all content
areas of that type.
Content areas for applications will generally, and those for dialogs
frequently, include one or more viewers exposing a ViewableFrame
.
In addition to creating and retargeting its own elements
on
those of its SAreaTarget
target, SContentRootTargeter
applies specialised children on target trees representing (where present)
These child targeter trees provide attachment points for simple facets forming panels, menus etc exposing their targets; viewer and area facets for the surface should already be attached to the area target tree.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class facets.core.superficial.TargeterCore |
---|
TargeterCore.TargetType |
Nested classes/interfaces inherited from interface facets.core.superficial.Notifying |
---|
Notifying.Impact |
Field Summary |
---|
Fields inherited from class facets.core.superficial.TargeterCore |
---|
targetType |
Constructor Summary | |
---|---|
SContentRootTargeter(TargeterCore.TargetType type)
|
Method Summary | |
---|---|
protected boolean |
blockNotification()
Enables notification to be restricted to this member of the tree. |
STargeter |
content()
STargeter for the content exposed by the target's 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 TypedNode[] |
newDebugChildren()
Create a TypedNode[] representation of this Notifying
for debug purposes. |
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. |
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 |
retarget(STarget target,
Notifying.Impact impact)
Overrides superclass method. |
void |
retargetFacets(Notifying.Impact impact)
Extends superclass behaviour by calling retargetFacets(Notifying.Impact) in
its specialised targeter members. |
STargeter |
selection()
STargeter for the current selection. |
void |
setMonitor(Notifiable monitor)
Attach the Notifying to a Notifiable parent
in the notification tree. |
STargeter |
view()
STargeter for the currently active view. |
STargeter |
viewer()
STargeter for the currently active viewer. |
STargeter |
views()
STargeter for the currently active views target. |
Methods inherited from class facets.core.superficial.app.AreaTargeter |
---|
area |
Methods inherited from class facets.core.superficial.app.IndexingTargeter |
---|
indexedTargeter, indexing, retargetedTargeter |
Methods inherited from class facets.core.superficial.TargeterCore |
---|
attachFacet, elements, newRetargeted, target, title, toString, treeItems |
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 SContentRootTargeter(TargeterCore.TargetType type)
Method Detail |
---|
public void retarget(STarget target, Notifying.Impact impact)
IndexingTargeter
Creates and applies a targeter tree on the target tree headed
by its IndexingTarget
target.
retarget
in interface SRetargetable
retarget
in interface STargeter
retarget
in class IndexingTargeter
Notifying
public void retargetFacets(Notifying.Impact impact)
retargetFacets(Notifying.Impact)
in
its specialised targeter members.
retargetFacets
in interface Facetable
retargetFacets
in interface STargeter
retargetFacets
in class AreaTargeter
public final STargeter content()
STargeter
for the content exposed by the target's tree.
The target of content
is the SFrameTarget
returned as SAreaTarget.activeContent()
by the target of this SContentRootTargeter
.
public final STargeter view()
STargeter
for the currently active view.
The target of view
is the SFrameTarget
returned as activeView
by the target of viewer
.
public final STargeter viewer()
STargeter
for the currently active viewer.
The target of viewer
is the ViewerTarget
returned as activeViewer
by the target of the
SContentRootTargeter
.
public final STargeter views()
STargeter
for the currently active views target.
The target of views
is the STarget
returned as views
by the target of viewer
.
public final STargeter selection()
STargeter
for the current selection.
The target of selection
is the SFrameTarget
returned as SelectingFrame.selectionFrame()
by
the target of content()
.
protected TypedNode[] newDebugChildren()
TypedNode[]
representation of this Notifying
for debug purposes.
newDebugChildren
in class IndexingTargeter
protected 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 |