Class

# ChartCircularDataset

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

A dataset that can be used with Doughnut, Pie, PolarArea and Radar chart types.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                             | Type                                   | Read-Only | Shared |
|------------------------------------------------------------------|----------------------------------------|-----------|--------|
| `AllowInteraction<desktopchartcirculardataset.allowinteraction>` | `Boolean</api/data_types/boolean>`     |           |        |
| `AllowPopover<desktopchartcirculardataset.allowpopover>`         | `Boolean</api/data_types/boolean>`     |           |        |
| `DataColor<desktopchartcirculardataset.datacolor>`               | `ColorGroup</api/graphics/colorgroup>` |           |        |
| `Fill<desktopchartcirculardataset.fill>`                         | `Boolean</api/data_types/boolean>`     |           |        |
| `HasInlineLabels<desktopchartcirculardataset.HasInlineLabels>`   | `Boolean</api/data_types/boolean>`     |           |        |
| `IsLegendVisible<desktopchartcirculardataset.islegendvisible>`   | `Boolean</api/data_types/boolean>`     |           |        |
| `IsVisible<desktopchartcirculardataset.isvisible>`               | `Boolean</api/data_types/boolean>`     |           |        |
| `Label<desktopchartcirculardataset.label>`                       | `String</api/data_types/string>`       |           |        |
| `Tag<desktopchartcirculardataset.tag>`                           | `Variant</api/data_types/variant>`     |           |        |
| `Transparency<chartcirculardataset.transparency>`                | `Double</api/data_types/double>`       |           |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                       | Parameters                                                                                                                                      | Returns                                | Shared |
|------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|--------|
| `AddRow<desktopchartcirculardataset.addrow>`               | value As `Double</api/data_types/double>`, valueColor As `Color</api/data_types/color>`                                                         |                                        |        |
|                                                            | value As `Double</api/data_types/double>`, valueColor As `ColorGroup</api/graphics/colorgroup>`                                                 |                                        |        |
| `AddRowAt<desktopchartcirculardataset.addrowat>`           | index As `Integer</api/data_types/integer>`, value As `Double</api/data_types/double>`, valueColor As `Color</api/data_types/color>`            |                                        |        |
|                                                            | index As `Integer</api/data_types/integer>`, value As `Double</api/data_types/double>`, valueColor As `ColorGroup</api/graphics/colorgroup>`    |                                        |        |
| `ColorAt<desktopchartcirculardataset.colorat>`             | index As `Integer</api/data_types/integer>`                                                                                                     | `ColorGroup</api/graphics/colorgroup>` |        |
|                                                            | index As `Integer</api/data_types/integer>`, `Assigns</api/language/assigns>` valueColor As `ColorGroup</api/graphics/colorgroup>`              |                                        |        |
| `Constructor<desktopchartcirculardataset.constructor0>`    | Label As `String</api/data_types/string>`, DataPoints() As `Double</api/data_types/double>`, Colors() As `Color</api/data_types/color>`         |                                        |        |
|                                                            | Label As `String</api/data_types/string>`, DataPoints() As `Double</api/data_types/double>`, Colors() As `ColorGroup</api/graphics/colorgroup>` |                                        |        |
| `Count<chartcirculardataset.count>`                        |                                                                                                                                                 | `Integer</api/data_types/integer>`     |        |
| `LastIndex<chartcirculardataset.lastindex>`                |                                                                                                                                                 | `Integer</api/data_types/integer>`     |        |
| `RemoveAllRows<desktopchartcirculardataset.removeallrows>` |                                                                                                                                                 |                                        |        |
| `RemoveRowAt<desktopchartcirculardataset.removerowat>`     | Index As `Integer</api/data_types/integer>`                                                                                                     |                                        |        |
| `RowAt<desktopchartcirculardataset.rowat>`                 | index As `Integer</api/data_types/integer>`                                                                                                     | `Double</api/data_types/double>`       |        |
|                                                            | index As `Integer</api/data_types/integer>`, `Assigns</api/language/assigns>` value As `Double</api/data_types/double>`                         |                                        |        |

## Property descriptions

<div id="desktopchartcirculardataset.allowinteraction">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.AllowInteraction

**AllowInteraction** As `Boolean</api/data_types/boolean>`

> When `True</api/language/false>` legends can be interacted with and clicking on one raises the Pressed event. The default is `True</api/language/true>`.

<div id="desktopchartcirculardataset.allowpopover">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.AllowPopover

**AllowPopover** As `Boolean</api/data_types/boolean>`

> When `True</api/language/false>`, the associated dataset will display the Popover when the mouse is over any of its datapoints/area. The default is `True</api/language/true>`.

<div id="desktopchartcirculardataset.datacolor">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.DataColor

**DataColor** As `ColorGroup</api/graphics/colorgroup>`

> The color to be used when drawing the graphics in the chart that represent the dataset.

<div id="desktopchartcirculardataset.fill">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Fill

**Fill** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the graphical object in the chart that represents the data will be filled in with a color. The default is `False</api/language/false>`.

<div id="desktopchartcirculardataset.hasinlinelabels">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.HasInlineLabels

**HasInlineLabels** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the labels are displayed near the data rather than only in the legend.

