The Snapped event occurs after an image has been captured by a digital camera device.
Event ID |
Objects |
|---|---|
None |
Camera |
Argument |
Description |
|---|---|
filename |
String by value. The value passed in this argument is the name of the file that stores the snapped image. |
None (do not use a RETURN statement)
Coding this event is particularly useful for PocketBuilder applications using the HTC camera. The HTC camera uses IA Camera Wizard software to capture images. (This software can be installed with the camera on the Windows CE device.) The IA Camera Wizard captures the images, and is responsible for notifying the PocketBuilder application of the capture through the Snapped event. It passes back the name of the file containing the image in the filename argument. Since the wizard takes care of the image capturing, the image-capturing functions on the camera object are not used.
You can also code this event for other camera devices supported by PocketBuilder, such as the HP and VEO digital cameras. For these cameras, the value in the filename argument for the Snapped event is the value that you assign in the CaptureImage function call on the current Camera object.
The following code in a Snapped event adds notification on a new line in a multiline edit box that an image has been captured:
mle_1.text = mle_1.text + "~r~npicture file name is "& + filename + "."
