Group Box Item

The group box item is used to draw a rectangle with a 3D appearance around a group of dialog items. A label can be drawn on the top edge of the rectangle, near the left side of the group box. The text of a label can be changed by calling mdlDialog_itemSetLabel


The group box item doesn't need an item resource to complete it's appearance and is completely specified by information in the item list.

Item List Specification

The DialogItemRsc field extent specifies the location of the group box. Both a positive width and height should be specified. The group box handler cannot determine reasonable defaults.

The type field should be GroupBox.

The ID is unused by the dialog box manager, since a group box item does not have an item resource. It can be used, however, to differentiate between group boxes when a dialog has a number of group box items. In that case you would use the ID in a call to mdlDialog_itemGetByTypeAndId.

The attributes field can be ON or OFF and optionally combined with HIDDEN. It will usually be ON.

The itemArg field is unused and should usually be set to 0.

The label field contains the label of the group box item. This is placed over the top edge of the group box, near the left edge.

The auxInfo field is not used with group box items.

The following is an example of a group box item list specification:

{{XC, YC, 20*XC, 10*YC}, GroupBox, 0, ON, 0, "Snap", ""}

Item resource specification

A group box item does not have an item resource.

Item hook function messages

Since a group box item does not have an item resource, it cannot have an item hook function and will not receive item messages.

Group box item functions

There are no group box item functions.

Copyright © 2017 Bentley Systems, Incorporated. All rights reserved.