SpvGetGrayAreaMarginV, SpvSetGrayAreaMarginV Functions

Applies To

fpSpreadPreview DLL control

Description

Set or return the vertical space between the displayed page and the edge of the control

Syntax

int SpvGetGrayAreaMarginV(HWND hWnd, long FAR *lpValue);

int SpvSetGrayAreaMarginV(HWND hWnd, long value);

C++

long TPreview::GetGrayAreaMarginV(void);

int TPreview::SetGrayAreaMarginV(long value);

Parameters

The SpvGetGrayAreaMarginV function has the following parameters:

Parameter	Description
hWnd	Window handle of the fpSpreadPreview control
lpValue	Pointer to variable that receives vertical space between the displayed page and the edge of the control

The SpvSetGrayAreaMarginV function has the following parameters:

Parameter	Description
hWnd	Window handle of the fpSpreadPreview control
value	Vertical space between the displayed page and the edge of the control

Remarks

The default gray area vertical margin is 720 twips.

Call the SpvSetGrayAreaMarginH function to set the horizontal space between the displayed page and the edge of the control. Call the SpvSetPageGutterH and SpvSetPageGutterV functions to set the horizontal and vertical spaces between multiple pages.

The values you specify by calling the SpvSetGrayAreaMarginH and SpvSetGrayAreaMarginV functions are interpreted by the control according to the value set by the SpvSetGrayAreaMarginType function. By default, the settings for the margins are scaled to keep the page view readable within the preview area. However, you can change the setting of the SpvSetGrayAreaMarginType property to SPV_MARGINTYPE_ACTUAL to have the control use the exact settings of the SpvSetGrayAreaMarginH and SpvSetGrayAreaMarginV functions whether the page is zoomed in or out.

Return Value

SpvGetGrayAreaMarginV: For C users, 1 if the function completes successfully; 0 otherwise. For C++ users, the setting for the function.
SpvSetGrayAreaMarginV: 1 if the function completes successfully; 0 otherwise.

ActiveX Correspondence

GrayAreaMarginV property