ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / TimeLine functions
  • Properties specific to TimelineEvent variables
  • Functions that use EventTimeline variables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The EventTimeline type is used to define the advanced characteristics of an event. This event will be dispayed inside a TimeLine control. The characteristics of this event can be defined and changed using different WLanguage properties.
The corresponding event can then be used with WLanguage functions for Timeline control management.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
TimelineDeleteAll(TL_Robots)
Evt is EventTimeline
 
TimelineAddTrack(TL_Robots, "Robot 1")
Evt.Track = "Robot 1"
Evt.Title = "Start"
Evt.Start = 10
Evt.End = 150
Evt.BackgroundColor = LightGreen
TimelineAddEvent(TL_Robots, Evt)
 
Evt.Track = "Robot 1"
Evt.Title = "Special process"
Evt.Start = 150
Evt.End = 450
Evt.BackgroundColor = PastelBlue
TimelineAddEvent(TL_Robots, Evt)
 
Evt.Track = "Robot 1"
Evt.Title = "Pause"
Evt.Start = 450
Evt.End = 700
Evt.BackgroundColor = LightRed
TimelineAddEvent(TL_Robots, Evt)
 
Evt.Track = "Robot 1"
Evt.Title = "Stop"
Evt.Start = 700
Evt.End = 750
Evt.BackgroundColor = PastelRed
TimelineAddEvent(TL_Robots, Evt)
Remarks

Properties specific to TimelineEvent variables

The following properties can be used to handle an event:
Property nameType usedEffect
AuthorCharacter stringName of the event author. If this property is not specified, the event has no author.
BackgroundColorIntegerBackground color used to display the event in the TimeLine control.
This color can correspond to:If this property is not specified, a color will be automatically calculated. The events of the same category will have the same color.
Before version 24, this property was named "BackgroundColor".
CategoryCharacter stringCategory of the event. If this property is not specified, the event is associated with no category.
ContentCharacter stringDetailed description of the event. The content is displayed in the TimeLine control.
If this property is not specified, the event has no description.
EndIntegerEnd of event. This property must use the same unit as the one used to display the TimeLine control (second, millisecond or microsecond).
This property must necessarily be specified.
IDCharacter stringIdentifier associated with the event. Allows you to store the identifier of an element that must be associated with the element in order to use it later in programming.
For example, this identifier can correspond to the identifier of a record in a database.
ImageCharacter stringImage associated with the event. This image is displayed in the TimeLine control (in addition to the logo that represents an important element if necessary).
This property can correspond to:
  • the path to an image accessible from the current computer,
  • an image file found in the application library,
  • an Image control containing an image,
  • a drawing performed in an Image control with the drawing functions and saved in memory.
If this property is not specified, the event has no associated image.
Remark: An internal window must be used to display an image in the event. The simple style (proposed by default) cannot be used to display an image.
ImportanceIntegerImportance of the event.
If this property is equal to or greater than 1, an icon (Icon of the important event.) will be displayed in the TimeLine control to indicate an important event.
If this property is not specified, its value is set to 0.
NoteCharacter stringNote associated with the event.
If this property is not specified, no note is associated with the event.
RepetitionRepetition variableAdvanced parameters of repetition. This property is taken into account only if the WithRepetition property is set to True.
StartIntegerStart of event. This property must use the same unit as the one used to display the TimeLine control (second, millisecond or microsecond).
This property must necessarily be specified.
TitleCharacter stringTitle of the event. The title is displayed in the Timeline control.
If this property is not specified, the event has no title.
TooltipCharacter stringTooltip displayed when the event is hovered. By default, this value includes the start and end times of the event as well as the event title.
TrackCharacter stringTrack associated with the event.
WithRepetitionBoolean
  • True if the event must be repeated,
  • False if the event only happens once.
If the event is repeated, the Repetition property allows you to specify the frequency of the repetition.
This property is set to False by default.

Functions that use EventTimeline variables

TimelineAddEventAdds an event into a TimeLine control.
Minimum version required
  • Version 18
Comments
Click [Add] to post a comment

Last update: 01/26/2023

Send a report | Local help