PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
X
Y
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
..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).
Example
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
Syntax

Finding out the value of the ruler Hide the details

<Result> = <Control Name>..RulerValue
<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.

Modifying the value of the ruler Hide the details

<Control Name>..RulerValue = <New Position>
<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.
Remarks
  • 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.
See also
Minimum required version
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment