Item object

Windows Image Acquisition (WIA) hardware devices are represented as hierarchical trees of Item objects. The root item in this tree represents the device itself, while child items represent images, folders, or scanning beds.

Use the Item object to transfer data to a file, to navigate the item tree for a particular device, or to retrieve information about an image or a device.

Members

The Item object has these types of members:

• Methods
• Properties

Methods

The Item object has these methods.

Method	Description
GetItemsFromUI	The GetItemsFromUI method of the Item object displays a dialog box that allows a user to select images and audio to transfer from a device.
GetPropById	The GetPropById method of the Item object uses the ID of an item property to return its value.
TakePicture	The TakePicture method of the Item object causes a digital camera device to take a picture and returns an Item object that represents the resulting image. This method applies only to digital camera devices.
Transfer	The Transfer method of the Item object transfers data from a device to a file. This method applies only to device type items.

 

Properties

The Item object has these properties.

Property	Access type	Description
Children	Read-only	The Children property of the Item object retrieves a collection of Item objects. The items in this collection represent items that are direct children of this item in the hierarchical tree.
ConnectStatus	Read-only	Retrieves the connection status of the device. This property applies only to items of type device (root items). Possible values are "connected", "disconnected", or NULL (if this property does not apply to the item).
FirmwareVersion	Read-only	Retrieves the firmware version of the device. This property applies only to items of type device (root items).
FullName	Read-only	Retrieves the full name of the item as it appears in the UI.
Height	Read-only	The height, in pixels, of the item.
ItemType	Read-only	The type of this item.
Name	Read-only	The name of the item as it appears in the UI.
PictureHeight	Read-only	The height, in pixels, of images produced by this digital camera. Applies only to digital cameras.
PictureWidth	Read-only	The width, in pixels, of images produced by this digital camera. Applies only to digital cameras.
ThumbHeight	Read-only	The height, in pixels, of the thumbnail image. This property returns -1 if this item does not support thumbnails.
Thumbnail	Read-only	The path and filename of the thumbnail image. This property is NULL if the item does not support thumbnails, or if a path cannot be built.
ThumbWidth	Read-only	The width, in pixels, of the thumbnail image. This property returns -1 if this item does not support thumbnails.
Time	Read-only	The current time. Applies only to devices.
Width	Read-only	The width, in pixels, of the item.

 

Remarks

Creation\Access Functions

Use any of the following to retrieve a reference to the object:

TakePicture

Create

Create

 

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
DLL	Wiascr.dll (version 4.90 or later)