Set Shade statement - MapBasic - 2023

MapInfo MapBasic Reference

Product type
Software
Portfolio
Locate
Product family
MapInfo
Product
MapInfo > MapBasic
Version
2023
Language
English
Product name
MapBasic
Title
MapInfo MapBasic Reference
First publish date
1985
Last updated
2023-09-12
Published on
2023-09-12T16:32:32.686312

Purpose

Modifies a thematic map layer. You can issue this statement from the MapBasic window in MapInfo Pro.

Syntax

Set Shade
	[ Window window_id ] { map_layer_id | "table ( theme_layer_id )" } 
		[ Style Replace { On | Off } ]
	... 

window_id is an integer window identifier.

map_layer_id is a SmallInt value, representing the layer number of a thematic layer.

table is the name of the table on which a thematic layer is based.

theme_layer_id is a SmallInt value, one or larger, representing which thematic layer to modify (for example, one represents the first thematic layer created).

Description

After you use the Shade statement to create a thematic map layer, you can use the Set Shade statement to modify the settings for that thematic layer. Issuing a Set Shade statement is analogous to clicking the Modify Theme command (on the LEGEND tab). The syntax of the Set Shade statement is identical to the syntax of the Shade statement, except for the way that the Set Shade statement identifies a map layer. A Set Shade statement can identify a layer by its layer number, as shown below:

Set Shade 
	Window i_map_winid 
	2 
	With Num_Hh_90 
	Graduated 0.0:0 11000000:24 Vary Size By "SQRT"

Or a Set Shade statement can identify a map layer by referring to the name of a table (the base table on which the layer was based), followed by a number in parentheses:

Set Shade 
	Window i_map_winid 
	"States(1)"
	With Num_Hh_90 
	Graduated 0.0:0 11000000:24 Vary Size By "SQRT"

The number in parentheses represents the number of the thematic layer. To modify the first thematic layer that was based on the States table, specify States(1), etc.

Style Replace On (default) specifies the layers under the theme are not drawn.

Style Replace Off specifies the layers under the theme are drawn, allowing for multi-variate transparent themes.

Style Replace On is the default and provides backwards compatibility with the existing behavior so that the underlying layers are not drawn.

See Also:

Shade statement