setDialogImageMode

Syntax

setDialogImageMode(int mode, int stretchMode)

Arguments

mode
How the background image will be displayed. 0 for exact size, 1 for tiled, 2 for stretched-to-fit.
stretchMode
The algorithm used to stretch the bitmap to fit.

Description

Changes how the background image is displayed / resized in the filter dialog background. Under some conditions, e.g. STRETCHED dialog attribute, this could take some time to redraw - by using lockWindow(1) in front of the code and lockWindow(0) afterwards, the changes should only take a few milliseconds.
The stretchMode parameter takes values from the Windows SetStretchBltMode function (see https://msdn.microsoft.com/en-us/library/windows/desktop/dd145089(v=vs.85).aspx ). There is almost no good reason to use anything except the COLORONCOLOR algorithm, which is the default, so it is best to leave stretchMode set to 0 at all times.

Example

// Make the background image tiled / repeating
setDialogImageMode(1, 0);

// Make the background image stretch to fit the window
setDialogImageMode(2, 0);

See Also

setDialogImage

Comments

Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.