com.ebasetech.xi.api.controls
Interface TitlePanelControl

All Superinterfaces:

ContainerControl, Control, Element, EventOwner, LayoutControl, MarginStyleProperties, MessageContainer, MessageProperties, java.io.Serializable, WebFormEventOwner

public interface TitlePanelControl
extends LayoutControl, MarginStyleProperties

A Titled Panel Control is a container control with a title bar and border, where the title bar can contain a text and/or an image. The control has options to display rounded, square or slashed corners.

Further documentation.

Method Summary

java.lang.String	getContentHeight() Height of the content area.
PaddingStyleProperties	getContentPadding() Padding properties for the content area - the space between the content area and its border.
TextStyleProperties	getContentText() Text properties for the content area.
Text	getImageAltText() Returns the Text object for the title bar image alternatetext.
java.lang.String	getImageClass() Returns the list of CSS classes applied to the title bar image.
Text	getImageMouseOverText() Returns the Text object for the title bar image mouse over text.
java.lang.String	getImagePosition() The position of the optional image relative to the text.
ImageStyleProperties	getImageProperties() Styling properties for the optional image in the title bar.
java.lang.String	getImageStyle() Returns the inline CSS style applied to the title bar image.
java.lang.String	getImageURL() Returns the URL of the title bar image.
java.lang.String	getPanelClass() Returns the list of CSS classes applied to the content area.
java.lang.String	getPanelColor() The background color for the content area.
java.lang.String	getPanelCornerType() The style of corner applied to the bottom left and bottom right corners.
java.lang.String	getPanelStyle() Returns the inline CSS style applied to the content area.
Text	getText() Returns the Text object for the title bar text.
java.lang.String	getTextClass() Returns the list of CSS classes applied to the title bar text.
java.lang.String	getTextImageGap() The gap between the title text and any optional image.
java.lang.String	getTextStyle() Returns the inline CSS style applied to the title bar text.
java.lang.String	getTitlebarClass() Returns the list of CSS classes applied to the entire title bar.
java.lang.String	getTitlebarColor() The background color for the title bar.
java.lang.String	getTitlebarCornerType() The style of corner applied to the top left and top right corners.
java.lang.String	getTitlebarStyle() Returns the inline CSS style applied to the entire title bar.
TitleBarProperties	getTitleBarStyle() Styling properties for the title bar.
java.lang.String	getTitlePanelBorderColor() Returns the color applied to the border surrounding the control, including the corners.
java.lang.String	getWidth() Titled Panel Control width.
void	setContentHeight(java.lang.String contentHeight) Sets the content area height.
void	setImageClass(java.lang.String imageClass) Sets one or more CSS classes to be applied to the title bar image.
void	setImagePosition(java.lang.String imagePosition) Sets the position of the optional image relative to the text.
void	setImageStyle(java.lang.String imageStyle) Sets the inline CSS style to be applied to the title bar image.
void	setImageURL(java.lang.String imageURL) Sets the URL of the title bar image.
void	setPanelClass(java.lang.String panelClass) Sets one or more CSS classes to be applied to the content area.
void	setPanelColor(java.lang.String panelColor) Sets the background color for the content area.
void	setPanelCornerType(java.lang.String panelCornerType) Sets the style of corner applied to the bottom left and bottom right corners.
void	setPanelStyle(java.lang.String panelStyle) Sets the inline CSS style to be applied to the content area.
void	setTextClass(java.lang.String textClass) Sets one or more CSS classes to be applied to the title bar text.
void	setTextImageGap(java.lang.String textImageGap) Sets the gap between the title text and any optional image.
void	setTextStyle(java.lang.String textStyle) Sets the inline CSS style to be applied to the title bar text.
void	setTitlebarClass(java.lang.String titlebarClass) Sets one or more CSS classes to be applied to the entire title bar.
void	setTitlebarColor(java.lang.String titlebarColor) Sets the background color for the title bar.
void	setTitlebarCornerType(java.lang.String titlebarCornerType) Sets the style of corner applied to the top left and top right corners.
void	setTitlebarStyle(java.lang.String titlebarStyle) Sets the inline CSS style to be applied to the entire title bar.
void	setTitlePanelBorderColor(java.lang.String titlePanelBorderColor) Sets the color applied to the border surrounding the control, including the corners.
void	setWidth(java.lang.String width) Sets the width of the Titled Panel Control.

Methods inherited from interface com.ebasetech.xi.api.controls.LayoutControl

getLayout, getLayoutType

Methods inherited from interface com.ebasetech.xi.api.controls.ContainerControl

getChildControls

Methods inherited from interface com.ebasetech.xi.api.controls.Control

getAll, getCssClass, getErrorMsgClass, getErrorMsgStyle, getLayoutCell, getNextSiblingControl, getPage, getParentControl, getPreviousSiblingControl, getStyle, getWarningMsgClass, getWarningMsgStyle, hasModifier, hide, isDisplayOnly, isDisplayOnlyIncludingParents, isEventField, isHidden, isInheritMsg, isLocalMsg, isNewLine, isShowing, refresh, requestFocus, setCssClass, setDisplayOnly, setErrorMsgClass, setErrorMsgStyle, setHidden, setNewLine, setStyle, setWarningMsgClass, setWarningMsgStyle, show

