2.2.4.34.25 PageBase::SetOrder

SetOrder

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

Description

Order, when >= 0, it is the order of the page in a slide show of the folder. When -1, the page is hidden from a slide show. Sets the order of a page in a given folder. If pFolder is NULL (default) will set its order in the current folder.

Syntax

BOOL SetOrder( int nOrder, Folder * pFolder = NULL )

Parameters

nOrder: [input] the desired order of the page in the folder
pFolder: [input] the folder where the order of the page is requested

Return

Returns non-zero if the folder contains the page or a shortcut to the page and the operation is successful, otherwise returs FALSE.

Examples

EX1

void PageBase_SetOrder_ex1()
{
    PageBase pb;
    pb = Project.Pages(); // Get the project's active page
    if( pb.IsValid() )
    {
    	int nOrder = 1;
        BOOL nRet = pb.SetOrder(nOrder);
        printf("The order is %d\n", pb.GetOrder());
    }
}