ShowDisplayBackgroundDlg Method

Description:

Shows the Display: Background dialog. The Display: Background dialog is as follows:

The R/G/B settings and check boxes on the left side of the dialog are used to set the background handling parameters for the display of the image. The "Background Image..." brings up the ShowFileInfoDlg Method dialog, allowing the user to choose a second image (typically a pattern image) to use as the background.

The user can click the "Preview Changes" checkbox to see the effects of the background handling parameters in the preview area (they can leave the checkbox un-checked if the image is particularly large and therefore takes a long time to render).

Clicking the "OK" button will apply the background handling parameters to the image referenced by thePageDisplay, and then close the dialog. Note that you must specify the hWnd parameter in order for the end-user to see any changes when they click "OK".

Clicking the "Apply" button will apply the background handling parameters to the image referenced by thePageDisplay, but leave the dialog on the screen. Note that you must specify the hWnd parameter in order for the end-user to see any changes when they click "Apply".

Clicking the "Cancel" button will close the dialog without making any changes.

Syntax:

      ShowDisplayBackgroundDlg (thePageDisplay As IGPageDisplay, hWnd
As Long)

Parameters:

Name	Description
thePageDisplay	Provide the IGPageDisplay Object that your program is using to handle display functions for your image.
hWnd	If your image is presented via IGPageViewCtl Control, then specify IGPageViewCtln.hWnd.

Return Value:

None

Bits Per Pixel:

N/A

Sample:

ig_guidlg.vb6.exe