Skip to main content
Version: 7.9


Component Palette Icon:


The container is a very important component. All components are always inside of a container, except for the special "Root Container" of each window (see Window Properties). A container is different than normal components in that it can contain other components, including other containers. Uses for containers include:

  • Organization - Containers can be used to group components together. These components can then easily be moved, copied, or deleted as a group. Furthermore, they will all be organized inside of their parent container in the project navigation tree, which makes them easier to find.
  • Re-usability - Containers allow a unique opportunity to create a complex component that is made up of multiple other components. The Container's ability to have dynamic properties aids this greatly. For instance, if you wanted to make your own custom HOA control, you can put three buttons inside of a container and configure them to all use a 'status' property that you add to their parent Container. Now you have built an HOA control that can be re-used and treated like its own component. The possibilities here are endless. Create a date range control that generates an SQL WHERE clause that can be used to control Charts and Tables. Create a label/button control that can be used to display datapoints, and pop up a parameterized window that displays meta-data (engineering units, physical location, notes, etc) about that datapoint. Creating re-usable controls with Containers containing multiple components is the key to rapid application development.
  • Layout - Containers are a great way to improve window aesthetics through borders and layout options.

To move a container around on a window, you need to hold the alt key while clicking and dragging.


NameDescriptionProperty TypeScriptingCategory
Background ColorThe background color of the component.Color.backgroundAppearance
BorderThe border surrounding this component. Note that the border is unaffected by rotation.Border.borderCommon
Combine RepaintsSet this to true for containers with many sub-components that need to redraw frequently (flashing, rotating, animating).boolean.combineRepaintsBehavior
CursorThe mouse cursor to use when hovering over this
Data QualityThe data quality code for any tag bindings on this
FontFont of text on this component.Font.fontAppearance
Mouseover TextThe text that is displayed in the tooltip which pops up on mouseover of this component.String.toolTipTextCommon
NameThe name of this component.String.nameCommon
OpaqueIf false, backgrounds are not drawn. If true, backgrounds are drawn.boolean.opaqueCommon
StylesContains the component's styles.Dataset.stylesAppearance
TextureBackground texture image for this container.String.texturePathAppearance
Tile OptimizedIf true, this container's children should never overlap, and you'll get better painting performance.boolean.optimizedDrawingEnabledBehavior
VisibleIf disabled, the component will be hidden.boolean.visibleCommon


Scripting Functions

This component does not have scripting functions associated with it.

Extension Functions

This component does not have extension functions associated with it.

Event Handlers

Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the Component Events page.


Property NameValue
Background Color255,232,204