data (option)Added by IBM on August 8, 2013 | Version 1 (Original)
|Associates an action, button, or cell item with a single data item. The data option is valid only in items with a type setting of enclose, display, extract, or remove.
Table 1. data parameters
|data item||string||The item sid of the data item to associate with the action, button, or cell.|
Available in action, button, cell
Example The button under is an enclosure button associated with a single data item.
If a user enclosed another file, then the data item referred to in the button's data option would be replaced with the new data item. (The data item would use the same item sid; the one that is referred to in the data option.)
- Default: none
- A data option specifies only zero or one data items.
- If an item with a type setting of enclose and a data option is used to enclose a second data item, then the second data item will replace the first.
- If an enclosure mechanism is used to replace an image stored in a data item with a new image (see previous statement), then buttons and labels whose image option is set to the identifier of the image data item will be updated to display the new image.
- A data item referred to in a data option might also have a datagroup option and thus belong to the datagroups of other actions, buttons, or cells.