Control Box Control

This document covers the following topics:


Description

The control box control is a general-purpose container control. Any dialog elements placed within the control box become child controls of the control box, thus allowing related dialog elements to be grouped together for programming convenience or ease of user manipulation in the dialog editor. For example, when a control box is made invisible, all the dialog elements it contains become invisible, and when it is moved, these dialog elements are moved with it.

Special attention has been paid to making it possible to create multiple "pages" of dialog elements at the same position in a dialog using control boxes marked with the 'Exclusive' style. Only one such page can then be visible at any one time, both at edit-time and at run-time, and the Dialog Editor automatically changes the active page according to the current selection. This feature can be used to support wizard dialogs and ActiveX tab controls. Please refer to the article Working with Control Boxes for more information.

Attributes for Control Box Control

Attribute Name Query Set/Modify In Attr. Window
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
DROP-MODE X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
FOLLOWS X X/X  
LAST-CHILD 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
STYLE X X/- X
SUCCESSOR X -/-  
SUPPRESS-DRAG-DROP-EVENT X X/X  
SUPPRESS-DRAG-ENTER-EVENT X X/X  
SUPPRESS-DRAG-LEAVE-EVENT X X/X  
SUPPRESS-DRAG-OVER-EVENT X X/X  
SUPPRESS-SIZE-EVENT X X/X  
TOOLTIP X X/X  
TYPE X X/-  
VISIBLE X X/X X

Events

Drag-Drop Event, Drag-Enter Event, Drag-Leave Event, Drag-Over Event, Size Event (all events may be suppressed).