Class: Group

Properties | Events | Methods | Index of Classes

To create visual group container objects with (by default) a gray background with a rectangular 3D line border with a text label embedded in the top left edge

Hierarchy

cObject > cUIObject > DfBaseObject > DfBaseWindow > DfBaseUIWindow > DfBaseContainer > DfBaseGroup > Group

Show full hierarchy and direct subclasses

• cObject
• cUIObject
  • DfBaseObject
  • DfBaseWindow
    • DfBaseUIWindow
    • DfBaseContainer
      • DfBaseGroup
      • Group
        • dbGroup_
        • RadioGroup

Library: Windows Application Class Library

Package: Windows.pkg

Mixins: Standard_Container_Mixin

Description

The Group class is used to create visual group container objects with (by default) a gray background with a rectangular 3D line border with a text label embedded in the top left edge. Objects based on this class are intended to contain controls (forms, buttons, edits, etc.) and other container objects (which will themselves contain controls).

The dbGroup class is a data-aware class similar to the Group class.

Sample

Object oObjectName is a Group
    Set Size to 70 150
    Set Location to 5 5
    Set Label to "Group 1"

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

    Object G2 is a Group
        Set Size to 30 130
        Set Location to 25 10
        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

Object oObjectName is a Group
    Set Size to height width
    set Location to vertical horizontal
    set Label to title
    :
End_Object

Argument Explanation

Col 1	Col 2
object_name	The name of the Group object.
height	The height of object_name.
width	The width of object_name.
vertical	The vertical coordinate of object_name's upper-left corner.
horizontal	The horizontal coordinate of the object_name's upper-left corner.
title	A string informing users the purpose of the 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 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.

If you do not wish to display a label, you may set the label property to "", resulting in the display of an unbroken 3 D-line rectangle.

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

Do not place radio objects inside a Group or dbGroup object. Radio objects must be placed within RadioGroup and dbRadioGroup objects.

Shadowing

Container objects may shadowed by setting the enabled_state property to false. When set, all descendant objects are indirectly (or implicitly) shadowed. When shadowed, (explicitly or by a parent) the group's label will displayed shadowed to indicate its unavailability.