IE_SETBKGND

Sets the background painting options for the control.

Parameters

wParam

Specifies the background options, as given in the following list:

Constant	Description
IEB_BIT_CENTER	Center bitmap in control. The lParam parameter contains bitmap.
IEB_BIT_STRETCH	Stretch bitmap to fit control. The lParam parameter contains bitmap.
IEB_BIT_TILE	Tile supplied bitmap repeatedly in control. The lParam parameter contains bitmap.
IEB_BIT_UL	Align supplied bitmap to upper-left corner in the control. (UL stands for upper left. ) The lParam parameter contains bitmap.
IEB_BRUSH	Use brush supplied in lParam.
IEB_DEFAULT	Do default background (use COLOR_WINDOW).
IEB_OWNERDRAW	Parent will draw background.

lParam

Contains a handle to the background bitmap or a brush, or is NULL, according to the specified option in wParam.

Return Value

Returns IER_OK if successful; otherwise, returns IER_PARAMERR to indicate that wParam or lParam is invalid.

Comments

The application can change the background at any time. The control is synchro-nously repainted upon any change.

The HBITMAP or HBRUSH handle, if there is one, becomes the property of the iedit control. The application must make no further use of the handle if the message returns IER_OK. If the IEB_OWNERDRAW option is selected, the parent window must process the IN_ERASEBKGND notification. If an application must place such objects as icons or metafiles in the background, it must do so either in an owner-draw capacity or during the IN_PREPAINT notification.