DRAW.SLIDER
Define a graphical slider on a given drawing.
Syntax
=DRAW.SLIDER(X, Y, Width, Height, [LineColor], [FillColor], [Angle], Label, [Value], Min, Max, Step, [Marker], [FormatRange])
Arguments
| Name | Description |
|---|---|
| X | X Coordinate in 1/100th mm |
| Y | Y Coordinate in 1/100th mm |
| Width | Width in 1/100th mm |
| Height | Height in 1/100th mm |
| LineColor (optional) | Options: - None for no line - Hexadecimal color value ( #FF0000 for Red) |
| FillColor (optional) | - Hexadecimal color value ("#FF0000" for Red) |
| Angle (optional) | Angle in radians. |
| Label | Label to display |
| Value (optional) | Current state of the button. TRUE for pushed and FALSE for released. If a cell reference is used, a value change from user interaction will be pushed into that cell. |
| Min | Minimum value displayed in the knob. |
| Max | Maximum value displayed in the knob. |
| Step | Step to use for interaction while changing the knob value. |
| Marker (optional) | Marker style to indicate the current value. Allowed values are: none arrowinner line circlesmall Default is a large circle. |
| FormatRange (optional) | Cell range to provide additional scale information. It must be a range with 3 columns. The values in the first column provides a scale value. The value in the second column provides a label, that is displayed instead of the scale value. This is optional. The value in the third column can provide a hexadecimal color value. This is used to color the scale between the last value and the current value in column one. This way you can define a colored scale indicating valid, invalid oder desired values ranges. See the sample below. |
Return
TRUE, if slider could be created.
Hint
This function should not be used in a cell
Examples
| A | B | C | |
|---|---|---|---|
| 1 | 0 | Bad | #FF0000 |
| 2 | 30 | Average | #00FF00 |
| 3 | 70 | Good | #0000FF |
| Formula | Result | Comment |
|---|---|---|
| TRUE | Draw a slider with an interval from 0 to 100 and a step value of 5. As a format range is given, the slider scale will be colored and custom labels will be applied. The selected value will be pushed into cell A1. |