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:
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional, Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| DLL |
|