2.3.1.16 TBCExtraInfo

Referenced by: TBCGeneralInfo

Structure that specifies extra information saved for a toolbar control.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

wstrHelpFile (variable)

...

idHelpContext

wstrTag (variable)

...

wstrOnAction (variable)

...

wstrParam (variable)

...

tbcu

tbmg

wstrHelpFile (variable): A structure of type WString (section 2.3.1.4) that specifies the full path to the help file used to provide the help topic of the toolbar control. For this field to be used idHelpContext MUST be greater than zero.

idHelpContext (4 bytes): Signed integer that specifies the help context id number for the help topic of the toolbar control. A help context id is a numeric identifier associated with a specific help topic. For this field to be used wstrHelpFile MUST specify a non-empty string.

wstrTag (variable): Structure of type WString that specifies a custom string used to store arbitrary information about the toolbar control.

wstrOnAction (variable): Structure of type WString that specifies the name of the macro associated with this toolbar control.

wstrParam (variable): Structure of type WString that specifies a custom string used to store arbitrary information about the toolbar control.

tbcu (1 byte): Signed integer that specifies how the toolbar control will be used during OLE merging. The value MUST be in the following table.

Value

Meaning

0xFF

A correct value was not found for this toolbar control. A value of 0x01 will be used when the value of this field is requested.

0x00

Neither. Toolbar control is not applicable when the application is in either OLE host mode or OLE server mode.

0x01

Server. Toolbar control is applicable when the application is in OLE server mode. (This is the default value used by custom toolbar controls.)

0x02

Host. Toolbar control is applicable when the application is in OLE host mode.

0x03

Both. Toolbar control is applicable when the application is in OLE server mode and OLE host mode.

tbmg (1 byte): Signed integer that specifies how the toolbar control will be used during OLE menu merging. This field is only used by toolbar controls of type Popup. The value MUST be in the following table.

Value

Meaning

0xFF

None. Toolbar control will not be placed in any OLE menu group.

0x00

File. Toolbar control will be placed in the File OLE menu group.

0x01

Edit. Toolbar control will be placed in the Edit OLE menu group.

0x02

Container. Toolbar control will be placed in the Container OLE menu group.

0x03

Object. Toolbar control will be placed in the Object OLE menu group.

0x04

Window. Toolbar control will be placed in the Window OLE menu group.

0x05

Help. Toolbar control will be placed in the Help OLE menu group.