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 bWait parameter in the TPVAPIOpenDocumentInfo structure to FALSE.

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 to 0 to draw page 1, and to 1 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 to FALSE.