> | # TakeUndoCancel ## Description This component provides a TAKE, UNDO, and DESELECT button set for use in a single layer matrix crosspoint selection panel. The component has several parameters that can be set at design time, and two parameters that are set at runtime. The matrix to be controlled is set by entering a name in the host script control "Instances" field. The source crosspoint and destination crosspoint are sent via either another script or, more usually, via the connections engine. The source numeric ID is sent as parameter "sourceID" and the destination ID is sent as parameter "destID". Using a BNCS "Name Grid" or "Dest Grid" control, set to report on Index change enables the connection engine to pass the index values. Index values less than 1 count as deslection indication from the source or destination. When the user presses the "Deselect" button the component sends a "deselect=-1" to the host. The value of -1 can be directed to the highlight function of the "Name Grid" or "Dest Grid" causing them to deselect any current active selection. ## Commands
> Name | Type | Use
> --- | --- | ---
> instance | mandatory | Instance name for matrix to be controlled.
> bgndStyle | Optional | Statesheet name that defines the colour of the background panel.
> takeHigh | Optional | Statesheet name for TAKE button high brightness toggle setting.
> takeLow | Optional | Statesheet name for TAKE button low brightness toggle setting.
> takeDouble | Optional | Flag that defines if the TAKE button requires a double push. Allowed values "True" and "False" (case insensitive). Default "True"
> undoDouble | Optional | Flag that defines if the UNDO button requires a double push. Allowed values "True" and "False" (case insensitive). Default "False"
> sourceID | Integer (ASCII) | Matrix index value for selected source. A 0 or -1 means source deselect.
> destID | Integer (ASCII) | Matrix index value for selected destination. A 0 or -1 means destination deselect.
> ## Notifications
> Name | Use
> --- | ---
> deselect=<-1> | Sent to indicate user has completed an action that no longer needs source and destination indicies.
> ## Stylesheets
> Name | Use
> --- | ---
> None | No named stylesheets used by default
## Developers Notes Developed by Andy Woodhouse for use in Academy Wood Norton installations.
Copyright BBC 2017