2.2.4.46.56 Worksheet::LabelsMerge

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

Description

Get/Set label rows' dynamic merge state.

Syntax

int LabelsMerge( vector<int> & vnLabels, vector<int> & vnMerges, bool bSet )

Parameters

vnLabels: [input/output] if getting (bSet=false), will retreive the currently showing label rows
vnMerges: [input/output] dynamic merge state of the corresponding label row, values are GMC_HORZ etc
bSet: [input] to set dynamic merge state or to get

Return

when get, count of the label rows with dynamic merge > GMC_NONE, when set, count of label rows that the dynamic merge state has been modified

Examples

EX1

vector<int> vnLabels, vnMerges;
if(wksSource.LabelsMerge(vnLabels, vnMerges, false) > 0)
    wksDest.LabelsMerge(vnLabels, vnMerges, true);

EX2

void LabelsMerge_ex()
{
	Worksheet wks = Project.ActiveLayer();
	
	vector<int> vnLabels, vnMerges;
	int nRet = wks.LabelsMerge(vnLabels, vnMerges, false);

	vnMerges.Replace(GMC_HORZ, GMC_NONE, MATREPL_TEST_EQUAL);
	nRet = wks.LabelsMerge(vnLabels, vnMerges, true);
	wks.GetPage().Refresh(1);
}