MatrixLayer::CreateCopy

Description

Create a copy of the matrix window matlayerSource and attaches it to the object.

Syntax

BOOL CreateCopy( MatrixLayer & matlayerSource, int nOption = CREATE_VISIBLE_SAME, DWORD dwCtrl = DCTRL_COPY_DEFAULT )

Parameters

matlayerSource
[output] the matrix whose copy is made
nOption
[input] visibility determined by CREATE_TEMP etc (OC_const.h). default is CREATE_VISIBLE_SAME.
dwCtrl
[input] control of copy via DCTRL_COPY_DATA etc (OC_const.h). default is DCTRL_COPY_DEFAULT.

Return

TRUE for success; otherwise FALSE.

Examples

EX1

//Create a copy of matrix window.
void MatrixLayer_CreateCopy_Ex1()
{
    MatrixLayer mat;
    
    MatrixPage mp = Project.MatrixPages(0);
    if(!mp)
        return;
    
    MatrixLayer matSource(mp.GetName());
    
    int nOption = CREATE_VISIBLE_SAME;
    BOOL bRet = mat.CreateCopy(matSource, nOption);
    
    out_int("bRet = ", bRet);
}

Remark

See Also

Worksheet::CreateCopy

header to Include

origin.h