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.

MethodDescription
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.

PropertyAccess typeDescription

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

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)

 

 

Show: