GetThemeSamples()

Summary

Gets sample objects indicating how features in a theme display on a map.

Syntax

sample_array = GetThemeSamples(string theme_name)

Argument	Contents
theme_name	The name of the theme

Returns

An array of sample points, sample lines, or sample areas, depending on the type of the layer and type of the theme. The following table shows the type of samples that are returned:

Type of Theme	Point Layer	Line Layer	Area Layer
Color	Point	Line	Area
Pattern	Point	Line	Area
Dot-Density	N/A	N/A	Point
Chart	Area	Area	Area

Notes

• GetThemeSamples() can be used for color themes, pattern themes, dot-density themes, and chart themes.

• All samples are based on the appearance of the theme in the current map.

Example

smp1 = GetThemeSamples ("Income Theme")

smp2 = GetThemeSamples ("Pop by Race")

Error Codes

Error Type	Meaning
NotFound	The theme does not exist

See Also

Function	Summary
GetSample()	Gets a sample object indicating how features in a layer or selection set display on a map
SamplePoint()	Creates a sample point object for use in a menu or dialog box
SampleLine()	Creates a sample line object for use in a menu or dialog box
SampleArea()	Creates a sample area object for use in a menu or dialog box
SaveSampleTomage()	Saves a sample object to an image file.
SetSampleText()	Creates a sample object based on an input sample with the specified text for use in a menu or dialog box