次の方法で共有

IScanProfile インターフェイス

  • [アーティクル]

IScanProfile インターフェイスは、単一のスキャン プロファイルを表し、アプリケーションがプロファイルのプロパティを設定および取得できるようにします。

メンバー

IScanProfile インターフェイスは、IDispatch インターフェイスから継承されます。 IScanProfile には、次の種類のメンバーもあります。

メソッド

IScanProfile インターフェイスには、これらのメソッドがあります。

メソッド 説明
GetAllPropIDs プロファイルで使用可能なすべてのプロパティ ID を取得します。
GetDeviceID デバイスの ID を返します。
GetGUID プロファイルの GUID を返します。
Getitem プロファイルが関連付けられている WIA 2.0 項目のカテゴリの GUID を取得します。
GetName プロファイルのフレンドリ名を取得します。
GetNumPropIDS プロファイル内のプロパティ ID の数を取得します。
GetProperty スキャン プロファイルの要素内の <Properties> 指定された子プロパティの値を取得します。
Isdefault プロファイルが関連付けられている IWiaItem2 デバイスの既定のスキャン プロファイルであるかどうかを示す値を取得します。
RemoveProperty スキャン プロファイルの要素内の子プロパティの <Properties> 指定されたリストを削除します。
保存 プロファイルへの変更をディスクに保存します。
Setitem プロファイルが関連付けられている WIA 2.0 項目のカテゴリの GUID を設定します。
SetName プロファイルのフレンドリ名を設定します。
SetProperty スキャン プロファイルの要素内の <Properties> 指定された子プロパティの値を設定します。

 

注釈

IWiaItem2 デバイスにはスキャン プロファイルを含めることができます。 ただし、WIA_CATEGORY_FINISHED_FILEおよびWIA_CATEGORY_ROOTの種類の IWiaItem2 項目にはプロファイルを含めることはできません。

スキャン プロファイルが IScanProfile::Save メソッドを使用して保存される場合は、%USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles に XML ファイルとして格納されます。

IScanProfile オブジェクトのインスタンスを作成するには、IScanProfileMgr::CreateProfile メソッドを使用します。 既にディスクに保存されているスキャン プロファイルへの参照を取得するには、 IScanProfileMgr::OpenProfile メソッドを 使用します。

すべてのスキャン プロファイルには、、および <Properties>の要素があります<ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>。 デバイスの既定のプロファイルにも 要素があります <Default> 。

および <DeviceID> 要素は<ProfileGUID>、プロファイルの作成後に変更できません。 要素と 要素の <ProfileName> 値は、プロファイルの <WiaItem> 作成後に変更できます。 要素は <Default> 追加または削除できます。 これは、IScanProfile::SetName、IScanProfile::SetItem、および IScanProfileMgr::SetDefault メソッドを使用してプログラムで実行できます。 これらのプロパティは、 IScanProfileUI::ScanProfileDialog メソッドを使用してユーザーが変更することもできます。

要素には <Properties> 子が <Property> 含まれています。 WIA 2.0 項目またはデバイス プロパティをプロファイルに追加するには、これらを使用します。 また、独自のイメージ取得子を <Property> 開発することもできます。 これにより、スキャン プロファイル スキーマが拡張可能になります。 (スキーマの拡張の詳細については、「 カスタム プロパティの定義」、「 IScanProfile::GetProperty」、および「 IScanProfile::SetProperty」を参照してください)。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
IDL
Scanprofiles.idl

こちらもご覧ください

IDispatch

スキャン プロファイル スキーマ