MainControl

Main Control

A general purpose container that wraps content in a main tag:

  <main>
  .. child controls
  </main>
  
Further documentation.

BasicBlockControl Functions

getHeight MainControl.getHeight( ) Panel height.
setHeight MainControl.setHeight( height ) Sets the panel height, and is equivalent to the CSS height property and any valid value for this CSS property can be used.
getWidth MainControl.getWidth( ) Panel width.
setWidth MainControl.setWidth( width ) Sets the panel width.

AriaControlProperties Functions

addAriaCustomAttribute MainControl.addAriaCustomAttribute( name , value ) Add an ARIA custom attribute with a specified name and value.
getAriaCustomAttributes MainControl.getAriaCustomAttributes( ) Returns a comma separated list of the ARIA custom attributes for the control.
setAriaCustomAttributes MainControl.setAriaCustomAttributes( ariaCustomAttributes ) Sets the ARIA custom attributes as a comma separated list associated with the control property and overrides the aria custom attributes value.
getAriaDescribedBy MainControl.getAriaDescribedBy( ) Returns the ARIA described-by element ID for the control.
getAriaLabelledBy MainControl.getAriaLabelledBy( ) Returns the ARIA labelled-by element ID for the control.
getAriaLabelText MainControl.getAriaLabelText( ) Returns the com.ebasetech.xi.api.Text object for the ARIA label text.
getAriaRole MainControl.getAriaRole( ) Returns the ARIA role for the control.
setAriaRole MainControl.setAriaRole( role ) Sets the ARIA role for the control.
removeAriaCustomAttribute MainControl.removeAriaCustomAttribute( name ) Remove an ARIA custom attribute specified by name.

BackgroundStyleProperties Functions

getBackgroundColor MainControl.getBackgroundColor( ) Background color.
setBackgroundColor MainControl.setBackgroundColor( backgroundColor ) Sets the background color, this is equivalent to the CSS background-color property and any valid value for this CSS property can be used.
getBackgroundImage MainControl.getBackgroundImage( ) URL of the background image.
setBackgroundImage MainControl.setBackgroundImage( backgroundImage ) Sets the URL of the background image.
getBackgroundImagePosition MainControl.getBackgroundImagePosition( ) Background image position.
setBackgroundImagePosition MainControl.setBackgroundImagePosition( backgroundImagePosition ) Sets the background image position.
getBackgroundImageRepeat MainControl.getBackgroundImageRepeat( ) Background image repeat property.
setBackgroundImageRepeat MainControl.setBackgroundImageRepeat( backgroundImageRepeat ) Sets the background image repeat property.

BorderStyleProperties Functions

getBorderColor MainControl.getBorderColor( ) Border color applied to all borders.
setBorderColor MainControl.setBorderColor( borderColor ) Sets border color.
getBorderRadius MainControl.getBorderRadius( ) Border radius.
setBorderRadius MainControl.setBorderRadius( borderRadius ) Sets border radius.
getBorderStyle MainControl.getBorderStyle( ) Border style applied to all borders.
setBorderStyle MainControl.setBorderStyle( borderStyle ) Sets border style.
getBorderWidth MainControl.getBorderWidth( ) Border width applied to all four borders.
setBorderWidth MainControl.setBorderWidth( borderWidth ) Sets the border width applied to all four borders.
getBottomBorderWidth MainControl.getBottomBorderWidth( ) Bottom border width, overriding property borderWidth.
setBottomBorderWidth MainControl.setBottomBorderWidth( bottomBorderWidth ) Sets the bottom border width, overriding property borderWidth.
getLeftBorderWidth MainControl.getLeftBorderWidth( ) Left border width, overriding property borderWidth.
setLeftBorderWidth MainControl.setLeftBorderWidth( leftBorderWidth ) Sets the left border width, overriding property borderWidth.
getRightBorderWidth MainControl.getRightBorderWidth( ) Right border width, overriding property borderWidth.
setRightBorderWidth MainControl.setRightBorderWidth( rightBorderWidth ) Sets the right border width, overriding property borderWidth.
getTopBorderWidth MainControl.getTopBorderWidth( ) Top border width, overriding property borderWidth.
setTopBorderWidth MainControl.setTopBorderWidth( topBorderWidth ) Sets the top border width, overriding property borderWidth.

