CreateDotTheme()

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
CreateTheme()	Creates a color or pattern theme on the current layer
CreateChartTheme()	Creates a pie or bar chart theme on the current layer
CreateContinuousTheme()	Creates a continuous (scaled-symbol) theme on the current layer
DestroyTheme()	Removes the definition of a theme from the current layer
GetTheme()	Gets information about a theme
GetThemes()	Gets a list of themes defined on the current layer
ShowTheme()	Displays a theme on the current layer