ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
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
grAutoRefreshCategoryLabel (Function)
In french: grMAJAutomatiqueEtiquetteCatégorie
Identifies or defines whether the category labels are refreshed whenever the chart is drawn. In this case, the content of the series is automatically recalculated whenever grDraw is called. The category labels are refreshed if necessary.
Use example: a series in a chart is used as reference series: this series is not automatically refreshed.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Example
// Chart created through programming
IF grAutoRefreshCategoryLabel("MyChart") = True THEN
grDraw("MyChart")
END
// Chart control
IF grAutoRefreshCategoryLabel(CHART_MyChart) = True THEN
grDraw(CHART_MyChart)
END
Syntax

Identifying the mode used to refresh the category labels Hide the details

<Result> = grAutoRefreshCategoryLabel(<Chart name>)
<Result>: Boolean
Current mode for refreshing the category labels:
  • True if the labels are automatically refreshed,
  • False otherwise.
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.

Defining the mode to refresh the category labels Hide the details

grAutoRefreshCategoryLabel(<Chart name> , <Automatic refresh>)
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Automatic refresh>: Boolean
  • True for an automatic refresh,
  • False otherwise.
Remarks
  • If the category labels are in automatic mode, the category labels will be automatically recalculated during the next call to grDraw.
  • If the category labels are not in automatic mode, the category labels will be recalculated during the next call to grSourceCategoryLabel.
Component: wd300grf.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/30/2023

Send a report | Local help