2.1.14.3.26 page_set_active_layer


Description

Set one of the layer in the given page to be the active layer

Syntax

bool page_set_active_layer( Page & pg, int nLayer, bool bActiveLayerOnly = true )

Parameters

pg
[input] page (Graph or Matrix or Workbook) to set
nLayer
[input] zero offset layer(sheet) index to set as active
bActiveLayerOnly
[input] if true the only active layer in page, otherwise, layer will be active in project.

Return

TRUE if pg is the active window and nLayer is >=0 and less then the total number of layers in the page

Examples

EX1

void page_set_active_layer_ex()
{
	Worksheet wks=Project.ActiveLayer();  
 	if(page_set_active_layer(wks.GetPage(),wks.GetIndex()+1))  
 		printf("Active layer have been set to layer %s",Project.ActiveLayer().GetName());
}

Remark

See Also

Header to Include

origin.h

Reference