• to perform a video editing.
• to represent events on a robot.
• to perform an animation.

1. On the "Creation" tab, in the "Graphic controls" group, expand "Time" and select "TimeLine".
2. Click at the desired location to create the control. The control appears in the editor.

Control options

• Events unit: Defines the unit used for the TimeLine control: second, millisecond or microsecond. This parameter is used to define:
  • the display unit used by the control at runtime.
  • the unit used for the different values in the description window.
• Display mask: Used to define the format of the time displayed in the ruler.
• Visible range: Number of seconds visibles in the TimeLine.
• Total range: Number of seconds displayed by the TimeLine.
• Characteristics of events
  • Overlap: Manage the overlap of events. The events can be displayed side by side or slightly offset.
  • Event granularity: Precision for displaying the TimeLine control. You can define:
    • the granularity when moving an event (1 time unit by default).
    • the granularity regarding the duration of an event, which means the minimum duration of an event (1 time unit by default).
• Characteristics of the playhead: The playhead allows you to view the position in the TimeLine control. The playhead options are as follows:
  • Show playhead: The playhead will be displayed in the control. In this case, it can be made modifiable (or not) by the user.
  • Movable playhead: If this option is selected, the user will be able to move the playhead in the TimeLine control with the mouse.
• Allow time range selection: Allows the user to select a period with the mouse.
• Allow the direct input of an event: Allows the user to add an event directly. To do so, click the TimeLine control to create the event and enter its caption with the keyboard.
• Position of the time bar: The time bar can be displayed at the top or at the bottom of the TimeLine control.
• Horizontal scrollbar: The horizontal scrollbar is used to scroll the content of the TimeLine control. It can be automatic, always displayed or never.

• Change duration. You can allow users to change the duration of an event.
• Move. You can allow users to move an event.
• Allow the user to change track. You can allow users to change the track of the event.
• Allow users to overlap elements. If this option is checked, when moving events, the user will be able to make them overlap. In this case, the options defined for the overlap of events (offset of side by side) will be taken into account.

• Width of header for the tracks:
  • according to the track caption.
  • fixed.
• Minimum height of a track.

Context menu proposed automatically

• Zoom in and out in the control.
• Add, delete or modify an event when selecting a time period.
  Remarks: If the control is bound to a data source, the data deleted in the control is also deleted from the data source.
• Copy the content of an event.

Customize the event area

1. Open the TimeLine control description window.
2. In the "General" tab, select the internal window used for the events:
   • "None": the default display mode will be used.
   • "Preset window": a preset window is automatically added to the project. By default, this window is named "IW_WinDevViewAPT.wdw".
   • "Simplified drawing": the event is displayed without title.
3. If "Preset window" has been selected, the internal window will be available in the project explorer. It can be edited in the window editor.
   Caution: this internal window can only be used to customize the drawing regarding the display of events. Only the code of the "Global declarations" event is executed. No other WLanguage events are run. Therefore, you cannot add buttons with a specific click code.

• You also have the ability to use any internal window of your project.
• The appearance of the events proposed by default can be configured by selecting "Event" in the "Style" tab of the control description window.

Modes for filling a TimeLine control

• through programming, via several events and WLanguage functions. For more details, see Manipulating TimeLine controls programmatically.
• via data binding.
• via data binding (to a variable).