2.1.14.3.4 attach_or_create_sheet


Description

attach a Worksheet object by [Book]Sheet specification. Create if not found

Syntax

bool attach_or_create_sheet( Datasheet & wks, LPCSTR lpcszBookSheetName, int nCreate = CREATE_HIDDEN, bool bMatrixSheet = false )

Parameters

wks
[Output] The worksheet object to be attached
lpcszBookSheetName
[Input] The name of the attached worksheet
nCreate
[Input] Type of the created worksheet
bMatrixSheet
[Input] Created MatrixSheet or WorkSheet

Return

true for attach success or create success; otherwise false

Examples

EX1

//Befor run this example, make a datasheet (Matrixlayer or Worksheet) active in the project.
void attach_or_create_sheet_ex()
{	
	Datasheet dsDa;
	string strPage = Project.ActiveLayer().GetPage().GetName();		
	if(attach_or_create_sheet( dsDa, strPage))
		out_str("attach_success!");
	
	Datasheet dsDb;
	strPage = "[Book7]";//assume book7 doesn't exist.
	if(attach_or_create_sheet( dsDb, strPage,CREATE_HIDDEN,true))
		out_str("Create and attach a booksheet");
}

Remark

See Also

Header to Include

origin.h

Reference