LayoutControl Functions

getLayout MainControl.getLayout( ) Returns the Layout object configured for the container control or null if no layout is configured.
getLayoutType MainControl.getLayoutType( ) Returns a String representing the layout type for the container.

MarginStyleProperties Functions

getAllMargin MainControl.getAllMargin( ) Single MarginStyleProperties size value used for top, bottom, left and right margin.
setAllMargin MainControl.setAllMargin( allMargin ) Sets the MarginStyleProperties size value used for top, bottom, left and right margin.
getBottomMargin MainControl.getBottomMargin( ) Bottom MarginStyleProperties size value.
setBottomMargin MainControl.setBottomMargin( bottomMargin ) Sets the bottom MarginStyleProperties size value.
getLeftMargin MainControl.getLeftMargin( ) Left MarginStyleProperties size value.
setLeftMargin MainControl.setLeftMargin( leftMargin ) Sets the left MarginStyleProperties size value.
getRightMargin MainControl.getRightMargin( ) Right MarginStyleProperties size value.
setRightMargin MainControl.setRightMargin( rightMargin ) Sets the right MarginStyleProperties size value.
getTopMargin MainControl.getTopMargin( ) Top MarginStyleProperties size value.
setTopMargin MainControl.setTopMargin( topMargin ) Sets the top MarginStyleProperties size value.

PaddingStyleProperties Functions

getAllPadding MainControl.getAllPadding( ) Single PaddingStyleProperties size value used for top, bottom, left and right padding.
setAllPadding MainControl.setAllPadding( allPadding ) Sets the PaddingStyleProperties size value used for top, bottom, left and right padding.
getBottomPadding MainControl.getBottomPadding( ) Bottom PaddingStyleProperties size value.
setBottomPadding MainControl.setBottomPadding( bottomPadding ) Sets the bottom PaddingStyleProperties size value.
getLeftPadding MainControl.getLeftPadding( ) Left PaddingStyleProperties size value.
setLeftPadding MainControl.setLeftPadding( leftPadding ) Sets the left PaddingStyleProperties size value.
getRightPadding MainControl.getRightPadding( ) Right PaddingStyleProperties size value.
setRightPadding MainControl.setRightPadding( rightPadding ) Sets the right PaddingStyleProperties size value.
getTopPadding MainControl.getTopPadding( ) Top PaddingStyleProperties size value.
setTopPadding MainControl.setTopPadding( topPadding ) Sets the top PaddingStyleProperties size value.

TextStyleProperties Functions

getLineHeight MainControl.getLineHeight( ) Line height.
setLineHeight MainControl.setLineHeight( lineHeight ) Sets the line height, this is equivalent to the CSS line-height property and any valid value for this CSS property can be used.
getTextBold MainControl.getTextBold( ) Text bold setting.
setTextBold MainControl.setTextBold( textBold ) Sets the text bold setting.
getTextColor MainControl.getTextColor( ) Text color.
setTextColor MainControl.setTextColor( textColor ) Sets the text color, this is equivalent to the CSS color property and any valid value for this CSS property can be used.
getTextDecoration MainControl.getTextDecoration( ) Text decoration property (shown as Lines in the designer).
setTextDecoration MainControl.setTextDecoration( textDecoration ) Sets the text decoration property (shown as Lines in the designer).
getTextFont MainControl.getTextFont( ) List of text fonts.
setTextFont MainControl.setTextFont( textFont ) Sets the list of text fonts, this is equivalent to the CSS font-family property and any valid value for this CSS property can be used.
getTextItalic MainControl.getTextItalic( ) Text italic setting.
setTextItalic MainControl.setTextItalic( textItalic ) Sets the text italic setting.
getTextSize MainControl.getTextSize( ) Text size.
setTextSize MainControl.setTextSize( textSize ) Sets the text size, this is equivalent to the CSS font-size property and any valid value for this CSS property can be used.

