skip to main content
OpenEdge Development: AppBuilder
Frequently Used Dialogs : ADM pages manager
ADM pages manager
The button shown here is available in the Procedure Settings dialog box for objects that are members of the class SmartContainer:
ADM paging allows you to multiplex your display space in useful ways. But once you have a complex, paged design in place, managing all the SmartObjects can be quite a difficult task. AppBuilder provides the Pages dialog box to help with that.
Using the Pages dialog box, you can:
*Review the list of SmartObjects assigned to a page.
*Set the Design and Startup pages.
*Move SmartObjects from one page to another.
*Delete SmartObjects from a page.
*Delete whole pages.
*Exchange the SmartObject contents of any two pages.
Note: The Pages dialog box only provides help with SmartObjects. Other objects, whether basic ABL or ActiveX (OCX), are not shown by this dialog box.
To open the Pages dialog box, choose ToolsProcedure Settings, or the Procedure Settings button on the toolbar, then click Pages. Figure 51 shows the dialog box.
Figure 51: Pages dialog box
Reviewing the list of SmartObjects assigned to a page
To see the list of SmartObjects assigned to any page, click on the page number in the page in at the left side, or click Page and enter the desired page number in the small dialog box that appears in response.
Note: Choosing to set the page number through the Page button and dialog box only determines which page's contents are displayed in the right-hand list. It does not set the design page as it would do in other circumstances.
Setting the design or startup page
The paging system identifies two special pages:
*Design Page — Whenever you place a SmartObject, it always goes onto the current design page.
*Startup Page — Whenever you run an application that uses ADM paging, the startup page is always the initial page displayed.
See the “Special pages” section for a more complete discussion of the relationship between these pages and the default page 0 (zero).
To alter where you place future SmartObjects, or which SmartObjects appear at startup, click Design... or Start... as appropriate, and enter the desired number in the dialog box that appears. Note that the dialog boxes are identical apart from the text in their title bars. Be sure you are setting the appropriate value.
Moving a SmartObject between two pages
To move a SmartObject from one page to another, highlight the object in the listing for its current page, click Move to Page..., enter the destination page number in the Move to Page dialog box, and click OK. Note that you cannot move the object by cutting and pasting the list entry.
Exchanging the contents of two pages
To completely exchange the contents of two pages, one of which might be empty, in a single operation, highlight them both (shift-click to highlight the second) and then click Swap Pages. If one of the pages is empty, the swap operation will be equivalent to a move-all operation.
Deleting a SmartObject from a page
To delete a SmartObject from a page, highlight the object in the listing and click Delete SmartObject.
Deleting a page and all its SmartObjects
To delete a page and all SmartObjects on it, select the page number in the left-hand list, then click Delete. A question box prompts you for confirmation. On completion, the page number will no longer appear in the list. You can easily recreate the page by assigning some SmartObject to it.