Class: Container3d

Properties  Events  Methods    Index of Classes

This class creates visual container objects and by default, provides a gray background with a raised border having a three-dimensional (3-D) appearance.

Hierarchy

cObject
---cUIObject
------DfBaseObject
---------DfBaseWindow
------------DfBaseUIWindow
---------------DfBaseContainer
------------------DfBaseDialog
---------------------Container3d
------------------------BitmapContainer
------------------------cLinkLabel
------------------------Container
------------------------cScrollingClientArea
------------------------cScrollingContainer
------------------------cSplitterContainer
------------------------cSplitterContainerChild
------------------------dbContainer3d_
------------------------Dialog
------------------------MdiDialog
------------------------TabPage

Library: Windows Application Class Library

Package: Windows.pkg

Mixins: Standard_Container_Mixin Standard_Object_Mixin Label_Mixin dfAuto_Locate_Mixin Shadow_Mixin Bitmap_Support_Mixin RGB_Support_Temp_Mixin Help_Mixin

Description

The Container3d class creates visual container objects and by default, provides a gray background with a raised border having a three-dimensional (3-D) appearance. Objects based on this class will be contain controls (forms, buttons, edits, etc.) and other container objects (which will themselves contain controls).

Visual access for providing and managing objects of this class is provided in the Studio.

The dbContainer3d class is a data-aware class similar to the Container3d class.

Sample

Object Dlg is a Container3D
    Set Size to 70 150
    Set Location to 5 5

    Object F1 is a form
        Set Location to 10 70
        Set Size to 13 40
        Set Label to "Name:"
    End_Object

    Object Dlg1 is a Container3D
        Set Size to 30 130
        Set Location to 25 10
        Set Border_Style to border_StaticEdge // lowered edge

        Object F2 is a form
            Set Location to 10 70
            Set Size to 13 30
            Set Label to "Id:"
        End_Object

    End_Object

End_Object


Syntax

Use windows

Object object_name is a Container3D
    Set Size to height width
    Set Location to row column
    Set Border_Style to BorderMode
    :
End_Object


Of Special Note

This object's client_area_state is set to true. When the object is activated it will activate all child objects and then give the focus to the first focusable object. The ring_state of this object is set to false, allowing for navigation out of the container.

Container3d and Group objects are used to group objects together. They are functionally identical and differ only in appearance.

Only objects of the basic classes(i.e., the non db... classes such as Form, Edit, Button, Group, etc.) should be placed inside this object. Objects of data-aware classes (dbForm, dbEdit, dbGroup, etc.) must be placed inside data-aware containers (dbContainer, dbGroup).

Shadowing

Container objects may be shadowed by setting the enabled_state property to false. When set, all descendant objects are indirectly (or implicitly) shadowed.