Chart management functions

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Chart management functions

Remark: These functions are also available in prefix syntax (Chart management functions (prefix syntax)).

Using the charts in WEBDEV Linux

To use the charts in WEBDEV Linux, the QT library (Core and GUI) version 5 (or later) must be installed.

In Ubuntu, this library can be installed with the following commands:

sudo apt-get install libqtcore5
sudo apt-get install libqtgui5

The following functions are used to manage charts:


gr3DSParameter	Retrieves or modifies a parameter for drawing a chart in 3D Spatial mode.
grAddData	Adds a data into a chart.
grAddTimeData	Adds data at a precise moment in a time chart.
grAutoRefreshCategoryLabel	Identifies or defines whether the category labels are refreshed whenever the chart is drawn.
grAutoRefreshSeries	Identifies or defines whether a series is refreshed whenever the chart is drawn.
grAxisPosition	Indicates the position where one of the chart axes (X or Y-coordinates) will be drawn.
grAxisTitle	Defines the title of X-axis and the title of Y-axis in a chart.
grAxisTitleFont	Modifies the font used for the titles of the chart axes.
grAxisVisible	Configures how the axes are displayed in Line or Column charts.
grBarColor	Initializes the color of a specific bar in a Column or Stacked Column chart.
grCategoryColor	Initializes the category color for a chart whose type is: Pie, Column, Bubble chart, Waterfall.
grCategoryLabel	Initializes the label of a data category (or section) in a chart.
grClearPict	Erases the chart drawing (in an Image control or in a window).
grColor	Returns and initializes the color of different chart elements.
grColumnAggregation	Defines the algorithm for aggregating data in a grouped or stacked Column chart.
grColumnBarType	Defines the type of bar used in a column chart.
grColumnSpacing	Indicates the spacing between each data category in a column chart or in a Minimum/Maximum stock chart.
grComparativeSeriesPosition	Fixes the position (left or right) of a series in a comparative Histogram chart.
grCreate	Creates a specific type of chart.
grCreateFont	grCreateFont is kept for backward compatibility.
grDeleteAll	Erases a chart and destroys this chart.
grDeleteSeries	Deletes a data series from a chart.
grDestinationBMP	Defines a BitMap file as destination of a chart (BMP means BitMap).
grDestinationControl	Defines an Image control as destination of a chart.
grDestinationEMF	Defines a meta file as chart destination (EMF means Enhanced Meta File).
grDestinationImage	Defines an Image variable as destination of a chart.
grDestinationWMF	Defines a meta file as chart destination.
grDestinationWnd	Defines a window as chart destination.
grDonutHolePercentage	Modifies the percentage corresponding to the radius of the hole in a Donut chart.
grDraw	Draws a chart according to the specified parameters.
grExist	Checks the existence of a chart in memory.
grGetData	Retrieves a data from a chart.
grGradient	Enables or disables the display of color gradients in a chart.
grGridlines	Displays or hides the chart gridlines.
grHMAddData	Adds a data into a Heatmap chart.
grHMCaptionX	Modifies the caption of a category on the X-axis of a Heatmap chart.
grHMCaptionY	Modifies the caption of a category on the Y-axis of a Heatmap chart.
grHMColor	Specifies the colors of different values in a Heatmap chart.
grHMDeleteColor	Deletes the colors specified by grHMColor from a Heatmap chart.
grHMGetData	Retrieves data from a Heatmap chart.
grHolePercentage	Modifies the percentage that corresponds the hole radius in the following charts: Donut, Radial Bar chart.
grImageSize	Defines the size of the image containing the chart.
grIncreaseData	Adds a value to a data in a chart.
grInfoXY	Returns information about the series found at a specific chart point.
grInterval	Indicates the interval between values on the vertical and horizontal axis of a chart.
grLabel	Indicates various parameters of additional legend in a chart.
grLabelFont	Modifies the font used for the category labels of a chart.
grLegend	Indicates the presence and position of legend in a chart.
grLegendFont	Modifies the font used for the chart legend.
grLineThickness	Retrieves and/or modifies the value of the line thickness in a line chart.
grLoadParameter	Restores the parameters used to draw a chart.
grMask	Formats the data displayed by grLabel or by grTooltip.
grMenu	Defines the type of context menu displayed by a chart.
grMenuOption	Modifies the text of an option in the context menu of a chart.
grOrientation	Modifies the orientation of chart axes.
grOrigin	Modifies the start and end marks on one of the chart axes.
grOverlayChart	Used to display two different types of charts in the same chart.
grParameter	Retrieves or modifies a chart parameter.
grPiePullOut	Pulls out a section (or all sections) in a chart.
grPieStartAngle	Indicates the start angle of first section in a Pie chart, Semi-circular chart or Donut chart.
grPointColor	Initializes the color of a specific point in one of the following chart types: Line, Scatter, Bubble chart.
grPointInfo	Returns the screen coordinates of a point or the screen coordinates of a value found in a chart.
grPointSize	Configures the size of a specific point in a Line or Scatter chart.
grPointType	Modifies the shape of point for a specific category or value found in a Line, Area, Scatter and Radar chart.
grPrint	Prints a chart.
grRaised	Used to display a chart with raised effect.
grRBAddData	Adds data to a Radial Bar chart.
grRBMaximumValue	Sets the maximum value in a Radial Bar chart.
grRBRotationDirection	Sets the rotation direction in a Radial Bar chart.
grRealTimeInterval	Sets the time interval visible in a time chart with real-time display.
grRotation	Used to: Turn a chart around one of its axes in order to better view the data. Find out the rotation angle of a chart on one of its axes.
grSaveBMP	Saves a chart that was previously drawn in a file in BMP format.
grSaveEMF	Saves a chart that was drawn beforehand in a file in EMF format.
grSaveImage	Saves the image of a chart in an Image variable.
grSaveParameter	Saves the parameters of a chart in the format of a compressed string.
grSaveWMF	Saves a chart that was drawn beforehand in WMF format.
grScatter3DAddData	Adds a new point to display in a 3D Scatter chart.
grScatter3DAltitudeColor	Defines the different colors used according to the altitude levels of a series found in a 3D Scatter chart.
grScatter3DDeleteAltitudeColor	Deletes the altitude colors specified by grScatter3DAltitudeColor.
grScatter3DDeleteMarkCaption	Deletes the captions of marks found in a 3D Scatter chart
grScatter3DGridlines	Displays the gridlines for the different planes of a 3D Scatter chart.
grScatter3DLinkPoint	Links (or not) the points found in a "3D Scatter" chart.
grScatter3DMarkCaption	Used to specify the mark caption for a 3D Scatter chart.
grScatter3DProjection	Indicates whether the points found in a series of a 3D Scatter chart must be be projected on a given plane.
grScatterAddDataXY	Adds a data into a "Scatter" chart.
grScatterGetDataXY	Retrieves data from a "Scatter" chart.
grScatterLinkPoint	Links (or not) the points found in a "Scatter" chart.
grScatterPointSize	Defines the size of points in a "Scatter" chart.
grScatterSeriesColor	Initializes the color of a series in a "Scatter" chart.
grScatterSeriesLabel	Initializes the label of data series in a "Scatter" chart.
grSeriesColor	Initializes the color of a series or the color of a section.
grSeriesLabel	Initializes the label of a data series in a chart.
grSeriesLineType	Modifies the type of line for a series found in a Line, Area, Scatter and Radar chart.
grSeriesOpacity	Modifies the opacity factor of a series in a chart.
grSeriesPointType	Modifies the type of point for a series found in a Line, Area, Scatter and Radar chart.
grSeriesSecondaryAxis	Defines whether a series will be drawn on the secondary axis.
grSeriesType	Defines the type of series used in a composite chart (chart containing several types of charts).
grSmoothing	Smoothes a Line chart or a Scatter chart by using the "cubic splines" algorithm.
grSourceCategoryLabel	Defines the source of the category labels.
grSourceSeries	Defines the source of a series.
grStartAngle	Sets the starting angle of the first section in the following types of chart: Pie, Semi-circular or Donut. Sunburst. Radial Bar chart.
grStockAddData	Adds data into a stock chart (candlestick, barcharts or minmax).
grStockGetData	Retrieves a data from a stock chart (candlestick, barcharts or minmax).
grSunburstAddData	Adds a data to a Sunburst chart.
grSunburstGetData	Retrieves a numeric value from a Sunburst chart.
grSunburstPullOut	Pulls out a section (or all the sections) in a Sunburst chart.
grSunburstRootSection	Changes or specifies the path of the root in a Sunburst chart.
grSunburstSectionColor	Changes the color of a section in a Sunburst chart.
grSunburstStartAngle	Specifies the starting angle of the first section in a Sunburst chart.
grSurfaceAddData	Adds a data into a Surface chart.
grSurfaceAltitudeColor	Defines the color used for the altitude (Z axis) of a surface chart.
grSurfaceDeleteAltitudeColor	Deletes the altitude colors specified by grSurfaceAltitudeColor.
grSurfaceDeleteMarkCaption	Deletes the captions of marks found in a Surface chart.
grSurfaceGetData	Retrieves a data from a Surface chart.
grSurfaceGridlines	Displays the gridlines for the different planes of a Surface chart.
grSurfaceMarksCaption	Allows you to specify the mark caption for a Surface chart.
grSurfaceMesh	Enables or disables the mesh on a Surface chart.
grTimeLevelMask	Defines the display mask for a level of time scale in a chart.
grTimeLevelMax	Defines the number of levels to display in the time scale of a chart as well as the maximum level.
grTitle	Modifies the caption and/or position of the chart title.
grTitleFont	Modifies the font used for the chart title.
grTooltip	Displays and formats: the tooltip associated with each section of a chart (section of a Pie chart, column of a Column chart, etc.). This function also gets the characteristics of the tooltip associated with each section of the chart. a custom tooltip, associated with a point.
grType	Identifies or modifies the type of chart.
grWaffleSize	Defines the number of rows and columns in a Waffle chart.
grWaffleTypeCell	Defines the shape of cells in a Waffle chart.
grWaterfallCategoryType	Indicates the category type of a Waterfall chart.
grWaterfallColor	Indicates the color for a type of category in a Waterfall chart.
grWndSize	Defines the size of the window containing the chart.
grZoom	Defines the zoom of a chart.

