VAPIMWP_DRAW_DRAWPAGE
Draws a page in an area on a device context. This is a parameter of the VAPIM_DRAW
message.
Syntax
#include <kvvapi.h> SendMessage(hWndVAPI,VAPIM_DRAW, VAPIMWP_DRAW_DRAWPAGE, (LPARAM) (TPVAPIDrawPageInfo*) pDrawInfo );
Arguments
Argument | Description |
---|---|
hWndVAPI
|
The handle of the VAPI window. |
pDrawInfo
|
A pointer to a TPVAPIDrawPageInfo structure that contains information used for drawing. To draw pages in any order, set the |
Returns
SendMessage()
returns:
-
VAPI_RETURN_SUCCESS
if the call succeeds. -
VAPI_RETURN_NOT_INITIALIZED
if the drawing routines have not been initialized. -
VAPI_RETURN_NO_PAGE
if the requested page does not exist, or is being displayed before all previous pages have been displayed. -
VAPI_RETURN_NOT_AVAILABLE
if the document does not support this feature (for example, ZIP files, video, audio). -
VAPI_RETURN_ERROR
if an error has occurred.
Discussion
-
Before you send this message, initialize VAPI by sending the VAPIMWP_DRAW_INIT message, and then open the document by sending the VAPIMWP_INIT_OPEN_DOCUMENT message.
-
Page numbers start at 0. For example, set
uPage
to0
to draw page 1, and to1
to draw page 2. -
By default, you must draw pages sequentially: to draw page 3, you must first draw pages 1 and 2. To draw pages in any order, set the
bWait
parameter in the TPVAPIOpenDocumentInfo structure toFALSE
.