Methods inherited from interface com.ebasetech.xi.api.Element

getElementName, getElementType

Methods inherited from interface com.ebasetech.xi.api.MessageContainer

addErrorMessage, addErrorMessage, addErrorMessage, addErrorMessage, addErrorMessage, addWarningMessage, addWarningMessage, addWarningMessage, addWarningMessage, addWarningMessage, existErrorMessages, existMessages, existWarningMessages

Methods inherited from interface com.ebasetech.xi.api.controls.MessageProperties

getErrorMessageStyle, getWarningMessageStyle

Methods inherited from interface com.ebasetech.xi.api.controls.MarginStyleProperties

getAllMargin, getBottomMargin, getLeftMargin, getRightMargin, getTopMargin, setAllMargin, setBottomMargin, setLeftMargin, setRightMargin, setTopMargin

Method Detail

getWidth

java.lang.String getWidth()

Titled Panel Control width. See setWidth(String) for details of supported values when setting this property.

Since:

V4.4

setWidth

void setWidth(java.lang.String width)

Sets the width of the Titled Panel Control.

Supported values:

Value	Description
A specific value	As per the CSS width property e.g. 300px
Child	The minimum value: this results in the Titled Panel Control being just as wide as it needs to be to accommodate its children.

The width setting will be ignored if the parent container layout specifies a horizontal cell alignment of fill (this applies to Horizontal Box, Vertical Box and Column layouts).

Warning: when a specific value is set, any padding, border or margins will be in addition to the specified value and can cause the Titled Panel Control to "break out" of its parent space.

Examples:

 controls.TITLEPANEL1.width = "300px";
 controls.TITLEPANEL1.width = "50%";
 controls.TITLEPANEL1.setWidth("Child");
 

Since:

V4.4

getTitlePanelBorderColor

java.lang.String getTitlePanelBorderColor()

Returns the color applied to the border surrounding the control, including the corners. See setTitlePanelBorderColor(String) for details of supported values when setting this property.

Since:

V4.4

setTitlePanelBorderColor

void setTitlePanelBorderColor(java.lang.String titlePanelBorderColor)

Sets the color applied to the border surrounding the control, including the corners. Any valid value for the CSS color property can be used. Setting this property to null removes any existing value. Note that any inherited value from a parent control may still apply.

Examples:

 controls.TITLEPANEL1.titlePanelBorderColor = "#808080";
 controls.TITLEPANEL1.titlePanelBorderColor("green");
 

Since:

V4.4

getTitlebarCornerType

java.lang.String getTitlebarCornerType()

The style of corner applied to the top left and top right corners. See setTitlebarCornerType(String) for details of supported values when setting this property.

Since:

V4.4

See Also:

getPanelCornerType()

setTitlebarCornerType

void setTitlebarCornerType(java.lang.String titlebarCornerType)

Sets the style of corner applied to the top left and top right corners.

Supported values:

Value	Description
Rounded	Corners are drawn with a rounded image
Square	Corners are square
Slash	Corners are a straight diagonal line

Examples:

 controls.TITLEPANEL1.titlebarCornerType = "Rounded";
 controls.TITLEPANEL1.titlebarCornerType("Square");
 

Since:

V4.4

See Also:

setPanelCornerType(String)

getTitlebarColor

java.lang.String getTitlebarColor()

The background color for the title bar. See setTitlebarColor(String) for details of supported values when setting this property.

Since:

V4.4

setTitlebarColor

void setTitlebarColor(java.lang.String titlebarColor)

Sets the background color for the title bar. Any valid value for the CSS color property can be used.

Examples:

 controls.TITLEPANEL1.titlebarColor = "#808080";
 

Since:

V4.4

getTextImageGap

java.lang.String getTextImageGap()

The gap between the title text and any optional image. See setTextImageGap(String) for details of supported values when setting this property.

Further documentation.

Since:

V4.4

setTextImageGap

void setTextImageGap(java.lang.String textImageGap)

Sets the gap between the title text and any optional image. Any valid value for the CSS font-size property can be used.

Further documentation.

Examples:

 controls.TITLEPANEL1.textImageGap = "30px";
 

Since:

V4.4

getImagePosition

java.lang.String getImagePosition()

The position of the optional image relative to the text. See setImagePosition(String) for details of supported values when setting this property.

Further documentation.

Since:

V4.4

setImagePosition

void setImagePosition(java.lang.String imagePosition)

Sets the position of the optional image relative to the text.

Supported values:

Value	Description
Left	Image is positioned to the left of the text
Right	Image is positioned to the right of the text
None	No image will be displayed

Further documentation.

Examples:

 controls.TITLEPANEL1.imagePosition = "Left";
 

Since:

V4.4

getTitleBarStyle

TitleBarProperties getTitleBarStyle()

Styling properties for the title bar.

Further documentation.

Since:

V4.4

getImageProperties

ImageStyleProperties getImageProperties()

Styling properties for the optional image in the title bar.

Further documentation.

Since:

