com.smartgwt.client.widgets

Class SCStatefulImgConfig

java.lang.Object

com.smartgwt.client.core.JsObject

com.smartgwt.client.core.DataClass

com.smartgwt.client.widgets.SCStatefulImgConfig

All Implemented Interfaces:

com.google.gwt.event.shared.HasHandlers

public class SCStatefulImgConfig
extends DataClass

A configuration object containing image URLs for a set of possible images to display based on the state of some components. See the stateful images overview for more information.

Each attribute in this configuration object maps a state to a target URL.
Each URL may be specified in one of three ways

• a standard SCImgURL may be used to refer directly to an image file.
• the "#state:" prefix may be used to display media from another specified state.
• the "#modifier:" prefix may be used to specify a modifier string to apply to the base image.
  The modifier will be applied to the base file name before the file type suffix.

For example, consider a stateful image config with the following properties:

  {    _base:"button.png",
       Over:"bright_button.png",
       Focused:"#state:Over",
       Selected:"#state:Over",
       Disabled:"#modifier:_Disabled",
       SelectedDisabled:"#state:Selected"
  }
  

In this case

• the base image URL and the the "Over" state image URL would be determined using the standard SCImgURL rules
• the "Focused" and "Selected" state images would re-use the "Over" state image ("bright_button.png")
• the "Disabled" state image would be the base state image with a "_Disabled" suffix applied to the file name ("button_Disabled.png")
• the "SelectedDisabled" entry would be used for the combined "Selected" and "Disabled" states, and would re-use the "Selected" state image (which in turn maps back to the "Over" state, resolving to "bright_button.png")

The default set of standard states are explicitly documented, but this object format is extensible. A developer may specify additional attributes on a SCStatefulImgConfig beyond the standard documented states and they may be picked up if a custom state is applied to a component (via a call to StatefulCanvas.setState(), for example).

In some cases, an icon may have only custom states - for example, a tree-folder icon is always either opened or closed. In these cases, a _base entry is only required if entries in the object use the #state or #modifier components.

Combined states and missing entries:

The focused and selected states may be applied to a component in combination with other states. For example an ImgButton marked both Selected and Disabled will look for media to represent this combined state. To provide such media in a SCStatefulImgConfig, use the combined state names (in this case SelectedDisabled).
If a component is both Selected and Focused, three-part combined states are also possible (Selected + Focused + Over gives SelectedFocusedOver for example).

The SCStatefulImgConfig format may be sparse - developers may skip providing values for certain states (or combined states) in the SCStatefulImgConfig object. In this case the system will back off to using one of the state image entries that has been explicitly provided, according to the following rules:

State(s)	Stateful image attributes to consider (in order of preference)
Focused and Selected	If both focused and selected states are applied, the system will use the first (populated) value from the following attribute list: "FocusedSelected" "Focused" "Selected"
Over or Down in combination with Focused / Selected	System will check for a combined state attribute with the Focused / Selected state first. For example for Focused + Selected + Over, consider the following attributes: "FocusedSelectedOver" "FocusedOver" "SelectedOver" If no combined state entry is specified, back off to considering just the Focused / Selected state: "FocusedSelected" "Focused" "Selected" If no focused / selected state entry is present in the config object, look for an entry for the unmodified state name "Over"
All other states, including Disabled (in combination with Focused / Selected)	Check for a combined state attribute with the Focused / Selected state first. For example for Focused + Selected + "CustomState", consider the following attributes: "FocusedSelectedCustomState" "FocusedCustomState" "SelectedCustomState" If no combined state entry is specified, back off to considering just the unmodified state name "CustomState" If there is no explicit entry for the state name, use the Focused / Selected state without a state name: "FocusedSelected" "Focused" "Selected"

If no entry can be found for the specified state / combined states using the above approach, the "_base" attribute will be used.

Field Summary

Fields inherited from class com.smartgwt.client.core.DataClass

factoryCreated, factoryProperties

Fields inherited from class com.smartgwt.client.core.JsObject

jsObj

Constructor Summary

Constructors

