2.2.1.3.1.2.2 Window Icon

The Window Icon packet is a Window Information Order generated by the server when a new or existing window sets or updates its associated icon.

Icons are created by combining two bitmaps of the same size. The mask bitmap is always 1 bpp, although the color depth of the color bitmap can vary. The color bitmap can have an associated color table.

The Window Icon order SHOULD NOT be sent if the client specified the TS_RAIL_CLIENTSTATUS_SUPPRESS_ICON_ORDERS flag in the Client Information PDU (section 2.2.2.2.2).


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

Hdr

...

...

IconInfo (variable)

...

Hdr (11 bytes): Eleven bytes. A TS_WINDOW_ORDER_HEADER structure. The FieldsPresentFlags field of the header MUST be constructed using the following values.

Value

Meaning

0x01000000

WINDOW_ORDER_TYPE_WINDOW

Indicates a Windowing Alternate Secondary Drawing Order that describes a window. This flag MUST be set.

0x10000000

WINDOW_ORDER_STATE_NEW

Indicates that the Windowing Alternate Secondary Drawing Order contains information for a new window. If this flag is not set, the order contains information for an existing window.

0x40000000

WINDOW_ORDER_ICON

Indicates that the order contains icon information for the window. This flag MUST be set.

0x00002000

WINDOW_ORDER_FIELD_ICON_BIG

Indicates that the large version of the icon is being sent. If this flag is not present, the icon is a small icon. <8>

0x00100000

WINDOW_ORDER_FIELD_ICON_OVERLAY

Indicates that the overlay icon for the window is being sent. If this flag is not present, the icon is an application icon.

IconInfo (variable): Variable length. TS_ICON_INFO structure. Describes the window's icon.