BeginPreview

Description

Starts the camera’s preview mode. For HTC cameras, BeginPreview starts the IA Camera Wizard.

Applies to

Camera objects

Syntax

objectname.BeginPreview ( previewwindow )

Argument	Description
objectname	The name of the camera object that you want to inquire about
previewwindow	A graphic object such as a window or picture control that serves as the preview window

Returns

Integer. Returns 1 for success, and one of the following negative values if an error occurs:

-1 Unspecified error
-2 Supporting DLL not loaded
-3 Other initialization error
-5 Inconsistency in this object instance
-6 Call to the driver or device failed
-7 Unsupported option, such as setting a property the camera does not recognize
-8 Value for option is out of range
-9 Bad OS version (for example, expecting Windows Mobile 5 support on a Windows Mobile 2003 device)
-10 User pressed Cancel

Usage

The graphic control specified as an argument to the BeginPreview function is used only if the device supports preview in a specified control. Some devices preview directly to the physical screen.

Examples

Example 1

The following example specifies that the image is previewed in the p_preview picture control on the window w_main:

li_rtn = g_myCamera.BeginPreview(w_main.p_preview)