LVM_GETBKIMAGE

This message gets information about a List-View control’s background image or watermark.

hWnd	window handle of List-View control
uMsg	LVM_GETBKIMAGEA (0x1045) for ANSI form
uMsg	LVM_GETBKIMAGEW (0x108B) for Unicode form
wParam	ignored
lParam	provides the address of an LVBKIMAGE structure that specifies what information is desired and receives whatever information is produced
returns	TRUE for success, else FALSE

Behaviour

In COMCTL32 versions 6.10 and higher, the LVM_GETBKIMAGEW message passes lParam to the GetBackgroundImage method of the List-View control’s IListView interface, returning TRUE or FALSE according to whether the method succeeds or fails.

The LVM_GETBKIMAGEA message is not implemented just as a call to GetBackgroundImage with wrapping for character-set translation. The separate coding for the ANSI form does not require that the control has been created but not yet destroyed. More importantly, the ANSI form does not know about watermarks: it behaves as if the LVBKIF_TYPE_WATERMARK bit is clear on input.

Availability

The LVM_GETBKIMAGE message has both ANSI and Unicode forms. The NT builds of COMCTL32 implement both forms in versions 4.71 and higher, but the Unicode forms are not supported by the Windows builds until version 5.80.