brixxbox Wiki
Search
⌃K

setEnable

Enables or disables a specific control.

Parameters

  1. 1.
    controlId - id of the brixxbox control as a string
  2. 2.
    enable - (optional, default = true) bool value if the control should be enabled or not
  3. 3.
    subControl (optional) Some controls have sub Controls, that can be enabled or disabled. Important: setEnable for subcontrols cannot be used in onAppStart, because some controls are not fully created at that time, use onAppInitialized instead. Here is a list of possible subControls:
    • grids
      • inline - enables or disables the inline editing of a grid (Cell Editing)
      • buttons - enables or disables the buttons of a grid
      • buttonNew - enables or disables the new buttons of a grid
      • buttonDelete - enables or disables the delete buttons of a grid
      • buttonCopy - enables or disables the copy buttons of a grid

Example Usages

1. Simple
brixxApi.setEnable("myControlId"); //enables the control
brixxApi.setEnable("myControlId", true); //enables the control
brixxApi.setEnable("myControlId", false); //disables the control
2. Disable the Grid inline edit feature
brixxApi.setEnable("myGridControl", false, "inline");
3. Disable all data manipulating grid Toolbar Buttons
brixxApi.setEnable("myGridControl", false, "buttons");
4. Disable a single grid Toolbar Buttons
brixxApi.setEnable("myGridControl", false, "buttonNew");
brixxApi.setEnable("myGridControl", false, "buttonDelete");
brixxApi.setEnable("myGridControl", false, "buttonCopy");