PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview of TimeLine control
  • Creating a TimeLine control
  • Characteristics of TimeLine control
  • The options of the control
  • A popup menu automatically proposed
  • Customize the event area
  • Modes for filling a TimeLine control
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
Overview of TimeLine control
The TimeLine control is used to represent chronologies of close events that can be parallel.
This control is used for example:
  • to perform a video editing.
  • to represent events on a robot.
  • to perform an animation.
Creating a TimeLine control
To create a TimeLine control:
  1. On the "Creation" pane, in the "Graphic controls" group, expand "Time" and select "TimeLine".
  2. Click the position where the control will be created in the window. The control appears in creation mode.
Versions 20 and later
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL + Z]: the default control size will be restored.
New in version 20
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL + Z]: the default control size will be restored.
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL + Z]: the default control size will be restored.
To display the control characteristics, select "Description" from the popup menu of control.
Characteristics of TimeLine control

The options of the control

The TimeLine control can be configured in the editor via the description window ("Details" tab).
The parameters of the TimeLine control are as follows:
  • Display resolution: Defines the display resolution used for the TimeLine control. The units used in the description window are automatically modified according to the selected unit (second, millisecond or microsecond). Unit of events: 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 run time.
    • 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
    • Overlaying: 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 have the ability to 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 pager: The pager is used to view the position in the TimeLine control. The options reagarding this pager are:
    • Pager visible: The pager will be displayed in the control. In this case, it can be made modifiable (or not) by the user.
    • Modifiable pager: If this option is selected, the user will be able to move the pager in the TimeLine control with the mouse.
  • Allow the selection of periods: 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.
The edit options via the mouse are as follows:
  • Modifying the duration. You can allow (or not) the user to modify the duration of an event.
  • Movement. You can allow (or not) the user to move an event.
  • Allow the user to change track. You can allow the user to change the track of the event.
  • Allow the overlapping by the user. 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.
The options regarding the dimension of areas are as follows:
  • Width of header for the tracks:
    • according to the track caption.
    • fixed.
  • Minimum height of a track.

A popup menu automatically proposed

The TimeLine control can display a specific popup menu proposing automatic features to the user. This menu is proposed by the AAF (Automatic Application Features).
As soon as at least one track is found in the TimeLine control, this menu allows the user to:
  • Perform a zoom on the control (zoom in or zoom out on the selection).
  • Add, delete or modify an event when selecting a time period.
    Notes: If the control is linked to a data source, the deletion performed in the control is performed at the same time in the linked data source.
  • Copy the content of an event.

Customize the event area

In the TimeLine control, the event is displayed in a specific area. You have the ability to translate and customize this area: title color, background color of the event, ...
To customize the display of events:
  1. Display the description window of TimeLine control.
  2. In the "General" tab, select the internal window used for the events:
    • "None": the default display 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" was selected, the internal window is available in the project explorer. It can be modified in the window editor.

    Caution: this internal window can only be used to customize the drawing regarding the display of events. Only the process for declaring the global variables is run. No other process is run. Therefore, you cannot add buttons with a specific click code.
Notes:
  • You also have the ability to use any internal window of your project.
  • The aspect of the events proposed by default can be configured in the "Style" tab of the description window of the control, in the "Event" element.

Modes for filling a TimeLine control

A TimeLine control can be filled:
Related Examples:
The Timeline control Unit examples (WINDEV): The Timeline control
[ + ] Using a TimeLine control
Minimum required version
  • Version 18
Comments
Click [Add] to post a comment