Maptitude GISDK Help |
Creates a dot-density theme on the current layer.
theme_name = CreateDotTheme(string identifier, array field_specs, real dot_value, array options)
Argument |
Contents |
identifier |
The desired name for the theme |
field_specs |
An array of strings that contains the field specs for the fields in the theme |
dot_value |
Value per dot, or null to set this value automatically |
Option |
Type |
Contents |
Title |
String |
Title of the theme, as it appears in the legend (defaults to theme_name) |
Data Source |
String |
Indicates which data are scanned to determine the minimum and maximum values. If "All" (the default), all features are scanned; if "Screen" only features appearing on the screen in the current map are scanned |
A string indicating the actual name of the theme.
CreateDotTheme() creates a theme on the current layer, which must be an area layer.
All fields in field_specs must be mappable to the current layer and must belong to the same view.
If dot_value is null, CreateDotTheme() scans the data for the layer to find an appropriate dot value.
After creating the theme, you need to set theme styles; for more information, see Theme Styles.
To display the theme, call ShowTheme(); for more information, see Themes.
CreateDotTheme("HH by Income", |
// the name of the theme |
{"Zip.[Low Income HH]", |
|
"Zip.[Avg. Income HH]", |
// Three fields are used |
"Zip.[High Income HH]"}, |
|
50, ) |
// One dot for 50 HHs |
Error |
Meaning |
NotFound |
There is no current layer, or the specified field(s) do not exist on the current layer |
Escape |
The user interrupted scanning of the data |
Error |
An argument or option has the wrong type or the wrong number of values; or an error occurred while scanning the data |
Function |
Summary |
Creates a color or pattern theme on the current layer |
|
Creates a pie or bar chart theme on the current layer |
|
Creates a continuous (scaled-symbol) theme on the current layer |
|
Removes the definition of a theme from the current layer |
|
Gets information about a theme |
|
Gets a list of themes defined on the current layer |
|
Displays a theme on the current layer |
©2025 Caliper Corporation | www.caliper.com |