Maptitude GISDK Help

CreateDotTheme()

Summary

Creates a dot-density theme on the current layer.

 

Syntax

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

 

Returns

A string indicating the actual name of the theme.

 

Notes

Example

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 Codes

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

 

See Also

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

 

 

©2025 Caliper Corporation www.caliper.com