Seperator Item

The seprator item is used to draw a vertical or horizontal separator line the height or width of a dialog box.

plblock.jpg

The separator item doesn't need an item resource to complete its appearance and is completely specified by information in the item list.

Item List Specification

The DialogItemRsc field extent specifies the location of the separator. The X or Y origin point of the line is defined and the width/height should be set to 0. The separator handler determines whether the separator line is vertical or horizontal by whether the X origin is 0 (if non-zero, the separator is assumed to be vertical).

The type field should be Separator.

The ID is unused by the dialog box manager, since a separator item does not have an item resource. It can be used, however, to differentiate between separator when a dialog has a number of separator 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 is unused and should usually be set to "".

The auxInfo field is not used with separator items.

The following is an example of a separator item list specification:

{{0, 8*YC, 0, 0}, Separator, 0, ON, 0, "", ""}

Item Resource Specification

A separator item does not have an item resource.

Item Hook Function Messages

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

Separator Item Functions

There are no separator item functions.


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