Group Frame Control

This document covers the following topics:


Description

A group frame control is used to optically group related dialog elements within a dialog. It can, for example, be used to frame a group of radio button controls that have a common GROUP-ID, but where it is not optically evident to the end user that these radio button controls are related.

You may use the group frame control without the text in the upper left corner. Then the group frame control acts as a simple frame. If you use it with text, this text may contain a mnemonic key (&). If the mnemonic key is pressed, the following dialog element in the navigation sequence gets the focus.

Attributes for Group Frame Control

Attribute Name Query Set/Modify In Attr. Window
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
ENABLED X X/X X
FIRST-CHILD X -/-  
FOLLOWS X X/X  
FONT-HANDLE X X/X X
FOREGROUND-COLOUR-NAME X X/X X
FOREGROUND-COLOUR-VALUE X X/X X
LAST-CHILD X -/-  
OWNER X X/-  
PARENT X X/-  
PREDECESSOR X -/-  
RECTANGLE-H X X/X X
RECTANGLE-W X X/X X
RECTANGLE-X X X/X X
RECTANGLE-Y X X/X X
RTL X -/- X
STRING X X/X X
SUCCESSOR X -/-  
TYPE X X/-  
VISIBLE X X/X X

Events

This dialog element does not create events.