Class: TabDialog

cObject
---cUIObject
------DfBaseObject
---------DfBaseWindow
------------DfBaseUIWindow
---------------DfBaseControl
------------------DfBaseList
---------------------DfBaseForm
------------------------DfBasetabDialog
---------------------------TabDialog_
------------------------------TabDialog
---------------------------------dbTabDialog_

A tab dialog is created by creating a TabDialog object and then creating TabPage objects inside it. Each tab page displays a tab with its name on it within the tab dialog at all times.

The dbTabDialog class is a data-aware class similar to the TabDialog class.

Sample

Object TabDialog1 is A TabDialog
    Set Size to 117 271
    Set Location to 10 15
 
    Object TabPage1 is a TabPage
        Set Label to "TabPage1"
        :
    End_Object
 
    Object TabPage2 is a TabPage
        Set Label to "TabPage2"
        :
    End_Object
 
End_Object

Syntax

Use windows

Object oObjectName is a TabDialog
    Set Size to height width
    Set Location to row column
    Set Rotate_Mode to RotateMode
    
    Object oObjectName is a TabPage
        :
    End_Object
 
    Object oObjectName is a TabPage
        :
    End_Object
 
End_Object

Note

The only visual objects that can be placed directly inside a TabDialog are TabPage objects. All other visual objects will be placed inside the TabPage objects.

If there is not room in the tab dialog to fit all of tab-page tabs, the tab dialog will allow the tab-page tabs to be scrolled, or, will create multiple rows of tabs.

Only basic objects (i.e., the non-db... objects such as Form, Edit, Button, Group, etc.) should be placed inside a TabPage. Data-aware objects (dbForm, dbEdit, dbGroup, etc.) must be placed inside a data-aware page, the dbTabPage. Do not place dbTabPage objects inside a TabDialog. Likewise, do not place TabPage objects inside a dbTabDialog.

Shadowing

Setting the enabled_state property to false will disable entry into all tab pages inside the TabDialog object. Individual pages can be disabled by setting the tab page's button_shadow_state to true (the tab cannot be selected and the tab page cannot be displayed) or by setting the page's enabled_state to false (the tab is enabled, the page can be displayed, but it cannot be entered).

Navigation

The rotate_mode property allows you to specify where next navigation should proceed from the last object of a tab page. Modes are supported to allow the focus to leave the TabDialog (RM_None), ring within the tab page (RM_Ring), ring within the tab dialog (RM_Rotate_in_Ring) and to rotate through all tab pages, exiting when the last object of the last page is exited (RM_Rotate).