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
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


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.


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.