Edit

Share via


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

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)