Column::Attach

Attach

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

Description

Attach the column object to a Worksheet column by worksheet name and column number

Attach the column object to a Worksheet column using a worksheet object and column number

Syntax

BOOL Attach( LPCSTR lpcszWksName, UINT iColNum )

BOOL Attach( Worksheet & wks, UINT iColNum )

Parameters

lpcszWksName: [input] name of the worksheet.
iColNum: [input] column number in the worksheet at which the column should be attached.

wks: [input] worksheet object.
iColNum: [input] column number in the worksheet at which the column should be attached.

Return

True for success; false otherwise

Examples

EX1

// Worksheet with at least one column must exist in  project
void Column_Attach_Ex1()
{
    Column colMy;
    WorksheetPage wp = Project.WorksheetPages(0);
    if(!wp)
        return;
    
    if( colMy.Attach(wp.GetName(), 0) )
        out_str("A column is attached to the first column of worksheet "+Project.WorksheetPages(0).GetName());
    else
        out_str("Attach error!");
}

EX2

// Worksheet with at least one column must exist in project
void Column_Attach_Ex2()
{
    WorksheetPage wp = Project.WorksheetPages(0);
    if(!wp)
        return;
    
    Worksheet wksMy(wp.GetName());
    Column colMy;
    if (colMy.Attach(wksMy, 0))
        out_str("A column is attached to the first column of worksheet "+Project.WorksheetPages(0).GetName());
    else
        out_str("Attach error!");
}