Skip to main content
Version: Streamsheets 2.5

DRAW.KNOB

Define a graphical knob on a given drawing.

Syntax

=DRAW.KNOB(X, Y, Width, Height, [LineColor], [FillColor], [Angle], Label, [Value], Min, Max, Step, [Marker])

Arguments

NameDescription
XX Coordinate in 1/100th mm
YY Coordinate in 1/100th mm
WidthWidth in 1/100th mm
HeightHeight 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.
LabelLabel 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.
MinMinimum value displayed in the knob.
MaxMaximum value displayed in the knob.
StepStep 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.

Return

TRUE, if button could be created.

Hint

This function should not be used in a cell

Examples

FormulaResultComment
=DRAW.KNOB(8711,14368,9578,3942,,,,"Knob",50,0,100,5,,0,0.52,5.76)
TRUEA knob with an interval from 0 to 100 and a step value of 5. Current Value is 50.