Navigation:  thinBasic Modules > UI (User Interface) > Dedicated Control Functions > ListView Control > ListView: General functions >

ListView_SetBkImage

Previous pageReturn to chapter overviewNext page

 

Description

 

Sets the background image in a list-view control.

 

Syntax

 

n = ListView_SetBkImage(hWnd, ctrlID, sImage, Flags, xOffset, yOffset)

 

Returns

 

Number

 

Parameters

 

Name

Type

Optional

Meaning

hWnd

Number

No

Handle of the dialog containing the list-view control

ctrlID

Number

No

Control identifier assigned to the control during CONTROL ADD ...

sImage

String

No

Full file name of the image to be set.

Flags

Number

No

Use a combination of the following equates:

%LVBKIF_SOURCE_NONE

%LVBKIF_STYLE_NORMAL

%LVBKIF_SOURCE_URL

%LVBKIF_STYLE_TILE

%LVBKIF_FLAG_TILEOFFSET

If zero or omitted, the following will be defaulted:

%LVBKIF_STYLE_NORMAL OR %LVBKIF_SOURCE_URL

xOffset

Number

No

Percentage of the control's client area that the image should be offset horizontally. For example, at 0 percent, the image will be displayed against the left edge of the control's client area. At 50 percent, the image will be displayed horizontally centered in the control's client area. At 100 percent, the image will be displayed against the right edge of the control's client area.

yOffset

Number

No

Percentage of the control's client area that the image should be offset vertically. For example, at 0 percent, the image will be displayed against the top edge of the control's client area. At 50 percent, the image will be displayed vertically centered in the control's client area. At 100 percent, the image will be displayed against the bottom edge of the control's client area.

 

Remarks

 

Restrictions

 

See also

 

Examples