Tool Panel Technical Reference
Summary
- Tool Panel State and Tool Panel Options are used to set up Tool Panels at design-time
- Run-time access to Tool Panels is through Tool Panel API
Tool Panel State
The Tool Panel State contains 2 collections:
| Property | Description | Default |
|---|---|---|
| ModuleButtons | AdapTable Module Buttons visible in ToolPanel | Empty Array |
| ToolPanels | Adaptable Tool Panels which are viaible | ToolPanels for all available Modules (subject to Entitlement rules) |
A Tool Panel is defined as follows:
| Property | Description | Default |
|---|---|---|
| Name | ToolPanel name - either an Adaptable Module or a Custom ToolPanel (defined in ToolPanel Options) | |
| VisibilityMode | Whether the ToolPanel is 'expanded' or 'collapsed' | 'collapsed' |
Tool Panel Options
The Tool Panel Options section is used to set up the Tool Panel.
| Property | Description | Default |
|---|---|---|
| customButtons | ToolPanel Buttons provided by Users which perform custom behaviour | |
| customToolPanels | ToolPanels provided by Users which contain custom content | |
| showToolPanelsDropdown | Display the Tool Panels dropdown | true |
Tool Panel API
The Tool Panel API section provides run-time access to the Tool Panel.
| Method | Description |
|---|---|
| closeAdapTableToolPanel() | Closes the Tool Panel section (irrespective of which toolpanel is showing) |
| getCustomToolPanelButtons() | Retrieves all Custom Tool Panel Buttons defined in ToolPanelOptions |
| getCustomToolPanelByName(name) | Retrieves the CustomToolPanel with the given name (or undefined if no match is found) |
| getCustomToolPanels() | Retrieves all Custom Tool Panels defined in ToolPanelOptions |
| getModuleButtons() | Sets the Module buttons from the Adaptable ToolPanel |
| getToolPanelState() | Retrieves Tool Panel section from Tool Panel State |
| openAdapTableToolPanel() | Opens the Adaptable ToolPanel Component |
| setAdaptableToolPanelVisibilityMode(adaptableToolPanel, visibilityMode) | Sets the given Adaptable ToolPanel with the provided visibilityMode (expanded / collapsed) |
| setCustomToolPanelVisibilityMode(customToolPanelName, visibilityMode) | Sets the Custom ToolPanel with the given name with the provided visibilityMode (expanded / collapsed) |
| setModuleButtons(moduleButtons) | Sets the Module buttons in the Adaptable ToolPanel |
| showToolPanelPopup() | Opens Settings Panel with Tool Panel section selected and visible |