2.2.4.27.3 MatrixLayer::CreateCopy

CreateCopy

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

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