Skip to content

Special Shadow-State Conditions

Tab Dialog and Tab Dialog Pages

Tab dialogs have items, so they support both the object and the item-shadowing mechanisms. You can shadow any tab button by setting its Item_Shadow_state property. When shadowed, the button will appear shadowed, and users will be unable to select that button and therefore unable to see the shadowed tab page.

Normally, you will not wish to set the Item_Shadow_state in the tab dialog. Instead, you will want to set this property inside the tab page. A special property named Button_Shadow_state supports this capability.

Tab pages actually support two types of shadowing: button shadowing and object shadowing. They provide different functionalities:

Enabled_State

If this property is set to false in a tab page, users will be allowed to navigate to the page and see its contents. They will not be able to navigate into the page. The focus will remain on the tab button.

Object MyTabDialog is a TabDialog
    Set Location to 10 10
    Set Size to 100 100

    Object My1stPage is a TabPage
    :
    End_Object

    Object My2ndPage is a TabPage
        Set Enabled_State to false // can view but not enter
    :
    End_Object
End_Object

Button_Shadow_State

If this property is set to true in a tab page, both the page and the button will be shadowed, making it impossible to ever display the shadowed tab page.

Object MyTabDialog is a TabDialog
    Set Location to 10 10
    Set Size to 100 100

    Object My1stPage is a TabPage
    :
    End_Object

    Object My2ndPage is a TabPage
        Set Button_Shadow_State to true // cannot view or enter
    :
    End_Object
End_Object

See Also

Shadowing