PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

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
Formats the data displayed by grLabel or by grTooltip.
Versions 15 and later
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
New in version 15
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
Versions 16 and later
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 16
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 19 and later
Android This function is now available for the Android applications.
New in version 19
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 23 and later
PHP This function is now available for the PHP sites.
New in version 23
PHP This function is now available for the PHP sites.
PHP This function is now available for the PHP sites.
Example
grMask("MyChart", grMaskPercent, "99.99%")
grLabel("MyChart", grShowPercent, True)
grDraw("MyChart")
Syntax
grMask(<Chart Name> , <Type of Mask> , <Mask Value>)
<Chart Name>: Character string (with or without quotes)
Name of chart to use. This name corresponds to:
  • the chart name defined by programming with grCreate.
  • the name of Chart control found in the window editor, page editor or report editor.
Android Only the Chart controls are available.
PHP Only the interactive Chart controls are available.
<Type of Mask>: Numeric constant
Mask used:
grMaskAxisThe specified mask is used to format the values displayed on the chart axes.
Example: Displays the value in the current currency: the value of the mask is "+99,999,999,999.99 $".
Versions 21 and later
grMaskTimeAxis
New in version 21
grMaskTimeAxis
grMaskTimeAxis
The specified mask is used to format the dates or times displayed on the chart axes.
Example: Displays the date in "MM/DD/YYYY" format: the value of the mask is "MM/DD/YYYY".
grMask("MyChart", grMaskTimeAxis, "MM/DD/YYYY")
This constant is supported by the types of charts that can include a time axis: Column, Horizontal column, Line and Area.
Android This constant is not available.
grMaskPercentThe specified mask is used to format the percentages displayed in the chart (grLabel(<Chart Name>, grShowPercent, True))
Caution: the % symbol must be found in <Mask Value>.
Example: "99.99%" displays the percentage with 2 digits after the decimal point.
grMaskValueThe specified mask is used to format the values displayed in the chart (grLabel(<Chart Name>, grShowValue, True))
Example: Displays the value in the current currency: the value of the mask is "+99,999,999,999.99 $".
<Mask Value>: Character string (with quotes)
Description of the mask to use.
  • For the grMaskValue constant: Empty string ("", default value) to disable the display mask.
  • For the grMaskPercent constant: "99%": default value.
  • Versions 21 and later
    For the grMaskTimeAxis constant:
    • If the value to display is a date, it must be in "YYYYMMDD" format. The supported masks are identical to the ones used by DateToString.
    • If the value to display is a time, it must be in "HHMMSSCC" format. The supported masks are identical to the ones used by TimeToString.
    New in version 21
    For the grMaskTimeAxis constant:
    • If the value to display is a date, it must be in "YYYYMMDD" format. The supported masks are identical to the ones used by DateToString.
    • If the value to display is a time, it must be in "HHMMSSCC" format. The supported masks are identical to the ones used by TimeToString.
    For the grMaskTimeAxis constant:
    • If the value to display is a date, it must be in "YYYYMMDD" format. The supported masks are identical to the ones used by DateToString.
    • If the value to display is a time, it must be in "HHMMSSCC" format. The supported masks are identical to the ones used by TimeToString.
The masks are defined via characters: "9", ".", ",", "+", "-" and space characters. For example: "99.999,99". For the currency masks, use up to 17 significant digits for the integer part and 6 for the decimal part. For example: "99 999 999 999 999 999,999999".
Notes:
  • In order for the number to be filled with zeros on the left, the "0" character must be used on the left of the mask. For example: "099.999,99".
  • To force the signs, use the "+" character on the left. For example: "+9999".
Remarks
This function only affects charts that display values or percentages.
Related Examples:
WD Chart Training (WINDEV): WD Chart
[ + ] This educational example present different uses of the chart control.
The following charts are presented:
- Semi-circular
- Donut
- Pie
- Sunburst
- Line
- Scatter
- 3D Scatter
- Column
- Area
- Bubble
- Radar
- Funnel
- Surface
- Waterfall
- Composite

The main features presented in this example are the ability to customize the charts by programming as well as the method used to fill a chart from a HFSQL file or in the editor.
The Chart functions Unit examples (WEBDEV): The Chart functions
[ + ] This example presents the main features of the chart designer of WEBDEV and it allows you to:
- Create a chart: Pie, Column or Line
- Define the display area of a chart
- Define the options of the chart (legend, percentage, ...)
The Chart functions Unit examples (WINDEV Mobile): The Chart functions
[ + ] Using the Chart functions:
- create a Pie, Column or Line chart by programming
- define the chart options (legend, percentage, ...)
Components
WINDEVWEBDEV - Server codeReports and Queries wd230grf.dll
Windows Mobile wp230grf.dll
Linux wd230grf.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment