ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Gantt Chart functions
  • Retrieving a task
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
Gets a task using its identifier in a Gantt Chart column in a Table or TreeView Table control.
Example
// Retrieve a task to modify it
MyTask is GanttTask
MyTask <- GanttGetTask(COL_Gantt, "ID2")
MyTask.Title = "New title"
// Retrieve a task
MyTask is GanttTask
MyTask = GanttGetTask(COL_Gantt, "ID1")
InfoBuild("Retrieved task: %1", MyTask.Title)
Syntax
<Result> = GanttGetTask(<Gantt column> , <Identifier>)
<Result>: GanttTask variable
Name of the GanttTask variable from which the task characteristics are retrieved.
<Gantt column>: Control name
Name of the Gantt Chart column (in a Table or TreeView Table control) to be used.
<Identifier>: Character string
Identifier of the task to retrieve. This identifier corresponds to the ID property defined in the GanttTask variable.
A WLanguage error occurs if the specified identifier does not exist.
Remarks

Retrieving a task

To retrieve a task, you can:
  • use the "=" operator. In this case, you can get the characteristics of the retrieved task.
  • use the "<-" operator. In this case, you can dynamically modify the retrieved task.
1st case: Using the "=" operator.
In this case, you can get the characteristics of the retrieved task.
<Variable name> = GanttGetTask(<Gantt column>, <Identifier>)

For example:
// Retrieve a task
MyTask is GanttTask
MyTask = GanttGetTask(COL_Gantt, "ID1")
InfoBuild("Retrieved task: %1", MyTask.Title)

You also have the ability to retrieve a task by using the following syntax:
<Variable name> = <Gantt column>["<Identifier>"]

For example:
MyTask is GanttTask
MyTask = COL_Gantt["ID1"]
InfoBuild("Retrieved task: %1", MyTask.Title)


2nd case: Using the "<-" operator.
In this case, you can dynamically modify the retrieved task.
<Variable name> <- GanttGetTask(<Gantt column>, <Identifier>)
where Identifier is the identifier of the task to retrieve.
For example:
// Modify a task
MyTask is GanttTask
MyTask <- GanttGetTask(COL_Gantt, "ID1")
MyTask.Progress = 70
MyTask.ProgressColor = LightGreen

You also have the ability to retrieve a task by using the following syntax:
<Variable name> <- <Gantt column>["<Identifier>"]
For example:
t <-COL_Gantt["ID1"]
t.BackgroundColor = LightBlue
Related Examples:
WD Gantt Complete examples (WINDEV): WD Gantt
[ + ] The "WD Gantt" example presents an advanced use of the Gantt Chart control.
This example is used to create a Gantt chart with tasks, links, cumulative tasks and milestones.
The tasks can be edited in a specific window.
The created chart can be saved in a file and reloaded thereafter.
Component: wd290mdl.dll
Minimum version required
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/26/2023

Send a report | Local help