2.2.4.27.23 MatrixLayer::SetSize

SetSize

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

Description

Set the number of MatrixObjects in a matrix layer.

Syntax

BOOL SetSize( int nNumObjs = 1, int nNumRows = -1, int nNumCols = -1, DWORD dwCntrl = OCD_RESTORE | OCD_INITDATA )

Parameters

nNumObjs: [input] number of matrix objects to have in the matrix layer. use -1 to keep number of objects.
nNumRows: [input] number of rows each matrix object is to have. -1 to keep current.
nNumCols: [input] number of columns each matrix object is to have. -1 to keep current.
dwCntrl: [input] flags for specifying options (OC_const.h). default is OCD_RESTORE | OCD_INITDATA.

Return

TRUE for success, FALSE for failure

Examples

EX1

//Set the number of MatrixObjects in a matrix layer. 
void MatrixLayer_SetSize_Ex1()
{
    MatrixPage mp = Project.MatrixPages(0);
    if(!mp)
        return;
    
    MatrixLayer ml(mp.GetName());
    ml.SetSize();
}