Contextual Toolbar

When you select a grid row, the Contextual Toolbar web extension shows a dynamic toolbar.

The toolbar is displayed only when selected data requires actions. The toolbar resembles the standard toolbar and applies conditional visibility and row‑selection logic.

The Contextual Toolbar web extension includes these elements:

  • Title
  • Button with an icon and text
  • Text‑only button
  • Icon‑only button
  • Menu button that expands to:
    • Child buttons
    • Horizontal splitter
    • Section title
  • Selected only switch
  • Vertical splitter
  • Close button

To configure the Contextual Toolbar web extension, specify these parameters:

  • List of Items: Specify a cell range that contains item unique names. Items represent actions for processing.
  • Item data: Specify a cell range that contains a data table or specify a cell that contains an .xml file.

    These properties and their values are defined in the data table:

    • Enabled: TRUE or FALSE
    • Visible: TRUE or FALSE
    • Selected: TRUE or FALSE
    • Caption: Text
    • Tooltip: Text
    • Parent: Item unique name
    • MediaName: Shared image unique name
    • Type: Splitter, icon, heading, or blank
  • Padding: Specify the inner padding in pixels for the Contextual Toolbar web extension. The padding moves items inwards from the left and right sides.

    If you specify @ at the end of the Padding parameter, the Contextual Toolbar web extension is resizable and must be in the toolbar header. If you specify a single value, it applies to both sides. If you specify two values, such as"10;20" or "10;20@", they apply to the left and right sides, respectively.

    Valid separators are a semi-colon (;) and pipe or vertical bar (|).

  • Selected only: Specify TRUE, FALSE, or leave it blank. If you specify TRUE or FALSE, the Selected only switch is enabled or disabled, respectively Both TRUE and FALSE values are used to start an action.
  • Toolbar title: Specify the toolbar title.
  • Close action: Specify a cell that defines an action of closing.