grCreate (Function)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones de gráficos

Creating and drawing a chart programmatically
Drawing several charts at the same time
Charts and threads
Default values of a chart created programmatically

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

grCreate (Function)

Creates a specific type of chart.

Remarks:

It is recommended to create a Chart control directly rather than using grCreate. Indeed, the Chart control offers many more features.
This function can only be used to create a chart programmatically. This function cannot be used in the window editor, page editor or report editor.

Ejemplo

// Create a column chart 
// (and save the parameters modified by the user)
grCreate("MyChart", grColumn)

Sintaxis

grCreate(<Chart name> , <Chart type> [, <Persistence>])

<Chart name>: Character string

Name of chart to create. This name will be used by all functions for chart management. Warning: this name must not correspond to the name of a Chart control field..

<Chart type>: Constant

Specifies the type of chart to create:
gr3DSAreaStacked 3D chart of stacked areas.
gr3DSAreaDepth 3D chart of areas shown one behind the other.
gr3DSLine 3D line chart.
gr3DSCylinderColStacked 3D stacked bar chart.
The bars are represented by cylinders.
gr3DSCylinderColClustered 3D clustered column chart
The bars are represented by cylinders.
gr3DSCylinderColDepth 3D depth column chart: series are displayed one behind the other.
The bars are represented by cylinders.
gr3DSColumnStacked 3D stacked bar chart.
The bars are represented by 3D rectangles. This type of chart does not support negative values.
gr3DSColumnClustered 3D clustered column chart.
The bars are represented by 3D rectangles.
gr3DSColumnDepth 3D depth column chart: series are displayed one behind the other.
The bars are represented by 3D rectangles.
gr3DSMinMax 3D Stock chart displaying the difference between the minimum stock value and the maximum stock value
gr3DSScatter 3D Scatter chart.
gr3DSPie 3D Pie chart.
grArea Area chart (see example of Area chart).
grPolarArea Polar Area chart (see example of Polar Area chart).
grBarCharts Stock chart (see example of Stock chart).
grCandlestick Candlestick stock chart (see example of Stock chart).
grRadialBar Radial Bar chart.
grLine Line chart (see example of Line chart).
grDonut Donut chart. See example of Donut chart.
grFunnel Funnel chart. See example of Funnel chart.
grBubbleChart Bubble chart (see example of bubble chart).
grHeatMap Heatmap chart (see example of Heatmap chart).
grSemiCircular Semi-circular chart (see example of Semi-circular chart).
grColumn Column chart (see example of Column chart).
grColumnStacked Stacked Column chart. This type of chart does not support negative values.
grMinMax Stock chart displaying the difference between the minimum stock value and the maximum stock value (see example of Stock chart)
grScatter Scatter chart (see example of Scatter chart).
grScatter3D 3D Scatter chart (see example of 3D Scatter chart).
Novedad versión 2025
grPercentageImaged
Percentage graph (see example of a Percentage graph illustrated).
grPyramid Pyramid chart (see example of Pyramid chart).
grRadar Radar chart (see example of Radar chart).
grPie Pie chart (see example of Pie chart).
grSunburst Sunburst chart. See example of Sunburst chart.
grSurface Surface chart (see example of Surface chart).
grWaffleChart Waffle chart (see example of Waffle chart).
grWaterfall Waterfall chart (see example of Waterfall chart).
grRangeArea Range Area chart (see example of Range Area chart).

The type of chart can be modified later by grType.

<Persistence>: Optional boolean

True (default) to save graph modifications made by the user via the context menu,
False not to save these modifications.

Observaciones

Creating and drawing a chart programmatically

To create and draw a chart:

create the chart (grCreate),
add data (grAddData, grStockAddData and grScatterAddDataXY),
define the chart destination with the following functions:
draw the chart (grDraw).

Drawing several charts at the same time

Several charts with the same name cannot exist at the same time.

To draw several charts at the same time (in one or more windows for example), different chart names must be specified.

Charts and threads

A single chart can be handled in a thread.

Consequences:

Two threads cannot handle the same chart.
A chart created in a thread is automatically destroyed at the end of this thread. The chart exists in the thread that contains the call to grCreate.

Default values of a chart created programmatically

The default values of a chart are as follows:

Context menu enabled (can be configured by grMenu and grMenuOption).
Automatic marks on axes (can be configured by grInterval).
The colors are selected according to a preset order among a set of 13 colors (can be configured by grSeriesColor).
The color gradients are available (can be configured by grGradient).
File size (can be configured by grWndSize).
Window size (can be configured by grWndSize).
No label for the series (can be configured by grSeriesLabel).
No caption for the elements (can be configured by grCategoryLabel and grLabel).
No legend (can be configured by grLegend).
No title for the chart (can be configured by grTitle).
No title for the axes (can be configured by grAxisTitle).
No gridlines (can be configured by grGridlines).
No data (elements can be added by grAddData).
No destination (can be configured by grDestinationBMP, grDestinationControl, grDestinationEMF, grDestinationWnd and grDestinationWMF).
No chart display (to draw the chart, use grDraw).
No raised effect (can be configured by grRaised).
For the pie charts, the starting angle is equal to 0 (can be configured by grPieStartAngle).
For the bar charts and the MinMax charts, the spacing between two categories is equal to 10 pixels (can be configured by grColumnSpacing).
For scatter charts, the points are linked and their size is equal to 1 (can be configured by grScatterLinkPoint and grScatterPointSize).

Clasificación Lógica de negocio / UI: Código neutro

Componente: wd300grf.dll

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 28/03/2025

Señalar un error o enviar una sugerencia | Ayuda local