com.smartgwt.client.widgets.layout
Class SectionStackSection

java.lang.Object
  com.smartgwt.client.core.JsObject
      com.smartgwt.client.core.DataClass
          com.smartgwt.client.core.RefDataClass
              com.smartgwt.client.widgets.layout.SectionStackSection

public class SectionStackSection
extends RefDataClass

Section descriptor used by a SectionStack to describe a section of items which are shown or hidden together, and their associated header.

Field Summary

protected SectionStack

stack Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the SectionStack in which this section header is embedded.

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

jsObj

Constructor Summary

SectionStackSection()

SectionStackSection(JavaScriptObject jsObj)

SectionStackSection(String title)

Method Summary

void	addItem(Canvas item)
Boolean	getCanTabToHeader() If true, the header for this Section will be included in the page's tab order for accessibility.
Canvas[]	getControls()
String	getID() Optional ID for the section.
Canvas[]	getItems() Return the items in this SectionStackSection
String	getName() Identifier for the section.
static SectionStackSection	getOrCreateRef(JavaScriptObject jsObj)
SectionHeader	getSectionHeader() Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the SectionHeader for this section
SectionStack	getSectionStack()
String	getTitle() Title to show for the section
void	setCanCollapse(Boolean canCollapse) This attribute controls whether or not the expand/collapse UI control is shown on the header of this section.
void	setCanDropBefore(Boolean canDropBefore) When explicitly set to false, disallows drop before this member in the Layout.
void	setCanReorder(Boolean canReorder) If set to false, then this sectionHeader will not be able to be dragged to perform a drag reorder, if canReorderSections is true.
void	setCanTabToHeader(Boolean canTabToHeader) If true, the header for this Section will be included in the page's tab order for accessibility.
void	setControls(Canvas... controls) Custom controls to be shown on top of this section header.
void	setExpanded(Boolean expanded) Sections default to the collapsed state unless showHeader is set to false in which case they default to the expanded state.
void	setHidden(Boolean hidden) Sections default to the visible state.
void	setID(String ID) Optional ID for the section.
void	setItems(Canvas... items) List of Canvases that constitute the section.
void	setName(String name) Identifier for the section.
void	setResizeable(Boolean resizeable) If set to false, then the items in this section will not be resized by sectionHeader repositioning.
void	setShowHeader(Boolean showHeader) If true, a header will be shown for this section.
void	setTitle(String title) Title to show for the section

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

getRef, getRef

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

doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, getJsObj, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute

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

isCreated, setJsObj

Methods inherited from class java.lang.Object

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

Field Detail

stack

protected SectionStack stack

Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the SectionStack in which this section header is embedded.

Constructor Detail

SectionStackSection

public SectionStackSection()

SectionStackSection

public SectionStackSection(JavaScriptObject jsObj)

SectionStackSection

public SectionStackSection(String title)

Method Detail

getOrCreateRef

public static SectionStackSection getOrCreateRef(JavaScriptObject jsObj)

setCanCollapse

public void setCanCollapse(Boolean canCollapse)

This attribute controls whether or not the expand/collapse UI control is shown on the header of this section. Any section can still be expanded/collapsed programmatically, regardless of this setting.

Parameters:

canCollapse - canCollapse Default value is true

See Also:

Expand / Collapse Example

setCanDropBefore

public void setCanDropBefore(Boolean canDropBefore)

When explicitly set to false, disallows drop before this member in the Layout.

Parameters:

canDropBefore - canDropBefore Default value is null

See Also:

Layout, LayoutMember overview and related methods

setCanReorder

public void setCanReorder(Boolean canReorder)

If set to false, then this sectionHeader will not be able to be dragged to perform a drag reorder, if canReorderSections is true. You can also disable dropping other sections before this one by setting canDropBefore to false.

Parameters:

canReorder - canReorder Default value is null

setCanTabToHeader

public void setCanTabToHeader(Boolean canTabToHeader)

If true, the header for this Section will be included in the page's tab order for accessibility. May also be set at the SectionStack level via canTabToHeaders.

See Accessibility.

Parameters:

canTabToHeader - canTabToHeader Default value is null

getCanTabToHeader

public Boolean getCanTabToHeader()