ContainerControl Functions

getChildControls MainControl.getChildControls( ) Returns an array of controls that are immediate children of this control.

MessageProperties Functions

getErrorMessageStyle MainControl.getErrorMessageStyle( ) Returns the MessageStyleProperties object representing error message styling properties.
getInfoMessageStyle MainControl.getInfoMessageStyle( ) Returns the MessageStyleProperties object representing info message styling properties.
getWarningMessageStyle MainControl.getWarningMessageStyle( ) Returns the MessageStyleProperties object representing warning message styling properties.

Control Functions

addCssClass MainControl.addCssClass( cssClass ) Adds one or more CSS classes to the list of classes applied to the control, retaining any existing classes.
getAll MainControl.getAll( ) Returns a control object of the same type as the control object on which this method is invoked, that gives access to all occurrences of this control on the page.
isContainer MainControl.isContainer( ) Returns true if this control is a container control i.e.
getCssClass MainControl.getCssClass( ) Returns the list of CSS classes configured for the control.
setCssClass MainControl.setCssClass( cssClass ) Sets one or more CSS classes to be applied to the control.
isDisplayOnly MainControl.isDisplayOnly( ) Returns true if the control is marked as display only, otherwise returns false.
setDisplayOnly MainControl.setDisplayOnly( displayOnly ) Marks the control and all its children as display only (when displayOnly is true) or enterable (when displayOnly is false).
isDisplayOnlyIncludingParents MainControl.isDisplayOnlyIncludingParents( ) Returns true if the control or any of its parents is marked as display only, otherwise returns false.
getErrorMsgClass MainControl.getErrorMsgClass( ) Returns the list of CSS classes configured for error messages when the messages are displayed locally to the control.
setErrorMsgClass MainControl.setErrorMsgClass( errorMsgClass ) Sets one or more CSS classes to be applied to error messages when the messages are displayed locally to the control.
getErrorMsgStyle MainControl.getErrorMsgStyle( ) Returns the inline CSS style configured for error messages when the messages are displayed locally to the control.
setErrorMsgStyle MainControl.setErrorMsgStyle( errorMsgStyle ) Sets inline CSS style to be applied to error messages when the messages are displayed locally to the control.
isEventField MainControl.isEventField( ) Returns true if the control is an event field i.e.
hasModifier MainControl.hasModifier( modifier ) Returns true if the control has the specified modifier, otherwise returns false.
isHidden MainControl.isHidden( ) Returns true if the control is marked as hidden, otherwise returns false.
setHidden MainControl.setHidden( hidden ) Hides or shows the control and all its children.
hide MainControl.hide( ) Hides the control, this is equivalent to setting property hidden to true.
getInfoMsgClass MainControl.getInfoMsgClass( ) Returns the list of CSS classes configured for info messages when the messages are displayed locally to the control.
setInfoMsgClass MainControl.setInfoMsgClass( infoMsgClass ) Sets one or more CSS classes to be applied to info messages when the messages are displayed locally to the control.
getInfoMsgStyle MainControl.getInfoMsgStyle( ) Returns the inline CSS style configured for info messages when the messages are displayed locally to the control.
setInfoMsgStyle MainControl.setInfoMsgStyle( infoMsgStyle ) Sets inline CSS style to be applied to info messages when the messages are displayed locally to the control.
isInheritMsg MainControl.isInheritMsg( ) Returns true if Use parent control setting is checked in the Message Options properties for the control, otherwise returns false.
getLayoutCell MainControl.getLayoutCell( ) Returns the LayoutCell object which can be used to override properties of the parent control's layout as applied to this control.
isLocalMsg MainControl.isLocalMsg( ) Returns true if Local Message is checked in the Message Options properties for the control, otherwise returns false.
isNewLine MainControl.isNewLine( ) Returns the new line property.
setNewLine MainControl.setNewLine( newLine ) Sets or unsets the control's new line property.
getNextSiblingControl MainControl.getNextSiblingControl( ) Returns the control that appears after this control within the same parent, or null if no such control exists.
getPage MainControl.getPage( ) Returns the com.ebasetech.xi.api.Page where this control is located.
getParentControl MainControl.getParentControl( ) Returns this control's parent control or null if no such parent exists.
getPreviousSiblingControl MainControl.getPreviousSiblingControl( ) Returns the control that appears before this control within the same parent, or null if no such control exists.
refresh MainControl.refresh( ) Refreshes this control in the user's browser when the page is next displayed.
removeCssClass MainControl.removeCssClass( cssClass ) Removes one or more CSS classes from the control.
requestFocus MainControl.requestFocus( ) Sets the browser focus to the control.
getRootHtmlElementProperties MainControl.getRootHtmlElementProperties( ) Return the root com.ebasetech.xi.api.controls.HtmlElementProperties for the Control
show MainControl.show( ) Shows the control, this is equivalent to setting property hidden to false.
isShowing MainControl.isShowing( ) Returns true if the control will be included in the web page when it's next displayed to the user, otherwise returns false.
getStyle MainControl.getStyle( ) Returns the inline CSS style configured for the control.
setStyle MainControl.setStyle( style ) Sets inline CSS style to be applied to the control.
getWarningMsgClass MainControl.getWarningMsgClass( ) Returns the list of CSS classes configured for warning messages when the messages are displayed locally to the control.
setWarningMsgClass MainControl.setWarningMsgClass( warningMsgClass ) Sets one or more CSS classes to be applied to warning messages when the messages are displayed locally to the control.
getWarningMsgStyle MainControl.getWarningMsgStyle( ) Returns the inline CSS style configured for warning messages when the messages are displayed locally to the control.
setWarningMsgStyle MainControl.setWarningMsgStyle( warningMsgStyle ) Sets inline CSS style to be applied to warning messages when the messages are displayed locally to the control.

