facets.core.superficial
Interface FacetedTarget

All Superinterfaces:
Facetable, Notifiable, Notifying, STarget, Titled
All Known Implementing Classes:
ActionViewerTarget, AppSurface.ContentRoot, DialogSurface.ContentRoot, SAreaTarget, ViewerTarget

public interface FacetedTarget
extends STarget, Facetable

STarget representing a viewer or containing area with an attached SFacet.

In addition to its two superinterfaces, FacetedTarget defines other shared methods for the members of a area target tree.


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 interface facets.core.superficial.STarget
NONE
 
Method Summary
 SAreaTarget areaParent()
          The parent in the area target tree.
 SFacet attachedFacet()
          The SFacet attached with attachFacet(SFacet).
 void attachFacet(SFacet facet)
          Attach an immutable facet.
 void ensureActive(boolean notify)
          Ensure that the targeter tree treats the faceted as having the GUI focus.
 boolean isActive()
          Should the targeter tree treat the facet as having the GUI focus?
 
Methods inherited from interface facets.core.superficial.STarget
elements, isLive, setLive, wantsFocus
 
Methods inherited from interface facets.util.Titled
title
 
Methods inherited from interface facets.core.superficial.Notifying
impact, monitor, notifyMonitor, setMonitor
 
Methods inherited from interface facets.core.superficial.Notifiable
notify
 
Methods inherited from interface facets.core.superficial.Facetable
retargetFacets
 

Method Detail

attachFacet

void attachFacet(SFacet facet)
Attach an immutable facet.

As a STarget representing its attachedFacet(), FacetedTarget can only attach a single viewer or area facet; it should complain if any attempt is made to attach another.

Specified by:
attachFacet in interface Facetable
Parameters:
facet - will be applied during each retargeting sequence

attachedFacet

SFacet attachedFacet()
The SFacet attached with attachFacet(SFacet).

Return the facet attached to this FacetedTarget, complaining if none yet attached.


areaParent

SAreaTarget areaParent()
The parent in the area target tree.


isActive

boolean isActive()
Should the targeter tree treat the facet as having the GUI focus?


ensureActive

void ensureActive(boolean notify)
Ensure that the targeter tree treats the faceted as having the GUI focus.

Parameters:
notify - if true, also trigger a retargeting
See Also:
Notifying