Release 10.1A: OpenEdge Development:
Progress Dynamics Advanced Development

> ## Paging methods

> This section contains information about paging methods.

> ##### assignPageProperty

> Use the `assignPageProperty` procedure to assign a property value to all the objects on the current page. If you must set a property on a page that is not the current page, you can reset the `CurrentPage` property to the page you want, run the procedure, and then set it back, as shown:

>     Procedure assignPageProperty:
>       Params: INPUT PARAMETER pcProp  AS CHARACTER
>               INPUT PARAMETER pcValue AS CHARACTER.
>       Candidate for calling

> ##### deletePage

> Use the `deletePage` procedure to delete all the objects on the specified page, as shown:

>     Procedure deletePage:
>       Params: INPUT PARAMETER piPageNum AS INTEGER.
>       Candidate for: calling

> ##### hidePage

> Use the `hidePage` procedure to hide all the objects on a page. Normally your code does not call this procedure directly, since the `selectPage` procedure automatically hides whatever was on the previous page, as shown:

>     Procedure hidePage:
>       Params: INPUT PARAMETER piPageNum AS INTEGER.

> ##### initPages

> Use the `initPages` procedure to initialize pages simultaneously. Normally pages are initialized when they are first viewed. The first page to be viewed is stored in the `StartPage` property, and all the objects on the page are started, initialized, and viewed when the window is run. Sometimes, however, you must initialize other pages at the same time in order to be able to create links to and from them, or to have objects prepared to receive data from objects on other pages. In this case, you can call `initPages` and pass it a list of the pages to be initialized on startup of the window, as shown:

>     Procedure initPages:
>       Params:  INPUT PARAMETER pcPageList AS CHARACTER.
>         Candidate for: calling

> ##### viewPage

> Use the `viewPage` procedure when you want another page to be displayed without hiding the objects on the current page. Normally this would be when the new page is in fact a different window, which you want to have appear in addition to the window containing the folder. Otherwise, when you want to hide one page and see another, run `selectPage`, as shown:

>      Procedure viewPage:
>       Params: INPUT PARAMETER piPageNum AS INTEGER.
>       Candidate for: calling

> ##### selectPage

> Use the `selectPage` support procedure when you want to switch the folder display from one page to another. It hides the objects on the current page, resets the current page to the `INPUT` parameter, and views the objects on that new page, as shown:

>     Procedure selectPage:
>       Params: INPUT PARAMETER piPageNum AS INTEGER.
>       Candidate for: calling

> ##### targetPage

> Use the `targetPage` `INTEGER` support function to return the page that a specified object is on. Pass in the procedure handle of the object, as shown:

>     Function targetPage()
>       Params:  phObject AS HANDLE.
>     Returns:  INTEGER

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095