Package io.guise.framework.component
Interface SelectActionControl
- All Superinterfaces:
ActionControl
,ActionListenable
,ActionModel
,Component
,Control
,DepictedObject
,Displayable
,Enableable
,InfoModel
,InputFocusableComponent
,LabelModel
,Model
,PresentationModel
,com.globalmentor.beans.PropertyBindable
,com.globalmentor.beans.PropertyConstrainable
,Selectable
- All Known Subinterfaces:
SelectButtonControl
,SelectLinkControl
- All Known Implementing Classes:
AbstractBooleanSelectActionControl
,AbstractSelectActionControl
,AbstractSelectActionValueControl
,BooleanSelectButton
,BooleanSelectLink
,BooleanSelectToolButton
,ImageBooleanSelectActionControl
,SelectButton
,SelectLink
,TaskStateSelectLink
,ValueSelectButton
,ValueSelectLink
An action control that keeps track of its selected state. If the control is set to be toggled, when the action is initiated the selected state alternates
between
true
and false
. Otherwise, an action sets the selected state to true
. The control defaults to auto-select
mode. If this mode is turned off, no selection or toggling occurs automatically when the action occurs.- Author:
- Garret Wilson
-
Nested Class Summary
Nested classes/interfaces inherited from interface io.guise.framework.component.Component
Component.FlyoverStrategy<S extends Component>
Nested classes/interfaces inherited from interface io.guise.framework.component.Control
Control.Status
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
The auto-select bound property.static final String
The selected icon bound property.static final String
The toggle bound property.static final String
The unselected icon bound property.Fields inherited from interface io.guise.framework.component.ActionControl
ROLLOVER_PROPERTY
Fields inherited from interface io.guise.framework.component.Component
BOOKMARK_ENABLED_PROPERTY, CONSTRAINTS_PROPERTY, DRAG_ENABLED_PROPERTY, DROP_ENABLED_PROPERTY, FLYOVER_ENABLED_PROPERTY, FLYOVER_STRATEGY_PROPERTY, INPUT_STRATEGY_PROPERTY, NAME_PROPERTY, NOTIFICATION_PROPERTY, ORIENTATION_PROPERTY, THEME_APPLIED_PROPERTY, VALID_PROPERTY
Fields inherited from interface io.guise.framework.component.Control
STATUS_PROPERTY
Fields inherited from interface io.guise.framework.model.Displayable
DISPLAYED_PROPERTY
Fields inherited from interface io.guise.framework.model.Enableable
ENABLED_PROPERTY
Fields inherited from interface io.guise.framework.model.InfoModel
DESCRIPTION_CONTENT_TYPE_PROPERTY, DESCRIPTION_PROPERTY, INFO_CONTENT_TYPE_PROPERTY, INFO_PROPERTY
Fields inherited from interface io.guise.framework.model.LabelModel
GLYPH_URI_PROPERTY, LABEL_CONTENT_TYPE_PROPERTY, LABEL_PROPERTY
Fields inherited from interface io.guise.framework.model.ui.PresentationModel
BACKGROUND_COLOR_PROPERTY, BORDER_LINE_FAR_COLOR_PROPERTY, BORDER_LINE_FAR_EXTENT_PROPERTY, BORDER_LINE_FAR_STYLE_PROPERTY, BORDER_LINE_NEAR_COLOR_PROPERTY, BORDER_LINE_NEAR_EXTENT_PROPERTY, BORDER_LINE_NEAR_STYLE_PROPERTY, BORDER_PAGE_FAR_COLOR_PROPERTY, BORDER_PAGE_FAR_EXTENT_PROPERTY, BORDER_PAGE_FAR_STYLE_PROPERTY, BORDER_PAGE_NEAR_COLOR_PROPERTY, BORDER_PAGE_NEAR_EXTENT_PROPERTY, BORDER_PAGE_NEAR_STYLE_PROPERTY, CORNER_LINE_FAR_PAGE_FAR_ARC_SIZE_PROPERTY, CORNER_LINE_FAR_PAGE_NEAR_ARC_SIZE_PROPERTY, CORNER_LINE_NEAR_PAGE_FAR_ARC_SIZE_PROPERTY, CORNER_LINE_NEAR_PAGE_NEAR_ARC_SIZE_PROPERTY, CURSOR_PROPERTY, FONT_FAMILIES_PROPERTY, FONT_SIZE_PROPERTY, FONT_STYLE_PROPERTY, FONT_WEIGHT_BOLD, FONT_WEIGHT_NORMAL, FONT_WEIGHT_PROPERTY, LABEL_FONT_FAMILIES_PROPERTY, LABEL_FONT_SIZE_PROPERTY, LABEL_FONT_STYLE_PROPERTY, LABEL_FONT_WEIGHT_PROPERTY, LABEL_TEXT_COLOR_PROPERTY, LINE_EXTENT_PROPERTY, MARGIN_LINE_FAR_EXTENT_PROPERTY, MARGIN_LINE_NEAR_EXTENT_PROPERTY, MARGIN_PAGE_FAR_EXTENT_PROPERTY, MARGIN_PAGE_NEAR_EXTENT_PROPERTY, OPACITY_PROPERTY, PADDING_LINE_FAR_EXTENT_PROPERTY, PADDING_LINE_NEAR_EXTENT_PROPERTY, PADDING_PAGE_FAR_EXTENT_PROPERTY, PADDING_PAGE_NEAR_EXTENT_PROPERTY, PAGE_EXTENT_PROPERTY, ROUNDED_CORNER_ARC_SIZE, STYLE_ID_PROPERTY, TEXT_COLOR_PROPERTY, TOOLTIP_ENABLED_PROPERTY, VISIBLE_PROPERTY
Fields inherited from interface io.guise.framework.model.Selectable
SELECTED_PROPERTY
-
Method Summary
Modifier and TypeMethodDescriptionboolean
boolean
isToggle()
void
setAutoSelect
(boolean newAutoSelect) Sets whether this control automatically sets or toggles the selection state when the action occurs.void
setSelectedGlyphURI
(URI newSelectedIcon) Sets the URI of the selected icon.void
setToggle
(boolean newToggle) Sets whether this control acts as a toggle, switching its value betweentrue
andfalse
, or whether the action always sets the value totrue
.void
setUnselectedGlyphURI
(URI newUnselectedIcon) Sets the URI of the unselected icon.Methods inherited from interface io.guise.framework.component.ActionControl
isRollover, setRollover
Methods inherited from interface io.guise.framework.event.ActionListenable
addActionListener, removeActionListener
Methods inherited from interface io.guise.framework.model.ActionModel
getActionListeners, performAction, performAction
Methods inherited from interface io.guise.framework.component.Component
addCommandListener, addExportStrategy, addImportStrategy, addKeyListener, addMouseListener, addNotificationListener, addPreferenceProperty, applyTheme, applyTheme, dispatchInputEvent, exportTransfer, fireInputEvent, getAncestor, getComponentOrientation, getConstraints, getDepictor, getFlyoverStrategy, getInputStrategy, getName, getNotification, getOrientation, getParent, getPreferenceProperties, getTheme, hasCommandListeners, hasKeyListeners, hasMouseListeners, importTransfer, initialize, isDragEnabled, isDropEnabled, isFlyoverEnabled, isPreferenceProperty, isThemeApplied, isValid, loadPreferences, notify, removeCommandListener, removeExportStrategy, removeImportStrategy, removeKeyListener, removeMouseListener, removeNotificationListener, removePreferenceProperty, resetTheme, savePreferences, setConstraints, setDragEnabled, setDropEnabled, setFlyoverEnabled, setFlyoverStrategy, setInputStrategy, setName, setNotification, setOrientation, setParent, setThemeApplied, updateTheme, validate
Methods inherited from interface io.guise.framework.platform.DepictedObject
depict, getDepictID, getSession, processEvent
Methods inherited from interface io.guise.framework.model.Enableable
isEnabled, setEnabled
Methods inherited from interface io.guise.framework.model.InfoModel
getDescription, getDescriptionContentType, getInfo, getInfoContentType, setDescription, setDescriptionContentType, setInfo, setInfoContentType
Methods inherited from interface io.guise.framework.model.LabelModel
getGlyphURI, getLabel, getLabelContentType, setGlyphURI, setLabel, setLabelContentType
Methods inherited from interface io.guise.framework.model.ui.PresentationModel
BorderLineFarColor, BorderLineFarExtent, BorderLineFarStyle, BorderLineNearColor, BorderLineNearExtent, BorderLineNearStyle, BorderPageFarColor, BorderPageFarExtent, BorderPageFarStyle, BorderPageNearColor, BorderPageNearExtent, BorderPageNearStyle, getBackgroundColor, getBorderColor, getBorderExtent, getBorderStyle, getCornerArcSize, getCornerLineFarPageFarArcSize, getCornerLineFarPageNearArcSize, getCornerLineNearPageFarArcSize, getCornerLineNearPageNearArcSize, getCursor, getExtent, getFontFamilies, getFontSize, getFontStyle, getFontWeight, getLabelFontFamilies, getLabelFontSize, getLabelFontStyle, getLabelFontWeight, getLabelTextColor, getLineExtent, getMarginExtent, getMarginLineFarExtent, getMarginLineNearExtent, getMarginPageFarExtent, getMarginPageNearExtent, getOpacity, getPaddingExtent, getPaddingLineFarExtent, getPaddingLineNearExtent, getPaddingPageFarExtent, getPaddingPageNearExtent, getPageExtent, getSession, getStyleID, getTextColor, isDisplayed, isTooltipEnabled, isVisible, setBackgroundColor, setBorderColor, setBorderColor, setBorderExtent, setBorderExtent, setBorderLineFarColor, setBorderLineFarExtent, setBorderLineFarStyle, setBorderLineNearColor, setBorderLineNearExtent, setBorderLineNearStyle, setBorderPageFarColor, setBorderPageFarExtent, setBorderPageFarStyle, setBorderPageNearColor, setBorderPageNearExtent, setBorderPageNearStyle, setBorderStyle, setBorderStyle, setCornerArcSize, setCornerArcSize, setCornerLineFarPageFarArcSize, setCornerLineFarPageNearArcSize, setCornerLineNearPageFarArcSize, setCornerLineNearPageNearArcSize, setCursor, setDisplayed, setExtent, setFontFamilies, setFontSize, setFontStyle, setFontWeight, setLabelFontFamilies, setLabelFontSize, setLabelFontStyle, setLabelFontWeight, setLabelTextColor, setLineExtent, setMarginExtent, setMarginExtent, setMarginLineFarExtent, setMarginLineNearExtent, setMarginPageFarExtent, setMarginPageNearExtent, setOpacity, setPaddingExtent, setPaddingExtent, setPaddingLineFarExtent, setPaddingLineNearExtent, setPaddingPageFarExtent, setPaddingPageNearExtent, setPageExtent, setStyleID, setTextColor, setTooltipEnabled, setVisible
Methods inherited from interface com.globalmentor.beans.PropertyBindable
addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, hasPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener
Methods inherited from interface com.globalmentor.beans.PropertyConstrainable
addVetoableChangeListener, addVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, hasVetoableChangeListeners, removeVetoableChangeListener, removeVetoableChangeListener
Methods inherited from interface io.guise.framework.model.Selectable
isSelected, setSelected
-
Field Details
-
AUTO_SELECT_PROPERTY
The auto-select bound property. -
SELECTED_GLYPH_URI_PROPERTY
The selected icon bound property. -
TOGGLE_PROPERTY
The toggle bound property. -
UNSELECTED_GLYPH_URI_PROPERTY
The unselected icon bound property.
-
-
Method Details
-
isAutoSelect
boolean isAutoSelect()- Returns:
- Whether this control automatically sets or toggles the selection state when the action occurs.
-
setAutoSelect
void setAutoSelect(boolean newAutoSelect) Sets whether this control automatically sets or toggles the selection state when the action occurs. This is a bound property of typeBoolean
.- Parameters:
newAutoSelect
-true
if the control should automatically set or toggle the selection state when an action occurs.- See Also:
-
getSelectedGlyphURI
URI getSelectedGlyphURI()- Returns:
- The selected icon URI, which may be a resource URI, or
null
if there is no selected icon URI.
-
setSelectedGlyphURI
Sets the URI of the selected icon. This is a bound property of typeURI
.- Parameters:
newSelectedIcon
- The new URI of the selected icon, which may be a resource URI.- See Also:
-
isToggle
boolean isToggle()- Returns:
- Whether this control acts as a toggle, switching its value between
true
andfalse
, or whether the action always sets the value totrue
.
-
setToggle
void setToggle(boolean newToggle) Sets whether this control acts as a toggle, switching its value betweentrue
andfalse
, or whether the action always sets the value totrue
. This is a bound property of typeBoolean
.- Parameters:
newToggle
-true
if the component should act as a toggle, elsefalse
if the action should unconditionally set the value totrue
.- See Also:
-
getUnselectedGlyphURI
URI getUnselectedGlyphURI()- Returns:
- The unselected icon URI, which may be a resource URI, or
null
if there is no unselected icon URI.
-
setUnselectedGlyphURI
Sets the URI of the unselected icon. This is a bound property of typeURI
.- Parameters:
newUnselectedIcon
- The new URI of the unselected icon, which may be a resource URI.- See Also:
-