V4.4

getPanelCornerType

java.lang.String getPanelCornerType()

The style of corner applied to the bottom left and bottom right corners. See setPanelCornerType(String) for details of supported values when setting this property.

Since:

V4.4

See Also:

getTitlebarCornerType()

setPanelCornerType

void setPanelCornerType(java.lang.String panelCornerType)

Sets the style of corner applied to the bottom left and bottom right corners.

Supported values:

Value	Description
Rounded	Corners are drawn with a rounded image
Square	Corners are square
Slash	Corners are a straight diagonal line

Examples:

 controls.TITLEPANEL1.panelCornerType = "Rounded";
 controls.TITLEPANEL1.panelCornerType("Square");
 

Since:

V4.4

See Also:

setTitlebarCornerType(String)

getPanelColor

java.lang.String getPanelColor()

The background color for the content area. See setPanelColor(String) for details of supported values when setting this property.

Since:

V4.4

setPanelColor

void setPanelColor(java.lang.String panelColor)

Sets the background color for the content area. Any valid value for the CSS color property can be used.

Examples:

 controls.TITLEPANEL1.panelColor = "#808080";
 

Since:

V4.4

getContentHeight

java.lang.String getContentHeight()

Height of the content area. See setContentHeight(String) for details of supported values when setting this property.

Since:

V4.4

setContentHeight

void setContentHeight(java.lang.String contentHeight)

Sets the content area height.

Any valid value for the CSS height property can be specified e.g. 300px

Since:

V4.4

getContentPadding

PaddingStyleProperties getContentPadding()

Padding properties for the content area - the space between the content area and its border.

Since:

V4.4

getContentText

TextStyleProperties getContentText()

Text properties for the content area.

Since:

V4.4

getText

Text getText()

Returns the Text object for the title bar text.

Since:

V4.4

getTextClass

java.lang.String getTextClass()

Returns the list of CSS classes applied to the title bar text.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setTextClass(String)

setTextClass

void setTextClass(java.lang.String textClass)

Sets one or more CSS classes to be applied to the title bar text. Multiple classes are specified by using a space between the class names, as per the HTML class parameter.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getTextStyle

java.lang.String getTextStyle()

Returns the inline CSS style applied to the title bar text.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setTextStyle(String)

setTextStyle

void setTextStyle(java.lang.String textStyle)

Sets the inline CSS style to be applied to the title bar text. Style is entered as for the HTML style parameter.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getImageURL

java.lang.String getImageURL()

Returns the URL of the title bar image. The URL can be either relative or absolute.

Further documentation.

Since:

V4.4

setImageURL

void setImageURL(java.lang.String imageURL)

Sets the URL of the title bar image. The URL can be either relative or absolute. When absolute, is should start with the protocol e.g. http://www.google.com.

Further documentation.

Since:

V4.4

getImageMouseOverText

Text getImageMouseOverText()

Returns the Text object for the title bar image mouse over text.

Since:

V4.4

getImageAltText

Text getImageAltText()

Returns the Text object for the title bar image alternatetext.

Since:

V4.4

getImageClass

java.lang.String getImageClass()

Returns the list of CSS classes applied to the title bar image.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setImageClass(String)

setImageClass

void setImageClass(java.lang.String imageClass)

Sets one or more CSS classes to be applied to the title bar image. Multiple classes are specified by using a space between the class names, as per the HTML class parameter.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getImageStyle

java.lang.String getImageStyle()

Returns the inline CSS style applied to the title bar image.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setImageStyle(String)

setImageStyle

void setImageStyle(java.lang.String imageStyle)

Sets the inline CSS style to be applied to the title bar image. Style is entered as for the HTML style parameter.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getPanelClass

java.lang.String getPanelClass()

Returns the list of CSS classes applied to the content area.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setPanelClass(String)

setPanelClass

void setPanelClass(java.lang.String panelClass)

Sets one or more CSS classes to be applied to the content area. Multiple classes are specified by using a space between the class names, as per the HTML class parameter.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getPanelStyle

java.lang.String getPanelStyle()

Returns the inline CSS style applied to the content area.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setPanelStyle(String)

setPanelStyle

void setPanelStyle(java.lang.String panelStyle)

Sets the inline CSS style to be applied to the content area. Style is entered as for the HTML style parameter.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getTitlebarClass

java.lang.String getTitlebarClass()

Returns the list of CSS classes applied to the entire title bar.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setTitlebarClass(String)

setTitlebarClass

void setTitlebarClass(java.lang.String titlebarClass)

Sets one or more CSS classes to be applied to the entire title bar. Multiple classes are specified by using a space between the class names, as per the HTML class parameter.

These classes are configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

getTitlebarStyle

java.lang.String getTitlebarStyle()

Returns the inline CSS style applied to the entire title bar.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4

See Also:

setTitlebarStyle(String)

setTitlebarStyle

void setTitlebarStyle(java.lang.String titlebarStyle)

Sets the inline CSS style to be applied to the entire title bar. Style is entered as for the HTML style parameter.

This inline style is configured in the designer using the Advanced Properties button within the control's Styling Assistant.

Since:

V4.4