Tabset Frames

The TABSET frame type defines a container for a set of tabbed page frames. The container has no visible border and no tagtext that means, it has no displayed title.

Any normal frame defined directly within a TABSET frame will become a tabbed page frame, with its tag text displayed in the tab; selecting a tab will bring the tabbed page frame to the front, and hide the previously shown tabbed page frame. A page SHOWN event is raised for the tabbed page frame whenever the user interactively selects a new page tab.

Handling this event allows the AppWare to modify the content of gadgets on the selected page before it is displayed to the user.

Only one page can be visible at one time, and one page is always visible. To change the visible page programmatically, you have to set the new page visible — setting the current page invisible has no effect. It’s not possible to remove a tabbed-page from the set, but you can deactivate it, so it is inaccessible to the user.

The tabbed page frame may contain any form gadgets including normal frame gadgets.

To create a multi-paged tabbed form, you can define a dialog or document form with a single TABSET frame that contains a set of tabbed page frames, with each page containing the gadgets for the desired page of the form.

The form will automatically resize to take account of the largest tabbed page frame. There is an example showing the definition of tabbed frames in Complex Form Layout

You cannot nest TABSET frames.