Defining and managing tab pages – PB Docs 2019

• An embedded tab page

  In the painter, insert tab pages in the Tab control and add
  controls to those pages. An embedded tab page is of class UserObject,
  but is not reusable.

• An independent user object

  In the User Object painter, create a custom visual user object
  and add the controls that will display on the tab page. You can use
  the user object as a tab page in a Tab control, either in the painter
  or by calling OpenTab in a script. A tab page defined as an
  independent user object is reusable.

To create a new tab page within the Tab control:

1. Right-click in the tab area of the Tab control. Do not click a
   tab page.

2. Select Insert TabPage from the pop-up menu.

3. Add controls to the new page.

To define a tab page independent of a Tab control:

1. Select Custom Visual on the Object tab in the New dialog
   box.

2. In the User Object painter, size the user object to match the
   size of the display area of the Tab control in which you will use
   it.

3. Add the controls that will appear on the tab page to the user
   object and write scripts for their events.

4. On the user object’s property sheet, click the TabPage tab and
   fill in information to be used by the tab page.

To add a tab page that exists as an independent user object to a
Tab control:

1. Right-click in the tab area of the Tab control. Do not click a
   tab page.

2. Select Insert User Object from the pop-up menu.

3. Select a user object.

   The tab page is inherited from the user object you select. You
   can set tab page properties and write scripts for the inherited user
   object just as you do for tab pages defined within the Tab
   control.

   Editing the controls on the tab page user object

   You cannot edit the content of the user object within the Tab
   control. If you want to edit or write scripts for the controls,
   close the window or user object containing the Tab control and go
   back to the User Object painter to make changes.

To view a different tab page:

• Click the page’s tab.

  The tab page comes to the front and becomes the active tab page.
  The tabs are rearranged according to the Tab position setting you have
  chosen.

To reorder the tabs within a Tab control:

1. Click the Page Order tab on the Tab control’s property
   sheet.

2. Drag the names of the tab pages to the desired order.

To delete a tab page from a Tab control:

1. Click the page’s tab.

2. Right-click the tab page and select Cut or Clear from the pop-up
   menu.

Selecting tab controls and tab pages

As you click on various areas within a tab control, you will
notice the Properties view changing to show the properties of the tab
control itself, one of the tab pages, or a control on a tab page. Before
you select an item such as Cut from the pop-up menu, make sure that you
have selected the right object.

Clicking anywhere in the tab area of a tab control selects the tab
control. When you click the tab for a specific page, that tab page
becomes active, but the selected object is still the tab control. To
select the tab page, click its tab to make it active and then click
anywhere on the background of the page except on the tab itself.

Adding controls to an independent user object tab page

To add controls to an independent user object tab page, open it in
the User Object painter.

To add a control to an embedded tab page:

• Choose a control from the toolbar or the Insert menu and click
  the tab page, just as you do to add a control to a window.

  When you click inside the tab page, the tab page becomes the
  control’s parent.

To move a control from one tab page to another:

• Cut or copy the control and paste it on the destination tab
  page.

  The source and destination tab pages must both be embedded tab
  pages, not independent user objects.

To move a control between a tab page and the window containing
the Tab control:

• Cut or copy the control and paste it on the destination window
  or tab page.

  You cannot drag the control out of the Tab control onto the
  window.