MessageContainer Functions

addErrorMessage MainControl.addErrorMessage( message [, stopProcessing ] ) Adds an error message that will be displayed to the user.
addErrorMessage MainControl.addErrorMessage( messageNo [, replaceParameters ] [, stopProcessing ] ) Adds an error message that will be displayed to the user.
addErrorMessageText MainControl.addErrorMessageText( text [, replaceParameters ] [, stopProcessing ] ) Adds an error message that will be displayed to the user, sourced from an existing text.
addInfoMessage MainControl.addInfoMessage( message [, stopProcessing ] ) Adds an information message that will be displayed to the user.
addInfoMessageText MainControl.addInfoMessageText( text [, replaceParameters ] [, stopProcessing ] ) Adds an info message that will be displayed to the user, sourced from an existing text.
addWarningMessage MainControl.addWarningMessage( message [, stopProcessing ] ) Adds a warning message that will be displayed to the user.
addWarningMessage MainControl.addWarningMessage( messageNo [, replaceParameters ] [, stopProcessing ] ) Adds a warning message that will be displayed to the user.
addWarningMessageText MainControl.addWarningMessageText( text [, replaceParameters ] [, stopProcessing ] ) Adds a warning message that will be displayed to the user, sourced from an existing text.
existErrorMessages MainControl.existErrorMessages( ) Returns true if undisplayed error messages exist for this element, otherwise returns false.
existInfoMessages MainControl.existInfoMessages( ) Returns true if undisplayed info messages exist for this element, otherwise returns false.
existMessages MainControl.existMessages( ) Returns true if undisplayed info, warning or error messages exist for this element, otherwise returns false.
existWarningMessages MainControl.existWarningMessages( ) Returns true if undisplayed warning messages exist for this element, otherwise returns false.

Element Functions

getElementName MainControl.getElementName( ) Returns the element name
getElementType MainControl.getElementType( ) Returns the element type