..RulerValue is used to find out and modify the position of a ruler in a TimeLine control.
Reminder: The ruler of a TimeLine control corresponds to a "bold" vertical line used to view a specific moment in the control. The style of the ruler is defined in the "Style" tab of the TimeLine control ("Selected time" element).
TimelineDeleteAll(TL_Robots)
Evt is EventTimeline
TimelineAddTrack(TL_Robots, "Robot 1")
Evt..Track = "Robot 1"
Evt..Title = "Startup"
Evt..Start = 10
Evt..End = 150
Evt..BrushColor = LightGreen
TimelineAddEvent(TL_Robots, Evt)
Evt..Track = "Robot 1"
Evt..Title = "Special process"
Evt..Start = 150
Evt..End = 450
Evt..BrushColor = PastelBlue
TimelineAddEvent(TL_Robots, Evt)
// Positions the ruler at a specific moment
TL_Robots..RulerVisible = True
TL_Robots..RulerValue = 300
// -- Code for modifying the TimeLine control
// Displays the selected value in the static
STC_TimeLineRuler = TL_Robots..RulerValue
Sintaxis
<Result>: Integer
Current position of the ruler. The unit used is identical to the one used for displaying the TimeLine control (second, millisecond of microsecond).
<Control Name>: Character string (with or without quotes)
Name of the TimeLine control to use.
<Control Name>: Character string (with or without quotes)
Name of the TimeLine control to use.
<New Position>: Integer
New position of the ruler. The unit used is identical to the one used for displaying the TimeLine control (second, millisecond of microsecond). This value must be included between ..StartTotalRange and ..EndTotalRange otherwise the ruler will be invisible.
Observaciones
- The ruler can be modified by the user:
- if "Modifiable pager" is checked in the description window of the TimeLine control.
- if ..RulerModifiable is set to True.
- The end user can modify the value of the ruler by moving the line with the mouse. This action triggers the "Whenever modifying the TimeLine control" process.
- The default position of the ruler corresponds to ..StartTotalRange.