Download ControlPoint Protocol Manual

Understanding Command Structures
As another example, for nStateChange (Set) with returned value of
7181 = 0x1C0D, the bit positions for the following flags are set:
WsVisible, wsMinimized, wsFramed, wsPosition, wsSize, and
wsZOrder.
Note that if both wsMinimized and wsMaximized are clear (0) a window
is restored.
3.1.3 Validity Fields
The following table shows the flags listed in the table on the previous page
in their bit position order by hex digit.
Table 77: Flag Hex Positional Values
0x10000=16
0x1000=8
0x100=4
0x10=2
0x1=1
80000
wsCrop
8000
na
800
wsSize
80
na
8
wsFramed
40000
wsFormat
4000
wsKind
400
wsPosition
40
na
4
wsMaximized
20000
wsBalance
2000
wsTitle
200
wsDestroyed
20
wsAlwaysOnTop
2
wsMinimized
10000
wsChannel
1000
wsZOrder
100
wsCreated
10
wsLockAspect
1
wsVisible
The maximum values for setting valid change fields for each column are 3,
E, 1, D. The hex value 0x3E1D equates to 15901 decimal. Note that some
variables are mutually exclusive (i.e., minimum/maximum and created/
destroyed), so maximum values cannot be F for a given column. Read Only
variables are not included here, as they cannot be changed.
Table 78: nState Bits
nState bits
wsVisible
0x0001
wsMinimized
0x0002
wsMaximized
0x0004
wsFramed
0x0008
wsLockAspect
0x0010
Table 59 – nState Bits
wsAlwaysOnTop 0x0020
nState bits tell ControlPoint how to change the state of a window, while
nStateChange (Set) bits tell ControlPoint what fields are valid and how
you want to change the window.
ControlPoint 2.10 Protocol Manual
123