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

1. On the "Creación" tab, in the "Controles gráficos" group, expand "Tiempo" and select "TimeLine".
2. Click at the desired location to create the control. The control appears in the editor.

Control options

• Unidad de eventos: 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.
• Máscara de visualización: Defines the time format displayed in the time bar.
• Rango visible Number of seconds visible in the TimeLine.
• Rango total: Number of seconds displayed by the TimeLine.
• Characteristics of events
  • Superposición: Event overlap management. The events can be displayed side by side or slightly offset.
  • Granularidad del evento: TimeLine control display accuracy. 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).
• Ruler features The ruler displays the position in the TimeLine control field. The playhead options are as follows:
  • Mostrar cabezal: The ruler will be displayed in the field. In this case, it can be made modifiable (or not) by the user.
  • Cabezal desplazable If this option is selected, the user can move the slider in the TimeLine control using the mouse.
• Permitir seleccionar períodos Allows the user to select a period with the mouse.
• Permitir introducir un evento directamente: Allows the user to directly add an event. To do so, click the TimeLine control to create the event and enter its caption with the keyboard.
• Posición de la barra de tiempo: The time bar can be displayed at the top or bottom of the TimeLine control..
• Barra despl. horizontal Horizontal scrollbar to dequeue the contents of the TimeLine control. It can be automatic, always displayed or never.

• Modificar duración. You can allow users to change the duration of an event.
• Mover. You can allow users to move an event.
• Permitir al usuario cambiar de pista. You can allow users to change the track of the event.
• Permitir al usuario superponer elementos. 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.

• Ancho del encabezado de las pistas:
  • according to the track caption.
  • fixed.
• Minimum height of a track.

A context menu proposed automatically

• Zoom in and out in the control.
• Add, delete or modify an event when selecting a time period.
  Notes: If the field is linked to a data source, any deletion made in the field is carried out at the same time in the linked data source.
• Copy the content of an event.

Customize the event area

1. Open the TimeLine control description window.
2. On the "General" tab, select the internal window used for the events:
   • "None": the default display will be used.
   • "Predefined window": a predefined window is automatically added to the project.. By default, this window is named "IW_WinDevViewAPT.wdw".
   • "Simplified drawing": event 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.
   Attention: this internal window only allows you to customize the design of the event display.. 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

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