Related Examples:

Unit examples (WINDEV): The Chart control

[ + ] Using the Chart control of WINDEV.
The chart control is used to directly edit the data that will be displayed in the chart.
This data can come from a table column, a list box, a WLanguage array. It can also be filled by programming.

Training (WINDEV): WD Chart

[ + ] This example presents the different uses of the Chart control.
Different types of charts are presented:
- Pie
- Sunburst
- Line
- Scatter
- Column
- Area
- etc.

The main features presented here are the possibility to customize of charts from the code, as well as to fill the chart from an HFSQL data file, or in the editor.

Training (WINDEV): WD Drawing on Chart

[ + ] This example is based on an internal component used to draw elements on a chart control:
- Min/Max areas
- Various areas
- Flags
- Plots and trackers
...

Unit examples (WINDEV): The Chart control (click management)

[ + ] Customizing the click on a Pie chart.
Here, the section clicked by the user is pulled out by the application.
To implement this behavior, all you have to do is use grInfoXY (to identify the section clicked) and grPiePullOut (to pull out the section).

Complete examples (WINDEV): WD Loan

[ + ] The power of WINDEV and the ease-of-use of WLanguage have allowed us to develop this application within a single day!

This example is used to simulate loans and to:
- calculate the amount of the monthly repayments from the amount borrowed
- calculate the amount that can be borrowed from a given monthly repayment
- calculate the income of an investment from a monthly payment

For each case, you have the ability to view the amortization table corresponding to your parameters.

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, ...)

Cross-platform examples (WINDEV Mobile): WM Click on Chart

[ + ] The "WM Click on Chart" example proposes a solution for pulling out the sections of a Pie chart via a simple click.
This example includes a control template named "TPLC_PullOutChart". This control template is used to pull out the chart sections via a simple click.
To include this feature in another application, all you have to do is import the "TPLC_PullOutChart" template.