facets.core.superficial.app
Interface SSurface

All Superinterfaces:

Notifiable, Titled

All Known Implementing Classes:

ActionAppSurface, AppSurface, DialogSurface, FacetAppSurface, FacetDialogSurface, FacetDialogSurface.MultiPaged

public interface SSurface
extends Notifiable, Titled

Surface managing an AreaTargeter tree.

A SSurface should build a surface by

1. creating a targeter tree containing at least one SContentRootTargeter
2. attaching facet to the targeter tree
3. passing the facet to a SHost GUI context that can create the widget surface layer.
4. retargeting the targeter tree and its attached facet as required

This general contract can be implemented to build the surfaces of

• simple applications or applets exposing a single content object
• complex applications with multiple-content interfaces
• modal dialogs with single or multiple content pages

Method Summary

void	buildRetargeted() Build a targeter tree and pass its attached facet to a GUI host.
SHost	host() Return the host.
AreaTargeter	surfaceRootTargeter() The root of the surface targeter tree.

Methods inherited from interface facets.core.superficial.Notifiable

notify

Methods inherited from interface facets.util.Titled

title

Method Detail

buildRetargeted

void buildRetargeted()

Build a targeter tree and pass its attached facet to a GUI host.

surfaceRootTargeter

AreaTargeter surfaceRootTargeter()

The root of the surface targeter tree.

Returns:

the root of the targeter tree created in buildRetargeted()

host

SHost host()

Return the host.

In an application lazily create a suitable host if required; otherwise return the host passed during construction.