If true, the header for this Section will be included in the page's tab order for accessibility. May also be set at the SectionStack level via canTabToHeaders.

See Accessibility.

Returns:

Boolean

setID

public void setID(String ID)

Optional ID for the section. If useGlobalSectionIDs is true, this property will be applied to the generated SectionStackHeader widget as a standard widget ID, meaning it should be unique within a page.

Backcompat Note: Section stack sections may be uniquely identified within a stack via the name attribute (introduced in Jan 2010). Prior to this, the section ID attribute was used in this way (and would not be applied to the section header as a widget ID). For backwards compatibility this is still supported: If section.name is unspecified for a section but section.ID is set, the ID will be used as a default name attribute for the section. For backwards compatibility we also disable the standard behavior of having the section.ID being applied to the generated section header (thereby avoiding the page-level uniqueness requirement) by defaulting useGlobalSectionIDs to false.

Parameters:

ID - ID Default value is null

getID

public String getID()

Optional ID for the section. If useGlobalSectionIDs is true, this property will be applied to the generated SectionStackHeader widget as a standard widget ID, meaning it should be unique within a page.

Backcompat Note: Section stack sections may be uniquely identified within a stack via the name attribute (introduced in Jan 2010). Prior to this, the section ID attribute was used in this way (and would not be applied to the section header as a widget ID). For backwards compatibility this is still supported: If section.name is unspecified for a section but section.ID is set, the ID will be used as a default name attribute for the section. For backwards compatibility we also disable the standard behavior of having the section.ID being applied to the generated section header (thereby avoiding the page-level uniqueness requirement) by defaulting useGlobalSectionIDs to false.

Returns:

String

setName

public void setName(String name)

Identifier for the section. This can be used later in calls to SectionStack APIs such as SectionStack.expandSection and SectionStack.collapseSection. Note that if no name is specified for the section, one will be auto-generated when the section is created. This property should be a string which may be used as a valid JavaScript identifier (should start with a letter and not contain space or special characters such as "*").

Parameters:

name - name Default value is null

getName

public String getName()

Identifier for the section. This can be used later in calls to SectionStack APIs such as SectionStack.expandSection and SectionStack.collapseSection. Note that if no name is specified for the section, one will be auto-generated when the section is created. This property should be a string which may be used as a valid JavaScript identifier (should start with a letter and not contain space or special characters such as "*").

Returns:

String

setResizeable

public void setResizeable(Boolean resizeable)

If set to false, then the items in this section will not be resized by sectionHeader repositioning. You may also set this flag directly on any of the items in any section to cause that item to not be resizeable.

Parameters:

resizeable - resizeable Default value is null

See Also:

Resize Sections Example

setShowHeader

public void setShowHeader(Boolean showHeader)

If true, a header will be shown for this section. If false, no header will be shown.

Parameters:

showHeader - showHeader Default value is true

setTitle

public void setTitle(String title)

Title to show for the section

Parameters:

title - title Default value is null

getTitle

public String getTitle()

Title to show for the section

Returns:

String

setExpanded

public void setExpanded(Boolean expanded)

Sections default to the collapsed state unless showHeader is set to false in which case they default to the expanded state. This attribute allows you to explicitly control the expand/collapse state of the section by overriding the above default behavior.

Parameters:

expanded - expanded Default value is false

setHidden

public void setHidden(Boolean hidden)

Sections default to the visible state. This attribute allows you to explicitly control the visible/hidden state of the section by overriding the above default behavior.

Parameters:

hidden - hidden Default value is false

setItems

public void setItems(Canvas... items)

List of Canvases that constitute the section. These Canvases will be shown and hidden together.

Parameters:

items - list of Canvases that constitute the section

getItems

public Canvas[] getItems()

Return the items in this SectionStackSection

Returns:

the items in this SectionStackSection

addItem

public void addItem(Canvas item)

setControls

public void setControls(Canvas... controls)

Custom controls to be shown on top of this section header.

Parameters:

controls -

getControls

public Canvas[] getControls()

getSectionStack

public SectionStack getSectionStack()

getSectionHeader

public SectionHeader getSectionHeader()

Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the SectionHeader for this section

Returns:

the SectionHeader for the section