DISPCONTAINERTITLEBARICONPROPS

typedef struct tagDISPCONTAINERTITLEBARICONPROPS
{
   L_UINT uStructSize;
   L_UINT uMask;
   L_BOOL bVisible;
   L_BOOL bReadOnly;
   COLORREF crColor;
   COLORREF crColorPressed;
   COLORREF crColorHover;
} DISPCONTAINERTITLEBARICONPROPS, * pDISPCONTAINERTITLEBARICONPROPS;

The DISPCONTAINERTITLEBARICONPROPS structure contains options for controlling the appearance or behavior of a specific title bar icon.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() function to calculate this value.

uMask

Value that determines which members contain valid data for setting, or which members should be updated when retrieving. You can combine values together when appropriate by using a bitwise OR ( | ). Possible values are:

 

Value

Meaning

 

DCTITLEBAR_ICONPROPS_ALL

[0x0000001F] All members contain valid data; or should be updated.

 

DCTITLEBAR_ICONPROPS_COLOR

[0x00000001] crColor contains valid data; or should be updated.

 

DCTITLEBAR_ICONPROPS_COLORHOVER

[0x00000002] crColorHover contains valid data; or should be updated.

 

DCTITLEBAR_ICONPROPS_COLORPRESSED

[0x00000004] crColorPressed contains valid data; or should be updated.

 

DCTITLEBAR_ICONPROPS_SHOW

[0x00000008] bVisible contains valid data; or should be updated.

 

DCTITLEBAR_ICONPROPS_READONLY

[0x00000010] bReadOnly contains valid data; or should be updated.

 

bVisible

Flag that specifies whether to show the specified icon. Possible values are:

 

Value

Meaning

 

TRUE

Show this icon. This is the default value for icons 4, 5, 6 and 7.

 

FALSE

Do not show this icon. (This is the default value for icons 0, 1, 2 and 3.

bReadOnly

Flag that specifies whether the specific icon is preserved by the image viewer. Possible values are:

 

Value

Meaning

 

TRUE

Preserved by the image viewer.

 

FALSE

Not preserved by the image viewer. This is the default value.

crColor

COLORREF value that specified the icon color when the icon is unchecked. The default value is RGB(0, 0, 0)

crColorPressed

COLORREF value that specified the icon color when the icon is checked. The default value is RGB(64, 128, 255)

crColorHover

COLORREF value that specified the icon color when the mouse is hovering over. The default value is RGB(0, 255, 0)

Comments

This structure is used by the following function:

L_DispContainerSetIconProperties