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 i.e. 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 you interactively select 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 you.

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 you.

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 required 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.

An icon can be set on a given tab within a tabset. For further information, refer to Icons on Tabs.