Clipboard Button
Allows the contents of a targeted control to be copied to the clients clipboard on any device.
The Clipboard button displays a button that allows content from another Form Control to be copied.
The content you want the user to be able to copy is set in the Target Control Name property.
The format of the return value will depend on the Control result being copied. Notably, Data Tables will be copied in a TAB delimited format that will allow users to copy the value into Microsoft Excel for example.
The Selected Row data, along with headers will be copied when targeting a Data Table control.
All other controls will copy the Return value.
The Clipboard button has two properties which allow the Project Administrator to give feedback to users:
- Text (Error) will display if the copy fails
- Text (Success) will display once the result is correctly copied to the clients clipboard.
The Clipboard control supports the following Controls:
- Check Box
- Check Box Group
- Combo Box
- Data Table
- Date Picker
- List Box
- Numeric Text Box
- Slider
- Spin Button
- Text Box
- TinyMCE Control
- Toggle Switch
- Measurement Text Box
- Option Group
Please Note
The control must be rendered on the current Form and enabled to allow content to be copied from it.
DriveWorks Live
A secured HTTPS connection should be used in DriveWorks Live to ensure that the value can be copied to the devices clipboard without error.
Properties
Appearance
Appearance - Border
Appearance - Picture
- Picture
The default picture to be shown for this control.
- Picture (Hover)
The picture to be shown when the control is in a hover state.
- Picture (Pressed)
The picture to be shown when the control is in a pressed state.
- Picture Size Mode
Controls how the picture will be sized to the control.
- Picture Style
Controls how the picture will appear on the control.
Appearance - Text
- Font
Specifies the font of the text shown in the control.
- Text Color
Specifies the color of the control's text.
- Text Color (Disabled)
Specifies the color of the control's text when the control is disabled.
- Text Color (Hover)
Specifies the color of the control's text when the control is in a hovered state.
- Text Color (Pressed)
Specifies the color of the control's text when the control is in a pressed state.
- Text Horizontal Alignment
Controls whether the text is horizontally aligned to the left, right or center
Behavior
- Button Text Reset Duration
Specifies the number of seconds to display the Text (Success) or Text (Error) value after copying, before
reverting to the default Text value. If the value is set to 0, DriveWorks will not automatically revert the
success or error text to the control's default value.
- Enabled
Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is anything other
than TRUE, e.g. FALSE).
- Error Result
Determines whether the value of the control is in error. The result of this rule is a string containing the
error message if the value is in error, otherwise a blank string or the number zero.
- Tab Index
Configures the position of the control in the form tab order.
- Target Control Name
The name of the control whose value to copy.
- Text
Specifies the text shown in the control.
- Text (Error)
Specifies the text of the control when the value could not be copied.
- Text (Success)
Specifies the text of the control when the value was copied successfully.
- Visible
Determines whether the control is visible (TRUE) or hidden (FALSE).
General
- (Metadata)
Optional text which can be used to provide information belonging to or about a control. For example, a list
of CSS classes which can be parsed and applied to the control using the Integration Theme in DriveWorks Live.
This doesn't affect the control's behavior.
- (Name)
The name of the control
- (Tag)
Optional text which can be used to describe the control, but which doesn't affect the control's behavior.
- Tooltip Duration
Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and below indicate
an infinite duration.
- Tooltip Text
Specifies the text to display in a tooltip when hovering over the control.
Layout
- Height
Controls the height of the control.
- Left
Controls the left position of the control.
- Top
Controls the top position of the control.
- Width
Controls the width of the control.