piBarID - cCJAbstractCommandBar

A unique numeric identifier that uniquely identifies the toolbar

Type: Property
Access: Read/Write
Data Type: Integer
Parameters: None

Syntax

Property Integer piBarID

Access Type	Syntax
Read Access:	Get piBarID to IntegerVariable
Write Access:	Set piBarID to IntegerVariable/Value

Description

Each menubar and toolbar must have a unique numeric identifier, which is stored in piID. When a toolbar and menubar is created, a unique ID will be auto-assigned and set into piID.

Default is 0, which will result in an ID being auto assigned.

This ID is used when menubar and toolbar layout are saved and restored. Therefore, the saved ID stored in a layout must refer to the same menubar or toolbar when the layout is restored. When the IDs are auto-assigned they are assigned in object order. If your code has not changed, the IDs will remain the same and all will work as expected. If the number of menubar/toolbars change or the number of cCJMenuItem objects change, the cCJCommandBarSystem will recognize this change and not attempt to restore an out of date layout. However, if the number of bars or items did not change but the order of the toolbars did change, the system will not recognize that the saved layout is out of date. This can be corrected by incrementing the cCJCommandBarSystem's piLayoutBuild property.