2.1.14.3.4 attach_or_create_sheet

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

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");
}