Constructor and Description
SCStatefulImgConfig()
SCStatefulImgConfig(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Summary

Modifier and Type	Method and Description
java.lang.String	get_base() The base filename for the image.
java.lang.String	getDisabled() Image to display when the component is disabled.
java.lang.String	getDown() Image to display on mouseDown.
java.lang.String	getFocused() Image to display when the component is focused.
java.lang.String	getFocusedDown() Image to display when the component is focused on mouse down.
java.lang.String	getFocusedOver() Image to display when the component is focused on roll over.
static SCStatefulImgConfig	getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
java.lang.String	getOver() Image to display on roll over.
java.lang.String	getSelected() Image to display when the component is selected.
java.lang.String	getSelectedDisabled() Image to display when the component is selected and disabled.
java.lang.String	getSelectedDown() Image to display when the component is selected on mouse down.
java.lang.String	getSelectedFocused() Image to display when the component is selected and focused.
java.lang.String	getSelectedFocusedDown() Image to display when the component is selected and focused on mouse down.
java.lang.String	getSelectedFocusedOver() Image to display when the component is selected and focused on roll over.
java.lang.String	getSelectedOver() Image to display when the component is selected on roll over.
SCStatefulImgConfig	set_base(java.lang.String _base) The base filename for the image.
SCStatefulImgConfig	setDisabled(java.lang.String Disabled) Image to display when the component is disabled.
SCStatefulImgConfig	setDown(java.lang.String Down) Image to display on mouseDown.
SCStatefulImgConfig	setFocused(java.lang.String Focused) Image to display when the component is focused.
SCStatefulImgConfig	setFocusedDown(java.lang.String FocusedDown) Image to display when the component is focused on mouse down.
SCStatefulImgConfig	setFocusedOver(java.lang.String FocusedOver) Image to display when the component is focused on roll over.
SCStatefulImgConfig	setOver(java.lang.String Over) Image to display on roll over.
SCStatefulImgConfig	setSelected(java.lang.String Selected) Image to display when the component is selected.
SCStatefulImgConfig	setSelectedDisabled(java.lang.String SelectedDisabled) Image to display when the component is selected and disabled.
SCStatefulImgConfig	setSelectedDown(java.lang.String SelectedDown) Image to display when the component is selected on mouse down.
SCStatefulImgConfig	setSelectedFocused(java.lang.String SelectedFocused) Image to display when the component is selected and focused.
SCStatefulImgConfig	setSelectedFocusedDown(java.lang.String SelectedFocusedDown) Image to display when the component is selected and focused on mouse down.
SCStatefulImgConfig	setSelectedFocusedOver(java.lang.String SelectedFocusedOver) Image to display when the component is selected and focused on roll over.
SCStatefulImgConfig	setSelectedOver(java.lang.String SelectedOver) Image to display when the component is selected on roll over.

Methods inherited from class com.smartgwt.client.core.DataClass

applyFactoryProperties, doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsElement, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, isFactoryCreated, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreated

Methods inherited from class com.smartgwt.client.core.JsObject

equals, getJsObj, hashCode, isCreated, setJavaScriptObject, setJsObj

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SCStatefulImgConfig

public SCStatefulImgConfig()

SCStatefulImgConfig

public SCStatefulImgConfig(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Detail

getOrCreateRef

public static SCStatefulImgConfig getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)

set_base

public SCStatefulImgConfig set_base(java.lang.String _base)

The base filename for the image. This will be used if no state is applied to the stateful component displaying this image, or if no explicit entry exists for a state that is applied.
It will also be used as a base file name for entries specified using the "#modifier:some_value" format.

In some cases, an icon may have only custom states - for example, a tree-folder icon is always either opened or closed, so a _base entry is not required unless entries in the object use the #state or #modifier components - in this case, a warning will be logged if no _base is set.

See SCStatefulImgConfig overview for further information.

Parameters:

_base - New _base value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

See Also:

SCImgURL

get_base

public java.lang.String get_base()

The base filename for the image. This will be used if no state is applied to the stateful component displaying this image, or if no explicit entry exists for a state that is applied.
It will also be used as a base file name for entries specified using the "#modifier:some_value" format.

In some cases, an icon may have only custom states - for example, a tree-folder icon is always either opened or closed, so a _base entry is not required unless entries in the object use the #state or #modifier components - in this case, a warning will be logged if no _base is set.

See SCStatefulImgConfig overview for further information.

Returns:

Current _base value. Default value is null

See Also:

SCImgURL

setDisabled

public SCStatefulImgConfig setDisabled(java.lang.String Disabled)

Image to display when the component is disabled.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

Disabled - New Disabled value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getDisabled

public java.lang.String getDisabled()

Image to display when the component is disabled.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current Disabled value. Default value is null

setDown

public SCStatefulImgConfig setDown(java.lang.String Down)

Image to display on mouseDown.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

Down - New Down value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getDown

public java.lang.String getDown()

Image to display on mouseDown.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current Down value. Default value is null

setFocused

public SCStatefulImgConfig setFocused(java.lang.String Focused)

Image to display when the component is focused.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

Focused - New Focused value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getFocused

public java.lang.String getFocused()

Image to display when the component is focused.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current Focused value. Default value is null

setFocusedDown

public SCStatefulImgConfig setFocusedDown(java.lang.String FocusedDown)

Image to display when the component is focused on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

FocusedDown - New FocusedDown value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getFocusedDown

public java.lang.String getFocusedDown()

Image to display when the component is focused on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current FocusedDown value. Default value is null

setFocusedOver

public SCStatefulImgConfig setFocusedOver(java.lang.String FocusedOver)

Image to display when the component is focused on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

FocusedOver - New FocusedOver value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getFocusedOver

public java.lang.String getFocusedOver()

Image to display when the component is focused on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current FocusedOver value. Default value is null

setOver

public SCStatefulImgConfig setOver(java.lang.String Over)

Image to display on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

Over - New Over value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getOver

public java.lang.String getOver()

Image to display on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current Over value. Default value is null

setSelected

public SCStatefulImgConfig setSelected(java.lang.String Selected)

Image to display when the component is selected.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

Selected - New Selected value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelected

public java.lang.String getSelected()

Image to display when the component is selected.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current Selected value. Default value is null

setSelectedDisabled

public SCStatefulImgConfig setSelectedDisabled(java.lang.String SelectedDisabled)

Image to display when the component is selected and disabled.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedDisabled - New SelectedDisabled value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedDisabled

public java.lang.String getSelectedDisabled()

Image to display when the component is selected and disabled.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedDisabled value. Default value is null

setSelectedDown

public SCStatefulImgConfig setSelectedDown(java.lang.String SelectedDown)

Image to display when the component is selected on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedDown - New SelectedDown value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedDown

public java.lang.String getSelectedDown()

Image to display when the component is selected on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedDown value. Default value is null

setSelectedFocused

public SCStatefulImgConfig setSelectedFocused(java.lang.String SelectedFocused)

Image to display when the component is selected and focused.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedFocused - New SelectedFocused value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedFocused

public java.lang.String getSelectedFocused()

Image to display when the component is selected and focused.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedFocused value. Default value is null

setSelectedFocusedDown

public SCStatefulImgConfig setSelectedFocusedDown(java.lang.String SelectedFocusedDown)

Image to display when the component is selected and focused on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedFocusedDown - New SelectedFocusedDown value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedFocusedDown

public java.lang.String getSelectedFocusedDown()

Image to display when the component is selected and focused on mouse down.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedFocusedDown value. Default value is null

setSelectedFocusedOver

public SCStatefulImgConfig setSelectedFocusedOver(java.lang.String SelectedFocusedOver)

Image to display when the component is selected and focused on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedFocusedOver - New SelectedFocusedOver value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedFocusedOver

public java.lang.String getSelectedFocusedOver()

Image to display when the component is selected and focused on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedFocusedOver value. Default value is null

setSelectedOver

public SCStatefulImgConfig setSelectedOver(java.lang.String SelectedOver)

Image to display when the component is selected on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Parameters:

SelectedOver - New SelectedOver value. Default value is null

Returns:

SCStatefulImgConfig instance, for chaining setter calls

getSelectedOver

public java.lang.String getSelectedOver()

Image to display when the component is selected on roll over.

May be specified as

• A SCImgURL indicating the media to load
• A reference to another entry in this SCStatefulImgConfig via the format "#state:otherStateName"
• A modifier to apply to the _base media via the format "#modifier:modifierString"

See SCStatefulImgConfig overview for further information.

Returns:

Current SelectedOver value. Default value is null