CommonDialog.ShowSelectItems method

Displays a dialog box that enables the user to select an Item for transfer from a hardware device for image acquisition.

Syntax

ppResult = .ShowSelectItems( _
  ByVal Device As Device, _
  [ ByVal Intent As WiaImageIntent ], _
  [ ByVal Bias As WiaImageBias ], _
  [ ByVal SingleSelect As VARIANT_BOOL ], _
  [ ByVal UseCommonUI As VARIANT_BOOL ], _
  [ ByVal CancelError As VARIANT_BOOL ] _
) As HRESULT

Parameters

Device [in]

Type: Device*

Required. Device value.

Intent [in, optional]

Type: WiaImageIntent

WiaImageIntent value.

Value Meaning
UnspecifiedIntent
Default. No intent specified.

Bias [in, optional]

Type: WiaImageBias

WiaImageBias value.

Value Meaning
MaximizeQuality
Default. Use a higher quality scan to maximize the quality of the image.

SingleSelect [in, optional]

Type: VARIANT_BOOL

Boolean value that indicates whether the user must select only one item.

Value Meaning
False
Multiple selection allowed.
True
Default. Single selection required.

UseCommonUI [in, optional]

Type: VARIANT_BOOL

Boolean value that indicates whether to use the common UI.

Value Meaning
False
Do not use the common UI.
True
Default. Use the common UI.

CancelError [in, optional]

Type: VARIANT_BOOL

Boolean value that indicates whether to generate an error if the user cancels the dialog box.

Value Meaning
False
Default. Do not generate an error.
True
Generate an error.

Return value

Type: Items**

Returns the selection as an Items collection on success, otherwise returns Nothing.

Remarks

For example code, see Count the Number of Child Items Available for Transfer in Shared Samples.

Requirements

Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 R2 [desktop apps only]
Header
Wiaaut.h
IDL
Wiaaut.idl

See also

Reference

CommonDialog

ShowAcquireImage

ShowAcquisitionWizard

ShowDeviceProperties

ShowSelectDevice

Device

Items (Device)

Connect

Items (Item)

Items

Device (VideoPreview)

WiaImageBias

WiaImageIntent