<div id="desktopchartcirculardataset.islegendvisible">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.IsLegendVisible

**IsLegendVisible** As `Boolean</api/data_types/boolean>`

> When `True</api/language/false>` the legend is drawn on the chart. The default is `True</api/language/true>`.

<div id="desktopchartcirculardataset.isvisible">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.IsVisible

**IsVisible** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the data will be drawn in the chart.

<div id="desktopchartcirculardataset.label">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Label

**Label** As `String</api/data_types/string>`

> The label that will appear in the chart with the graphics that represent the dataset.

<div id="desktopchartcirculardataset.tag">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Tag

**Tag** As `Variant</api/data_types/variant>`

> A place to store data associated with the dataset.

<div id="chartcirculardataset.transparency">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Transparency

**Transparency** As `Double</api/data_types/double>`

> Controls the level of transparency of the data when drawn. 0 is fully opaque. 100 is fully transparent.
>
> The default value is 50.

## Method descriptions

<div id="desktopchartcirculardataset.addrow">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.AddRow

**AddRow**(value As `Double</api/data_types/double>`, valueColor As `Color</api/data_types/color>`)

**AddRow**(value As `Double</api/data_types/double>`, valueColor As `ColorGroup</api/graphics/colorgroup>`)

> Adds a row with the *value* and color passed to the dataset.

<div id="desktopchartcirculardataset.addrowat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.AddRowAt

**AddRowAt**(index As `Integer</api/data_types/integer>`, value As `Double</api/data_types/double>`, valueColor As `Color</api/data_types/color>`)

**AddRowAt**(index As `Integer</api/data_types/integer>`, value As `Double</api/data_types/double>`, valueColor As `ColorGroup</api/graphics/colorgroup>`)

> Adds a row with the *value* and color passed to the dataset at the *index* passed.

<div id="desktopchartcirculardataset.colorat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.ColorAt

**ColorAt**(index As `Integer</api/data_types/integer>`) As `ColorGroup</api/graphics/colorgroup>`

> Returns the `ColorGroup</api/graphics/colorgroup>` associated with the value in the dataset at the *index* passed.

**ColorAt**(index As `Integer</api/data_types/integer>`, `Assigns</api/language/assigns>` valueColor As `ColorGroup</api/graphics/colorgroup>`)

> Sets the `ColorGroup</api/graphics/colorgroup>` associated with the value in the dataset at the *index* passed.

<div id="desktopchartcirculardataset.constructor0">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Constructor

**Constructor**(Label As `String</api/data_types/string>`, DataPoints() As `Double</api/data_types/double>`, Colors() As `Color</api/data_types/color>`)

**Constructor**(Label As `String</api/data_types/string>`, DataPoints() As `Double</api/data_types/double>`, Colors() As `ColorGroup</api/graphics/colorgroup>`)

> <div class="note">
>
> <div class="title">
>
> Note
>
> </div>
>
> `Constructors</api/language/constructor>` are special methods called when you create an object with the `New</api/language/new>` keyword and pass in the parameters above.
>
> </div>
>
> Creates a new dataset from the values passed.

<div id="chartcirculardataset.count">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.Count

**Count** As `Integer</api/data_types/integer>`

> Returns the number of the dataset.

<div id="chartcirculardataset.lastindex">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.LastIndex

**LastIndex** As `Integer</api/data_types/integer>`

> Returns the last index of the dataset.

<div id="desktopchartcirculardataset.removeallrows">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.RemoveAllRows

**RemoveAllRows**

> Removes all rows (data) from the dataset.

<div id="desktopchartcirculardataset.removerowat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.RemoveRowAt

**RemoveRowAt**(Index As `Integer</api/data_types/integer>`)

> Removes the row (data) at the *Index* passed from the dataset.

<div id="desktopchartcirculardataset.rowat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

ChartCircularDataset.RowAt

**RowAt**(index As `Integer</api/data_types/integer>`) As `Double</api/data_types/double>`

**RowAt**(index As `Integer</api/data_types/integer>`, `Assigns</api/language/assigns>` value As `Double</api/data_types/double>`)

> Gets or sets the row value at the *index* passed.

## Sample code

This example adds the dataset to any Chart (`Desktop</api/user_interface/desktop/desktopchart>`, `Mobile</api/user_interface/mobile/mobilechart>` or `Web</api/user_interface/web/webchart>`) control that has its type set to Doughnut:

``` xojo
Var sales() As Double = Array(345890.0, 421934, 456908, 567987)
Var colors() As Color = Array(Color.Red, Color.Green, Color.Yellow, Color.Blue)
Var ds As New ChartCircularDataset("Sales", sales, Colors)
Me.AddDataset(ds)
Me.AddLabels("Q1", "Q2", "Q3", "Q4")
```

## Compatibility

|                       |                      |
|-----------------------|----------------------|
| **Project Types**     | Desktop, Mobile, Web |
| **Operating Systems** | All                  |

<div class="seealso">

`ChartDataset</api/user_interface/charts/chartdataset>` parent class; `Chart</api/user_interface/controls/chart>` control; `ChartLinearDataset</api/user_interface/charts/chartlineardataset>` and `ChartScatterDataset</api/user_interface/charts/chartscatterdataset>` classes.

</div>