2.3.1.7 TBTRFlags

Referenced by: TB

Toolbar type and restrictions flags. The bit description begins from the least significant bit.

This structure MUST specify the toolbar type which means that the 8 most significant bits MUST have one of the values in the following table.

8 most significant bits of the TBTRFlags structure (section 2.3.1.7)

Meaning

00000000

Specifies that the toolbar is a basic toolbar.

00000010

Specifies that the toolbar is a menu toolbar.

The rest of the bits in this structure specify toolbar restrictions. A toolbar restriction limits the end user’s ability to change and manipulate the toolbar.


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

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

X

Y

Z

a

reserved17

A - NoAddDelCtl (1 bit): A bit that specifies whether toolbar controls can be added to or removed from this toolbar. A value of 1 specifies that no toolbar controls can be added or removed from this toolbar.

B - NoResize (1 bit): A bit that specifies whether this toolbar can be resized when not docked. A value of 1 specifies that this toolbar cannot be resized when not docked.

C - NoMove (1 bit): A bit that specifies whether this toolbar can or cannot be moved. A value of 1 specifies that this toolbar cannot be moved.

D - NoChangeVisible (1 bit): A bit that specifies whether the visibility of this toolbar can be changed. A value of 1 specifies that the visibility of this toolbar cannot be changed.

E - NoChangeDock (1 bit): A bit that specifies whether the docked location of this toolbar can or cannot be changed. A value of 1 specifies that the end user cannot change the docked location of this toolbar.

F - NoVerticalDock (1 bit): A bit that specifies whether this toolbar can be vertically docked. A value of 1 specifies that the toolbar cannot be vertically docked.

G - NoHorizontalDock (1 bit): A bit that specifies whether this toolbar can be horizontally docked. A value of 1 specifies that the toolbar cannot be horizontally docked.

H - NoBorder (1 bit): A bit that specifies whether the toolbar has a title bar and a border when not docked. A value of 1 specifies that the toolbar does not have a title bar and a border when not docked. MUST be 1 when the TBTPopupMenu field equals 1; MUST be 0 when the TBTPopupMenu equals 0.

I - NoTbContextMenu (1 bit): A bit that specifies whether the toolbar shows a context menu when right-clicked. A value of 1 specifies that the toolbar will not show a context menu when right-clicked. MUST be 1 when TBTPopupMenu equals 1; MUST be 0 when TBTPopupMenu equals 0.

J - reserved1 (1 bit): Reserved bit. MUST be 0.

K - reserved2 (1 bit): Reserved bit. MUST be 0.

L - NotTopLevel (1 bit): A bit that specifies whether the toolbar can be a top-level toolbar. A value of 1 specifies that this toolbar is a child of another toolbar, and can never be a top-level toolbar. A value of 0 specifies that this toolbar can be a top-level toolbar. MUST be 1 when the TBTPopupMenu field equals 1; MUST be 0 when the TBTPopupMenu field equals 0.

M - reserved3 (1 bit): Reserved bit. MUST be 0.

N - reserved4 (1 bit): Reserved bit. MUST be 0.

O - reserved5 (1 bit): Reserved bit. MUST be 0.

P - reserved6 (1 bit): Reserved bit. MUST be 0.

Q - reserved7 (1 bit): Reserved bit. MUST be 0.

R - reserved8 (1 bit): Reserved bit. MUST be 0.

S - reserved9 (1 bit): Reserved bit. MUST be 0.

T - reserved10 (1 bit): Reserved bit. MUST be 0.

U - reserved11 (1 bit): Reserved bit. MUST be 0.

V - reserved12 (1 bit): Reserved bit. MUST be 0.

W - reserved13 (1 bit): Reserved bit. MUST be 0.

X - reserved14 (1 bit): Reserved bit. MUST be 0.

Y - reserved15 (1 bit): Reserved bit. MUST be 0.

Z - TBTPopupMenu (1 bit): A bit that specifies whether this toolbar is of type menu toolbar. A value of 1 specifies that this is a menu toolbar. If the value equals 1, the fields NoResize, NoMove, NoChangeDock, NoBorder, NoTbContextMenu, and NotTopLevel MUST equal 1.

a - reserved16 (1 bit): Reserved bit. MUST be 0.

reserved17 (5 bits): Reserved bits. MUST be 0.