|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object facets.util.Tracer facets.core.app.DialogSurface facets.facet.app.FacetDialogSurface
public abstract class FacetDialogSurface
DialogSurface
with attached FacetFactory
.
Declared abstract
to enable use of classname in values keys.
Nested Class Summary | |
---|---|
static class |
FacetDialogSurface.MultiPaged
FacetDialogSurface for multi-page dialogs. |
Nested classes/interfaces inherited from class facets.core.app.DialogSurface |
---|
DialogSurface.Contenter, DialogSurface.ContentRoot, DialogSurface.DialogActions |
Field Summary | |
---|---|
protected FacetFactory |
ff
|
static int |
MULTI_AREA_PAGES
|
static int |
MULTI_AREA_TREE
|
Fields inherited from class facets.core.app.DialogSurface |
---|
app, AT_NOT_SET, TRIMMINGS_TAB, TRIMMINGS_TREE |
Constructor Summary | |
---|---|
FacetDialogSurface(FacetAppSurface app,
DialogHost host,
java.lang.String title,
DialogSurface.DialogActions actions,
DialogSurface.Contenter[] contents)
|
Method Summary | |
---|---|
void |
addExtensionPanel(SFacet panel,
boolean atSide)
|
protected void |
attachPageFacet(SAreaTarget panel)
Attach a suitable facet to this page area. |
protected void |
attachSurfaceRootFacets(SAreaTarget root)
Attach suitable facets to the dialog area root and its children. |
static java.awt.Point |
calculateSmartDialogAt(java.awt.Dimension box,
SHost host)
|
SHost |
host()
|
void |
hostWindowDismissed(java.awt.Rectangle closingBounds,
double factor)
|
boolean |
isResizable()
|
protected SAreaTarget[] |
newContentPages(DialogSurface.Contenter[] contents,
SAreaTarget[] contentRoots)
Create at least one dialog page. |
protected SFacet |
newControlButtons(STargeter link)
Create facet managing the top-level dialog control buttons. |
static Dialogs.Surfacer |
newDefaultPagedSurfacer(DialogSurface.Contenter[] apps,
DialogSurface.Contenter[] debugs)
Convenience method for creating a paged dialog controlled by a tree or list view. |
static Dialogs.Surfacer |
newDefaultTabbedSurfacer()
Convenience method for creating a tabbed dialog. |
protected SFacet |
newExtras(AreaTargeter targeter)
|
protected SView |
newPagesTreeView(TypedNode[] treeNodes)
Create a view for the page tree. |
protected static TypedNode |
newPageTreeNode(SAreaTarget page,
TypedNode... children)
Creates a node for a page selection tree. |
protected TypedNode[] |
newPageTreeNodes(SAreaTarget[] pages)
Creates the top-level children of a page selection tree. |
void |
notify(Notice notice)
Overrides superclass method. |
java.awt.Rectangle |
scaledLaunchBounds(double factor)
|
AreaTargeter |
surfaceRootTargeter()
|
java.lang.String |
title()
Return human-readable identifying text. |
protected void |
traceOutput(java.lang.String msg)
Outputs complete trace messages to console or elsewhere. |
Methods inherited from class facets.core.app.DialogSurface |
---|
buildRetargeted, contents, contentsKey, contentsMatch, dismissHostWindow, findDialogTrigger, findRootArea, getLaunchBounds, hostWindowDismissed, isMultiPage, persistBoundsState, replaceContents |
Methods inherited from class facets.util.Tracer |
---|
trace, trace, trace, trace, trace, traceDebug, traceDebug, traceObjectText, traceOutputWithClass |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface facets.core.superficial.app.SSurface |
---|
host, surfaceRootTargeter |
Methods inherited from interface facets.util.Titled |
---|
title |
Field Detail |
---|
protected final FacetFactory ff
public static final int MULTI_AREA_TREE
public static final int MULTI_AREA_PAGES
Constructor Detail |
---|
public FacetDialogSurface(FacetAppSurface app, DialogHost host, java.lang.String title, DialogSurface.DialogActions actions, DialogSurface.Contenter[] contents)
Method Detail |
---|
protected void attachSurfaceRootFacets(SAreaTarget root)
root
- contains either a single page area returned by
newContentPages(DialogSurface.Contenter[], SAreaTarget[])
or viewer and switching
areas managing multiple page areasprotected final void attachPageFacet(SAreaTarget panel)
panel
- was returned by newContentPages(DialogSurface.Contenter[], SAreaTarget[])
and
will not itself be a content root.protected final SFacet newControlButtons(STargeter link)
link
- will match the elements returned by lazyTriggerGroup()
SFacet
[] with at least one memberpublic final java.awt.Rectangle scaledLaunchBounds(double factor)
public final void hostWindowDismissed(java.awt.Rectangle closingBounds, double factor)
public boolean isResizable()
public void addExtensionPanel(SFacet panel, boolean atSide)
public void notify(Notice notice)
Notice
s with Notifying.Impact.FLASH
are ignored
notify
in interface Notifiable
notify
in class DialogSurface
protected SFacet newExtras(AreaTargeter targeter)
protected void traceOutput(java.lang.String msg)
Tracer
Default prepends helpful classname to message.
traceOutput
in class Tracer
msg
- passed from one of the public
methodspublic static Dialogs.Surfacer newDefaultTabbedSurfacer()
Dialogs.Surfacer
that will created an appropriate FacetDialogSurface
public static Dialogs.Surfacer newDefaultPagedSurfacer(DialogSurface.Contenter[] apps, DialogSurface.Contenter[] debugs)
apps
- contenters creating pages to appear directly under the tree rootdebugs
- contenters creating pages to appear under a child root created
from the first member which must be titled FacetPreferences.TITLE_HEADER
Dialogs.Surfacer
that will create a FacetDialogSurface
with a private
implementation of DialogPages.newPageTreeNodes(SAreaTarget[])
creating an
appropriate tree.public static java.awt.Point calculateSmartDialogAt(java.awt.Dimension box, SHost host)
protected SAreaTarget[] newContentPages(DialogSurface.Contenter[] contents, SAreaTarget[] contentRoots)
Where the implementation returns a multi-member array,
newPagesTreeView(TypedNode[])
to define a tree/list viewer
to select between the pages;
for a full tree viewer newPageTreeNodes(SAreaTarget[])
will also
need to be re-implementedattachSurfaceRootFacets(SAreaTarget)
will
contain the tree viewer area and an area containing the pagesThe default implementation defines a single-page dialog by returning a single-member array containing:
contentRoots
is single-membered, that member
contentRoots
(whose root facet can be displayed as tab children of the facet
attached to the area), titled from {title()
contents
- passed during construction or to
DialogSurface.replaceContents(DialogSurface.Contenter[])
;
may be queried for additional information such as page titlescontentRoots
- were created from contents
SAreaTarget
[] with at least one memberprotected TypedNode[] newPageTreeNodes(SAreaTarget[] pages)
Children created will be passed to newPagesTreeView(TypedNode[])
which should be reimplemented to define a viewer for the
tree.
The default implementation returns an array constructed from
panelAreas
using newPageTreeNode(SAreaTarget,TypedNode[])
and suitable for a list viewer; this method can also be used to created
more complex trees.
pages
- were returned from newContentPages(DialogSurface.Contenter[], SAreaTarget[])
protected SView newPagesTreeView(TypedNode[] treeNodes)
The SView
returned should define a suitable
viewer for the tree defined by treeNodes
, which
were returned by newPageTreeNodes(SAreaTarget[])
.
Default implementation is an invalid stub.
treeNodes
- will have at least two memberspublic final AreaTargeter surfaceRootTargeter()
public final java.lang.String title()
Titled
title
in interface Titled
null
, non-empty string with no structural whitespaceprotected static final TypedNode newPageTreeNode(SAreaTarget page, TypedNode... children)
The node returned will
type
TYPE_PAGE
title
the title of panelRoot
panelRoot
as its single value
children
as its children
page
- should be an area tree defining the layout
of a dialog pagechildren
- to appear in a tree viewer
below the node created; themselves created using this methodpublic final SHost host()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |