facets.facet.app
Class FacetDialogContenter.PanelFacets

java.lang.Object
  facets.util.Tracer
      facets.facet.FacetFactory
          facets.facet.app.FacetDialogContenter.PanelFacets

All Implemented Interfaces:

AppHost.LayoutFeatures, AppServices

Enclosing class:

FacetDialogContenter

public abstract static class FacetDialogContenter.PanelFacets
extends FacetFactory

FacetFactory for use by FacetDialogContenter.

Nested Class Summary

Nested classes/interfaces inherited from class facets.facet.FacetFactory

FacetFactory.AppletHost, FacetFactory.AppMenuBuilder, FacetFactory.AppTargeters, FacetFactory.ComboCoupler, FacetFactory.EditFacets, FacetFactory.SurfaceStyle, FacetFactory.ToolkitType

Field Summary

protected facets.facet.toolkit.Kit

kit

Fields inherited from class facets.facet.FacetFactory

BREAK, dragNotifyPause, dragNotifyWait, facets, findGraphValue, fontIndexing, fontSizeAt, fontSizes, GRAPH_APP, GRAPH_DIALOGS, GRAPH_FIND_NONE, GRAPH_NO_PATH, GRAPH_NONE, graphBuild, graphFindAt, graphFindNow, graphShowWhere, HINT_BARE, HINT_DEBUG, HINT_EXTRAS_PANE, HINT_GRID, HINT_INDEXING_SELECT, HINT_LABEL_AUTOCLEAR, HINT_MENU_NO_MNEMONICS, HINT_MENU_PRELOAD, HINT_NO_FLASH, HINT_NO_FOCUS, HINT_NONE, HINT_NUMERIC_FIELDS, HINT_NUMERIC_NUDGERS_FIRST, HINT_NUMERIC_UNGROUPED, HINT_PAINT_CACHE_DEEP, HINT_PANEL_ABOVE, HINT_PANEL_BELOW, HINT_PANEL_BORDER, HINT_PANEL_CENTER, HINT_PANEL_INSET, HINT_PANEL_MIDDLE, HINT_PANEL_RIGHT, HINT_SLIDER_FIELDS_TICKS_LABELS, HINT_SLIDER_LABELS, HINT_SLIDER_LOCAL, HINT_SLIDER_TICKS, HINT_SPREAD, HINT_SQUARE, HINT_TALL, HINT_TEXT_FONT, HINT_TITLE2, HINT_TITLE3, HINT_TOOLTIPS, HINT_USAGE_FORM, HINT_USAGE_PANEL, MENU_APP, MENU_EDIT, MENU_HELP, MENU_PANE, MENU_WINDOW, NO_FACET, notifyInterim, panelShade, surfaceStyle, TITLE_CORE_MENU, TITLE_EDIT_MENU, TITLE_FILE_MENU, TITLE_HELP_MENU, TITLE_WINDOW_MENU, TREE_COLLAPSE, TREE_EXPAND

Constructor Summary

FacetDialogContenter.PanelFacets(FacetFactory core)

Method Summary

SFacet	colorChooser(STargeter rgb) Creates a facet enabling the user to define an RGB shade.
AppWatcher	coupleAppWatcher(AppWatcher.WatcherCoupler coupler)
SFacet	fill() Creates a facet defining an empty panel to fill spare space in a row panel.
SFacet	hideMount(STargeter targeter, SFacet contents, java.lang.String hints) Creates a facet that can hide its contents.
void	hideMountSetHidden(SFacet mount, boolean hidden)
SFacet	indexingDropdownList(STargeter t, java.lang.String hints) Creates a facet defining a dropdown list.
SFacet	indexingIteratorButtons(STargeter t, java.lang.String hints) Creates a facet defining either a single or a pair of iterating pushbuttons.
SFacet	indexingIteratorItems(STargeter t) Creates a facet defining either a single or a pair of iterating action menu items.
SFacet	indexingIteratorMenu(STargeter t, java.lang.String hints) Creates a facet defining a sub-menu containing either a single or a pair of iterating action menu items.
SFacet	indexingPaneChecked(STargeter t, int width, int rows, java.lang.String hints) Creates a facet defining a list pane of items selected by checkboxes.
SFacet	indexingPaneMultiple(STargeter t, int width, int rows, java.lang.String hints) Creates a facet defining a multiple-selection list pane.
SFacet	indexingPaneSingle(STargeter t, int width, int rows, java.lang.String hints) Creates a facet defining a single-selection list pane.
SFacet	indexingRadioButtonMenu(STargeter t, java.lang.String hints) Creates a facet defining a radio-button sub-menu.
SFacet	indexingRadioButtonMenuItems(STargeter t, java.lang.String hints) Creates a facet defining a radio-button items group.
SFacet	indexingRadioButtons(STargeter t, java.lang.String hints) Creates a facet defining a radio-button panel.
SFacet	indexingRadioButtonSingle(STargeter t, int index, java.lang.String hints) Creates a facet defining a single radio-button from a panel.
static SFacet[]	join(SFacet[] front, SFacet[] back) Joins two facet arrays.
SFacet	menuRoot(MenuFacets content) Creates a facet defining a menu for attachment to a menu bar.
SFacet	menuRoot(STargeter t, java.lang.String title, SFacet... facets) Creates a facet defining a menu for attachment to a menu bar.
abstract SFacet	newContentPanel(SContentRootTargeter t) Build panel for FacetDialogContenter.
protected SFacet	newExtrasMount(AreaTargeter targeter, ValueNode stateApp, SFacet graph, SFacet help)
SFacet	numericFields(STargeter t, java.lang.String hints) Creates a facet defining one or more numeric text fields exposing the target of t or those of its elements.
SFacet	numericNudgeButtons(STargeter t, java.lang.String hints) Creates a facet defining one or more pairs of nudge buttons exposing the target of t or those of its elements.
SFacet	numericNudgeMenu(STargeter t, java.lang.String hints) Creates a facet attached to t defining a pair of action items.
SFacet[]	numericNudgeMenuItems(STargeter t, java.lang.String hints) Creates nudge menu items exposing a numeric.
SFacet[]	numericNudgeMenus(STargeter t, java.lang.String hints) Creates nudge menus exposing a numeric.
SFacet	numericSliders(STargeter t, int width, java.lang.String hints) Creates a facet defining one or more sliders exposing the target of t or those of its elements.
static void	resetCounts()
SFacet	rowPanel(STargeter t, int hgap, int vgap, java.lang.String hints, SFacet... contents) Creates an area facet defining a containing panel.
SFacet	rowPanel(STargeter t, SFacet... contents) Creates an area facet defining a containing panel with special layout behaviour.
SFacet[]	rowPanels(SFacet[][] facets, STargeter t, java.lang.String hints) Wraps facet arrays in row panels.
SFacet	simpleMastered(STargeter t, FacetMaster.Simple master) Creates a simple facet with a custom panel.
SFacet	spacerTall(int gap) Creates a facet defining an empty panel for use as a vertical spacer.
SFacet	spacerWide(int gap) Creates a facet defining an empty panel for use as a horizontal spacer.
MountFacet	switchMount(java.lang.String title) Creates a facet mount that can switch its visible contents.
static SIndexing	switchMountIndexing(SFacet mount, SIndexing.Coupler coupler) Creates an indexing setting the facet to be displayed by the facet passed.
SFacet	tabMount(STargeter targeter, SFacet[] facets, java.lang.String[] titles)
SFacet	textualField(STargeter t, int cols, java.lang.String hints) Creates a facet defining a single-line text field.
SFacet	textualLabel(STargeter t, java.lang.String hints) Creates a facet defining a single-line variable text label.
SFacet	togglingButtons(STargeter t, java.lang.String hints) Creates a facet defining a toggle button or button panel.
SFacet	togglingCheckboxes(STargeter t, java.lang.String hints) Creates a facet defining a checkbox or checkbox panel.
SFacet	togglingCheckboxMenu(STargeter t, java.lang.String hints) Creates a facet defining a checkbox sub-menu.
SFacet	togglingCheckboxMenuItems(STargeter t, java.lang.String hints) Creates a facet defining one or more checkbox menu items.
SFacet	toolGroups(STargeter t, java.lang.String hints, SFacet... contents) Creates an area facet defining groups of facets.
java.lang.String	toString()
SFacet	triggerButtons(STargeter t, java.lang.String hints) Creates a facet defining one or more pushbuttons.
SFacet	triggerMenu(STargeter t, java.lang.String hints) Creates a facet defining an action menu.
SFacet	triggerMenuItems(STargeter t, java.lang.String hints) Creates a facet defining one or more action menu items.
static java.lang.String	version()

Methods inherited from class facets.facet.FacetFactory

adjustMenuRoots, appletHostWrap, areas, editTools, extras, extras, fillFontSizes, findPaneTargeter, fontFactor, helpMenuFacets, menus, newAdjustedMenus, newAppletCore, newCountsText, newDesktopCore, newDesktopHost, providingCache, services, setAppProvidingCache, sidebar, statefulClipperSource, status, toolbar, warningCritical, windowMenuFacets

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.util.app.AppServices

coupleAppWatcher

Field Detail

kit

protected final facets.facet.toolkit.Kit kit

Constructor Detail

FacetDialogContenter.PanelFacets

public FacetDialogContenter.PanelFacets(FacetFactory core)

Method Detail

newContentPanel

public abstract SFacet newContentPanel(SContentRootTargeter t)

Build panel for FacetDialogContenter.

Parameters:

t - passed from FacetDialogContenter.newContentPanel(SContentRootTargeter)

coupleAppWatcher

public final AppWatcher coupleAppWatcher(AppWatcher.WatcherCoupler coupler)

colorChooser

public final SFacet colorChooser(STargeter rgb)

Creates a facet enabling the user to define an RGB shade.

Parameters:

rgb - must be retargeted on a SNumeric, whose value is interpreted as defining a Shade.

fill

public final SFacet fill()

Creates a facet defining an empty panel to fill spare space in a row panel.

Used after FacetFactory.BREAK it fills the bottom of the panel.

indexingIteratorMenu

public final SFacet indexingIteratorMenu(STargeter t,
                                         java.lang.String hints)

Creates a facet defining a sub-menu containing either a single or a pair of iterating action menu items.

Parameters:

t - must be targeted on an SIndexing; its coupler defines the items

hints -

indexingIteratorButtons

public final SFacet indexingIteratorButtons(STargeter t,
                                            java.lang.String hints)

Creates a facet defining either a single or a pair of iterating pushbuttons.

Parameters:

t - must be targeted on an SIndexing; its coupler defines the items

hints - one or more FacetFactory HINT constants concatenated

indexingIteratorItems

public final SFacet indexingIteratorItems(STargeter t)

Creates a facet defining either a single or a pair of iterating action menu items.

Parameters:

t - must be targeted on an SIndexing; its coupler defines the items

indexingDropdownList

public final SFacet indexingDropdownList(STargeter t,
                                         java.lang.String hints)

Creates a facet defining a dropdown list.

Editable behaviour of the selected item can be defined by creating the indexing target with a Facets.ComboCoupler.

Parameters:

t - must be targeted on an SIndexing

hints - one or more FacetFactory HINT constants concatenated

indexingPaneSingle

public final SFacet indexingPaneSingle(STargeter t,
                                       int width,
                                       int rows,
                                       java.lang.String hints)

Creates a facet defining a single-selection list pane.

Parameters:

t - must be targeted on an SIndexing

width - pixel width

rows - visible items count

hints - one or more FacetFactory HINT constants concatenated

indexingPaneChecked

public final SFacet indexingPaneChecked(STargeter t,
                                        int width,
                                        int rows,
                                        java.lang.String hints)

Creates a facet defining a list pane of items selected by checkboxes.

Parameters:

t - must be targeted on an SIndexing

width - pixel width

rows - visible items count

hints - one or more FacetFactory HINT constants concatenated

indexingPaneMultiple

public final SFacet indexingPaneMultiple(STargeter t,
                                         int width,
                                         int rows,
                                         java.lang.String hints)

Creates a facet defining a multiple-selection list pane.

Parameters:

t - must be targeted on an SIndexing

width - pixel width

rows - visible items count

hints - one or more FacetFactory HINT constants concatenated

indexingRadioButtonMenu

public final SFacet indexingRadioButtonMenu(STargeter t,
                                            java.lang.String hints)

Creates a facet defining a radio-button sub-menu.

Parameters:

t - must be retargeted on an SIndexing; its indexables will appear in the menu

indexingRadioButtonMenuItems

public final SFacet indexingRadioButtonMenuItems(STargeter t,
                                                 java.lang.String hints)

Creates a facet defining a radio-button items group.

Parameters:

t - must be retargeted on an SIndexing; its indexables will appear as the items

hints - one or more FacetFactory HINT constants concatenated

indexingRadioButtons

public final SFacet indexingRadioButtons(STargeter t,
                                         java.lang.String hints)

Creates a facet defining a radio-button panel.

Parameters:

t - must be retargeted on an indexing

hints - one or more FacetFactory HINT constants concatenated

indexingRadioButtonSingle

public final SFacet indexingRadioButtonSingle(STargeter t,
                                              int index,
                                              java.lang.String hints)

Creates a facet defining a single radio-button from a panel.

Parameters:

t - must be retargeted on an SIndexing

index - the indexable to be exposed by the button

hints - one or more FacetFactory HINT constants concatenated

menuRoot

public final SFacet menuRoot(MenuFacets content)

Creates a facet defining a menu for attachment to a menu bar.

The menu will check MenuFacets.getFacets() on each retargeting and update its items accordingly.

Parameters:

content - content supplying menu members and title

menuRoot

public final SFacet menuRoot(STargeter t,
                             java.lang.String title,
                             SFacet... facets)

Creates a facet defining a menu for attachment to a menu bar.

Calls menuRoot(MenuFacets) with a trivial subclass constructed from the parameters.

numericFields

public final SFacet numericFields(STargeter t,
                                  java.lang.String hints)

Creates a facet defining one or more numeric text fields exposing the target of t or those of its elements.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

hints - one or more FacetFactory HINT constants concatenated

numericNudgeButtons

public final SFacet numericNudgeButtons(STargeter t,
                                        java.lang.String hints)

Creates a facet defining one or more pairs of nudge buttons exposing the target of t or those of its elements.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

hints - one or more FacetFactory HINT constants concatenated

numericNudgeMenu

public final SFacet numericNudgeMenu(STargeter t,
                                     java.lang.String hints)

Creates a facet attached to t defining a pair of action items.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

hints -

numericNudgeMenuItems

public final SFacet[] numericNudgeMenuItems(STargeter t,
                                            java.lang.String hints)

Creates nudge menu items exposing a numeric.

Facets attached to the elements of t each define a pair of action items.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

hints -

numericNudgeMenus

public final SFacet[] numericNudgeMenus(STargeter t,
                                        java.lang.String hints)

Creates nudge menus exposing a numeric.

Facets attached to the elements of t each define sub-menu containing a pair of action items.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

hints -

numericSliders

public final SFacet numericSliders(STargeter t,
                                   int width,
                                   java.lang.String hints)

Creates a facet defining one or more sliders exposing the target of t or those of its elements.

Parameters:

t - must be retargeted on a numeric or a grouping of numerics

width - the width of each slider

hints - one or more FacetFactory HINT constants concatenated

rowPanel

public final SFacet rowPanel(STargeter t,
                             int hgap,
                             int vgap,
                             java.lang.String hints,
                             SFacet... contents)

Creates an area facet defining a containing panel.

The panel uses a flow-type layout for each row, creating a new row for each occurrence in contents of class constant BREAK.

Parameters:

t - will usually be retargeted on a frame

hgap - horizontal gap between panels abstracted by contents

vgap - vertical gap between panels abstracted by contents

hints - one or more Facets HINT constants concatenated

contents - panel-type facet created using FacetFactory, with new rows denoted by BREAK

rowPanel

public final SFacet rowPanel(STargeter t,
                             SFacet... contents)

Creates an area facet defining a containing panel with special layout behaviour.

The panel uses a flow-type layout for each row, creating a new row for each occurrence in contents of class constant BREAK.

Panels abstracted by contents are aligned left, with zero horizontal and vertical separation.

Parameters:

t - will usually be retargeted on a frame

contents - panel-type facet created using FacetFactory, with new rows denoted by BREAK

rowPanels

public final SFacet[] rowPanels(SFacet[][] facets,
                                STargeter t,
                                java.lang.String hints)

Wraps facet arrays in row panels.

Parameters:

facets - the arrays to wrap

t - will control all panels

hints - can set alignment

spacerTall

public final SFacet spacerTall(int gap)

Creates a facet defining an empty panel for use as a vertical spacer.

Parameters:

gap - the vertical gap required

spacerWide

public final SFacet spacerWide(int gap)

Creates a facet defining an empty panel for use as a horizontal spacer.

Parameters:

