Class

# ChartScatterDataset

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

## Description

Used to provide the data for a `Chart</api/user_interface/controls/chart>` scatter chart.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                     | Type                                                            | Read-Only | Shared |
|----------------------------------------------------------|-----------------------------------------------------------------|-----------|--------|
| `AllowInteraction<chartscatterdataset.allowinteraction>` | `Boolean</api/data_types/boolean>`                              |           |        |
| `AllowPopover<chartscatterdataset.allowpopover>`         | `Boolean</api/data_types/boolean>`                              |           |        |
| `ChartType<chartscatterdataset.charttype>`               | `ChartTypes<chartscatterdataset.charttypes>`                    |           |        |
| `DataColor<chartscatterdataset.datacolor>`               | `ColorGroup</api/graphics/colorgroup>`                          |           |        |
| `Fill<chartscatterdataset.fill>`                         | `Boolean</api/data_types/boolean>`                              |           |        |
| `IsLegendVisible<chartscatterdataset.islegendvisible>`   | `Boolean</api/data_types/boolean>`                              |           |        |
| `IsVisible<chartscatterdataset.isvisible>`               | `Boolean</api/data_types/boolean>`                              |           |        |
| `Label<chartscatterdataset.label>`                       | `String</api/data_types/string>`                                |           |        |
| `Style<chartscatterdataset.style>`                       | `ChartLinearStyle</api/user_interface/charts/chartlinearstyle>` |           |        |
| `Tag<chartscatterdataset.tag>`                           | `Variant</api/data_types/variant>`                              |           |        |
| `Transparency<chartscatterdataset.transparency>`         | `Double</api/data_types/double>`                                |           |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                           | Parameters                                                                                                                                                                         | Returns                                                                   | Shared |
|----------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|--------|
| `AddDatapoint<chartscatterdataset.adddatapoint>`               | `ParamArray</api/language/paramarray>` DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`                                                      |                                                                           |        |
| `AddDatapointAt<chartscatterdataset.adddatapointat>`           | Index As `Integer</api/data_types/integer>`, DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`                                                |                                                                           |        |
| `Constructor<chartscatterdataset.constructor0>`                | DataColor As `ColorGroup</api/graphics/colorgroup>`, DataPoint() As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`                                      |                                                                           |        |
| `Constructor<chartscatterdataset.constructor1>`                | DataColor As `ColorGroup</api/graphics/colorgroup>`, `ParamArray</api/language/paramarray>` dataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>` |                                                                           |        |
| `Count<chartscatterdataset.count>`                             |                                                                                                                                                                                    | `Integer</api/data_types/integer>`                                        |        |
| `DatapointAt<chartscatterdataset.datapointat>`                 | index As `Integer</api/data_types/integer>`                                                                                                                                        | `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>` |        |
| `LastIndex<chartscatterdataset.lastindex>`                     |                                                                                                                                                                                    | `Integer</api/data_types/integer>`                                        |        |
| `RemoveAllDatapoints<chartscatterdataset.removealldatapoints>` |                                                                                                                                                                                    |                                                                           |        |
| `RemoveDatapointAt<chartscatterdataset.removedatapointat>`     | index As `Integer</api/data_types/integer>`                                                                                                                                        |                                                                           |        |

## Enumerations

<div id="chartscatterdataset.charttypes">

<div class="rst-class">

forsearch

</div>

</div>

ChartScatterDataset.ChartTypes

### ChartTypes

> The types of charts that can be used to represent the dataset.
>
> | Enum    | Description                                                                                              |
> |---------|----------------------------------------------------------------------------------------------------------|
> | Bubble  | A chart made up of circles allowing the representation of three dimensions of data.                      |
> | Default | A Scatter chart. As default, this type will be chosen if you don't choose one.                           |
> | Scatter | A chart that uses Cartesian coordinates to display values for typically two variables for a set of data. |

## Property descriptions

<div id="chartscatterdataset.allowinteraction">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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="chartscatterdataset.allowpopover">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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="chartscatterdataset.charttype">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.ChartType

**ChartType** As `ChartTypes<chartscatterdataset.charttypes>`

> The type of chart that used to represent the dataset in the chart.

<div id="chartscatterdataset.datacolor">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.DataColor

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

> The color that represents the dataset in the chart.

<div id="chartscatterdataset.fill">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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="chartscatterdataset.islegendvisible">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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="chartscatterdataset.isvisible">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.IsVisible

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

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

<div id="chartscatterdataset.label">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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="chartscatterdataset.style">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.Style

**Style** As `ChartLinearStyle</api/user_interface/charts/chartlinearstyle>`

> The style for the value's endpoint and drawing of the connection line between values.

<div id="chartscatterdataset.tag">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.Tag

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

> A place to store data associated with the dataset.

<div id="chartscatterdataset.transparency">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.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.

## Method descriptions

<div id="chartscatterdataset.adddatapoint">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.AddDatapoint

**AddDatapoint**(`ParamArray</api/language/paramarray>` DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`)

> Adds the datapoint or datapoints to the dataset.

<div id="chartscatterdataset.adddatapointat">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.AddDatapointAt

**AddDatapointAt**(Index As `Integer</api/data_types/integer>`, DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`)

> Adds the *DataPoint* to the dataset at the *Index* passed.

<div id="chartscatterdataset.constructor0">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.Constructor

**Constructor**(DataColor As `ColorGroup</api/graphics/colorgroup>`, DataPoint() As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`)

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

Creates a new <span class="title-ref">ChartScatterDataset</span> from the values passed.

</div>

<div id="chartscatterdataset.constructor1">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.Constructor

**Constructor**(DataColor As `ColorGroup</api/graphics/colorgroup>`, `ParamArray</api/language/paramarray>` DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`)

> Creates a new <span class="title-ref">ChartScatterDataset</span> from the values passed.

<div id="chartscatterdataset.count">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.Count

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

> Returns the number of the dataset.

<div id="chartscatterdataset.datapointat">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.DatapointAt

**DatapointAt**(index As `Integer</api/data_types/integer>`) As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`

> Returns the datapoint at the *index* passed.

**DatapointAt**(index As `Integer</api/data_types/integer>`, `Assigns</api/language/assigns>` DataPoint As `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`)

> Sets the datapoint at the *index* passed.

<div id="chartscatterdataset.lastindex">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.LastIndex

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

> Returns the last index of the dataset.

<div id="chartscatterdataset.removealldatapoints">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.RemoveAllDatapoints

**RemoveAllDatapoints**

> Removes all datapoints from the dataset.

<div id="chartscatterdataset.removedatapointat">

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

</div>

<div class="rst-class">

forsearch

</div>

ChartScatterDataset.RemoveDatapointAt

**RemoveDatapointAt**(index As `Integer</api/data_types/integer>`)

> Removes the datapoint at the *index* passed from the dataset.

## 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; `ChartScatterDatapoint</api/user_interface/charts/chartscatterdatapoint>`, `ChartDataset</api/user_interface/charts/chartdataset>`, `ChartLinearDataset</api/user_interface/charts/chartlineardataset>`, and `ChartCircularDataset</api/user_interface/charts/chartcirculardataset>` classes.

</div>