Item オブジェクト

[アーティクル]
06/13/2023

Windows イメージ取得 (WIA) ハードウェアデバイスは、 Item オブジェクトの階層ツリーとして表されます。このツリーのルート項目はデバイス自体を表し、子項目は画像、フォルダー、またはスキャンベッドを表します。

Item オブジェクトを使用して、ファイルにデータを転送したり、特定のデバイスの項目ツリー内を移動したり、イメージまたはデバイスに関する情報を取得したりできます。

メンバー

Item オブジェクトには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

Item オブジェクトには、これらのメソッドがあります。

メソッド	説明
GetItemsFromUI	Item オブジェクトの GetItemsFromUI メソッドは、ユーザーがデバイスから転送する画像とオーディオを選択できるようにするダイアログボックスを表示します。
GetPropById	Item オブジェクトの GetPropById メソッドは、 item プロパティの ID を使用してその値を返します。
TakePicture	Item オブジェクトの TakePicture メソッドを使用すると、デジタルカメラデバイスが画像を撮影し、結果の画像を表す Item オブジェクトを返します。この方法は、デジタルカメラデバイスにのみ適用されます。
転送	Item オブジェクトの Transfer メソッドは、デバイスからファイルにデータを転送します。このメソッドは、デバイスの種類の項目にのみ適用されます。

プロパティ

Item オブジェクトには、次のプロパティがあります。

プロパティ	アクセスの種類	説明
Children	読み取り専用	Item オブジェクトの Children プロパティは、Item オブジェクトのコレクションを取得します。このコレクション内の項目は、階層ツリー内のこの項目の直接の子である項目を表します。
ConnectStatus	読み取り専用	デバイスの接続状態を取得します。このプロパティは、device 型の項目 (ルート項目) にのみ適用されます。指定できる値は、"connected"、"disconnected"、または NULL (このプロパティがアイテムに適用されない場合) です。
FirmwareVersion	読み取り専用	デバイスのファームウェアバージョンを取得します。このプロパティは、device 型の項目 (ルート項目) にのみ適用されます。
FullName	読み取り専用	UI に表示されるアイテムの完全な名前を取得します。
[高さ]	読み取り専用	項目の高さ (ピクセル単位)。
Itemtype	読み取り専用	このアイテムの種類。
名前	読み取り専用	UI に表示されるアイテムの名前。
PictureHeight	読み取り専用	このデジタルカメラによって生成される画像の高さ (ピクセル単位)。デジタルカメラにのみ適用されます。
PictureWidth	読み取り専用	このデジタルカメラによって生成される画像の幅 (ピクセル単位)。デジタルカメラにのみ適用されます。
ThumbHeight	読み取り専用	サムネイル画像の高さ (ピクセル単位)。このアイテムがサムネイルをサポートしていない場合、このプロパティは -1 を返します。
サムネイル	読み取り専用	サムネイル画像のパスとファイル名。アイテムがサムネイルをサポートしていない場合、またはパスを作成できない場合、このプロパティは NULL です。
ThumbWidth	読み取り専用	サムネイル画像の幅 (ピクセル単位)。このアイテムがサムネイルをサポートしていない場合、このプロパティは -1 を返します。
Time	読み取り専用	現在の時刻。デバイスにのみ適用されます。
幅	読み取り専用	項目の幅 (ピクセル単位)。

解説

Creation\Access Functions

オブジェクトへの参照を取得するには、次のいずれかを使用します。

TakePicture

作成

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ]
[DLL]	Wiascr.dll (バージョン 4.90 以降)

次の方法で共有