gap - the horizontal gap required

switchMount

public final MountFacet switchMount(java.lang.String title)

Creates a facet mount that can switch its visible contents.

Set the contents with MountFacet.setFacets(SFacet...); and a coupler for the indexing with switchMountIndexing(SFacet, facets.core.superficial.SIndexing.Coupler).

Parameters:

title - will be used for the controlling indexing

switchMountIndexing

public static final SIndexing switchMountIndexing(SFacet mount,
                                                  SIndexing.Coupler coupler)

Creates an indexing setting the facet to be displayed by the facet passed.

Parameters:

mount - must have been created using switchMount.

coupler - is attached to the indexing

hideMount

public final SFacet hideMount(STargeter targeter,
                              SFacet contents,
                              java.lang.String hints)

Creates a facet that can hide its contents.

hideMountSetHidden

public final void hideMountSetHidden(SFacet mount,
                                     boolean hidden)

tabMount

public final SFacet tabMount(STargeter targeter,
                             SFacet[] facets,
                             java.lang.String[] titles)

textualField

public final SFacet textualField(STargeter t,
                                 int cols,
                                 java.lang.String hints)

Creates a facet defining a single-line text field.

Parameters:

t - must be retargeted on a textual

hints - one or more FacetFactory HINT constants concatenated

textualLabel

public final SFacet textualLabel(STargeter t,
                                 java.lang.String hints)

Creates a facet defining a single-line variable text label.

Parameters:

t - must be retargeted on a textual

hints - one or more FacetFactory HINT constants concatenated

togglingButtons

public final SFacet togglingButtons(STargeter t,
                                    java.lang.String hints)

Creates a facet defining a toggle button or button panel.

Parameters:

t - must be retargeted on a toggling or a grouping of togglings

hints - one or more FacetFactory HINT constants concatenated

triggerButtons

public final SFacet triggerButtons(STargeter t,
                                   java.lang.String hints)

Creates a facet defining one or more pushbuttons.

Parameters:

t - must be retargeted on a trigger or a grouping of triggers

hints - one or more FacetFactory HINT constants concatenated

togglingCheckboxes

public final SFacet togglingCheckboxes(STargeter t,
                                       java.lang.String hints)

Creates a facet defining a checkbox or checkbox panel.

Parameters:

t - must be retargeted on a toggling or a grouping of togglings

hints - one or more FacetFactory HINT constants concatenated

togglingCheckboxMenu

public final SFacet togglingCheckboxMenu(STargeter t,
                                         java.lang.String hints)

Creates a facet defining a checkbox sub-menu.

Parameters:

t - must be retargeted on a toggling or a grouping of togglings

hints -

triggerMenu

public final SFacet triggerMenu(STargeter t,
                                java.lang.String hints)

Creates a facet defining an action menu.

Parameters:

t - must be retargeted on a trigger or a grouping of triggers

hints -

togglingCheckboxMenuItems

public final SFacet togglingCheckboxMenuItems(STargeter t,
                                              java.lang.String hints)

Creates a facet defining one or more checkbox menu items.

Parameters:

t - must be retargeted on a toggling or a grouping of togglings

hints -

triggerMenuItems

public final SFacet triggerMenuItems(STargeter t,
                                     java.lang.String hints)

Creates a facet defining one or more action menu items.

Parameters:

t - must be retargeted on a trigger or a grouping of triggers

hints -

toolGroups

public final SFacet toolGroups(STargeter t,
                               java.lang.String hints,
                               SFacet... contents)

Creates an area facet defining groups of facets.

Parameters:

t - will usually be retargeted on a frame

contents - tool-type facets created using FacetFactory

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object

simpleMastered

public final SFacet simpleMastered(STargeter t,
                                   FacetMaster.Simple master)

Creates a simple facet with a custom panel.

The master passed is cast to an appropriate base class for the toolkit used by the FacetFactory.

Parameters:

t - must be retargeted on an appropriate target

master - must build a panel capable of exposing a target of t

newExtrasMount

protected final SFacet newExtrasMount(AreaTargeter targeter,
                                      ValueNode stateApp,
                                      SFacet graph,
                                      SFacet help)

version

public static java.lang.String version()

resetCounts

public static void resetCounts()

join

public static final SFacet[] join(SFacet[] front,
                                  SFacet[] back)

Joins two facet arrays.