Class: TabDialog

Properties | Events | Methods | Index of Classes

Created by creating a TabDialog object and then creating TabPage objects inside it

Hierarchy

cObject > cUIObject > DfBaseObject > DfBaseWindow > DfBaseUIWindow > DfBaseControl > DfBaseList > DfBaseForm > DfBaseTabDialog > TabDialog_ > TabDialog

Show full hierarchy and direct subclasses

• cObject
• cUIObject
  • DfBaseObject
  • DfBaseWindow
    • DfBaseUIWindow
    • DfBaseControl
      • DfBaseList
      • DfBaseForm
        • DfBaseTabDialog
        • TabDialog_
          • TabDialog
          • dbTabDialog_

Library: Windows Application Class Library

Package: Windows.pkg

Mixins: Tab_Dialog_Mixin

Description

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