Interface: CustomControl

Extends

Control

Members

(readonly) dataStores :Array.<DataStore>

The control's data stores. The order is the same as was authored.

Type:

Array.<DataStore>

(readonly) element :HTMLElement

The control's HTML element. No assumptions should be made about the element's type (nodeName) or contents.

Type:

HTMLElement

Inherited From: Control#element

(async, readonly) instance :Promise

The control's instance (the instance created from the module). Since modules are loaded asynchronously, the instance may not be immediately available.

Type:

Promise

Examples

Obtain a reference to a single control's instance.

const oModuleInstance = await oControl.instance;
// The module instance is available here

Obtain a reference to multiple control instances using Promise.all.

const aPromises = [oControl1.instance, oControl2.instance, oControl3.instance];
const aModuleInstances = await Promise.all( aPromises );
// The module instances are available here

(readonly) name :String

The control's authored name.

Type:

String

Inherited From: Control#name

(readonly) nodeName :String

The control's report specification node name.

Type:

String

Since: Version 7
Inherited From: Control#nodeName

Methods

getDataStore(sNameopt) → (nullable) {DataStore}

Get a control's data store by name. If the data store doesn't exist, null is returned.

Parameters:

Name	Type	Attributes	Description
`sName`	String	<optional>	The name of the data set. If no name is passed, the first data store will be returned.

Returns:

The data store.

Type:: DataStore

getDisplay() → {Boolean}

The display state of the control.

Inherited From: Control#getDisplay

Returns:

true if the control is displayed and false if the control is not displayed.

Type:: Boolean

getVisible() → {Boolean}

The visibility state of the control.

Inherited From: Control#getVisible

Returns:

true if the control is visible and false if the control is hidden.

Type:: Boolean

setDisplay(bDisplay)

Set the display of the control.

WARNING:
If the control is authored to be initially not displayed using the property "Box type" with a value of "None", this is treated like a conditional render so the report output will not contain the control. Use a "Box type" of "None-Block" or "None-Inline" instead.

Parameters:

Name	Type	Description
`bDisplay`	Boolean	Pass true to display and false to not display the control.

Inherited From: Control#setDisplay

setVisible(bVisible)

Set the visibility of the control.

Parameters:

Name	Type	Description
`bVisible`	Boolean	Pass true to show and false to hide the control.

Inherited From: Control#setVisible

toggleDisplay()

Toggle the display of the control. See getDisplay and setDisplay for details.

Inherited From: Control#toggleDisplay

toggleVisibility()

Toggle the visibility of the control. See getVisible and setVisible for details.

Inherited From: Control#toggleVisibility