setEnable

Enables or disables a specific control.

Parameters

1. controlId - id of the brixxbox control as a string

2. enable - (optional, default = true) bool value if the control should be enabled or not

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");