图片获取

图片获取技术概述。

若要开发图片获取,需要以下标头:

有关此技术的编程指南,请参阅:

枚举

 
DEVICE_SELECTION_DEVICE_TYPE

DEVICE_SELECTION_DEVICE_TYPE枚举类型指示所选设备的类型。
ERROR_ADVISE_MESSAGE_TYPE

ERROR_ADVISE_MESSAGE_TYPE枚举类型指示可以传递给 IPhotoAcquireProgressCB::ErrorAdvise 的 nMessageType 参数的错误值的类型。
ERROR_ADVISE_RESULT

ERROR_ADVISE_RESULT 枚举类型指示可分配给 IPhotoAcquireProgressCB::ErrorAdvise 的 pnErrorAdviseResult 参数的错误值的类型。
PROGRESS_DIALOG_CHECKBOX_ID

PROGRESS_DIALOG_CHECKBOX_ID 枚举类型指示 IPhotoProgressDialog 对象上的检查框。
PROGRESS_DIALOG_IMAGE_TYPE

PROGRESS_DIALOG_IMAGE_TYPE 枚举类型指示 IPhotoProgressDialog::SetImage 中设置的图像类型。
USER_INPUT_STRING_TYPE

USER_INPUT_STRING_TYPE 枚举类型指示要从 IPhotoAcquireProgressCB::GetUserInput 中的用户获取的字符串类型。

函数

 
获取

Acquire 方法从设备获取照片。
已取消

在获取会话期间发生取消时,Cancelled 方法提供扩展功能。 应用程序提供 Cancelled 方法的实现。
CanDelete

CanDelete 方法指示是否可以删除项。
创建

Create 方法创建并显示托管在父窗口中的照片选项对话框的无模式实例。
创建

Create 方法创建并显示可在图像枚举和获取期间显示的进度对话框。
CreatePhotoSource

CreatePhotoSource 方法初始化要传递给 IPhotoAcquire::Acquire 的 IPhotoAcquireSource 对象。
删除

Delete 方法删除项。
摧毁

Destroy 方法关闭并销毁使用 Create 方法创建的无模式对话框。
摧毁

Destroy 方法关闭并释放在图像枚举和获取期间显示的进度对话框。
DirectoryCreated

在获取过程中创建目标目录时,DirectoryCreated 方法提供扩展功能。 应用程序提供 DirectoryCreated 方法的实现。
DisplayConfigureDialog

显示配置对话框时,DisplayConfigureDialog 方法提供扩展功能。 应用程序提供 DisplayConfigureDialog 方法的实现。
DoModal

DoModal 方法显示设备选择对话框。 当用户使用模式对话框选择设备时,函数将返回。
DoModal

DoModal 方法创建选项对话框并将其显示为模式对话框。
EndDelete

从图像源删除文件完成时,EndDelete 方法提供扩展功能。 应用程序提供 EndDelete 方法的实现。
EndEnumeration

当图像源中的文件枚举完成时,EndEnumeration 方法提供扩展功能。 应用程序提供 EndEnumeration 方法的实现。
EndItemDelete

每次从图像源中删除文件时,EndItemDelete 方法都会提供扩展功能。 应用程序提供 EndItemDelete 方法的实现。
EndItemTransfer

每次从图像源传输文件时,EndItemTransfer 方法都会提供扩展功能。 应用程序提供 EndItemTransfer 方法的实现。
EndSession

完成购置会话时,EndSession 方法提供扩展功能。 应用程序提供 EndSession 方法的实现。
EndTransfer

完成所有文件的传输时,EndTransfer 方法提供扩展功能。 应用程序提供 EndTransfer 方法的实现。
EnumResults

EnumResults 方法检索一个枚举,其中包含最近调用 Acquire 期间成功传输的所有文件的路径。
ErrorAdvise

ErrorAdvise 方法为获取期间发生的错误提供自定义错误处理。 应用程序提供 ErrorAdvise 方法的实现。
FoundItem

每次在枚举设备中的项期间找到项时,FoundItem 方法都会提供扩展功能。
GetAcquisitionTime

GetAcquisitionTime 方法检索当前会话的获取时间。
GetDefault

GetDefault 方法检索用于初始化编辑控件 (或等效) 的默认字符串。
GetDeleteAfterAcquire

GetDeleteAfterAcquire 方法返回一个值,该值指示是否应在获取后删除照片。
GetDeviceIcons

GetDeviceIcons 方法检索用于表示设备的图标。
GetDeviceId

GetDeviceId 方法检索设备的标识符 (ID) 。
GetFlags

GetFlags 方法检索照片获取标志。
GetFriendlyName

GetFriendlyName 方法检索设备的名称,并格式化为显示。
GetGroupTag

GetGroupTag 方法检索从设备下载的文件组的标记字符串。
GetImage

GetImage 方法检索用于初始化编辑控件的默认图像。
GetItemAt

GetItemAt 方法检索项列表中给定索引处的 IPhotoAcquireItem 对象。
GetItemCount

GetItemCount 方法检索 InitializeItemList 方法找到的项数。
GetItemName

GetItemName 方法检索项的文件名。
GetMaxLength

GetMaxLength 方法检索用户界面 (UI) 应允许的最大字符串长度。
GetMruCount

GetMruCount 方法检索最近使用的项列表中的项数。
GetMruEntryAt

GetMruEntryAt 方法检索最近使用的列表中的给定索引处的条目。
GetOutputFilenameTemplate

GetOutputFilenameTemplate 方法 (指定文件名格式的模板) 检索格式字符串。
GetPhotoAcquireSettings

GetPhotoAcquireSettings 方法获取用于处理购置设置的 IPhotoAcquireSettings 对象。
GetPrompt

如果提示是模式对话框,则 GetPrompt 方法检索提示的标题。
GetProperty

GetProperty 方法检索项的属性的值。
GetSequencePaddingWidth

GetSequencePaddingWidth 方法检索一个值,该值指示文件名中顺序字段的宽度。
GetSequenceZeroPadding

GetSequenceZeroPadding 方法检索一个值,该值指示是使用零还是空格来填充顺序文件名。
GetStream

GetStream 方法检索包含项内容的只读流。
GetStringId

GetStringId 方法检索所请求字符串的未本地化规范名称。 例如,请求标记名称时,规范名称可能是“TagName”。
GetStringType

GetStringType 方法检索一个值,该值指示要从用户获取的字符串类型。
GetSubItemAt

GetSubItemAt 方法检索项的子项,给定子项的索引。
GetSubItemCount

GetSubItemCount 方法检索项中包含的子项数。
GetSubmitButtonText

GetSubmitButtonText 方法检索提交按钮的文本。
GetThumbnail

GetThumbnail 方法检索为项提供的缩略图。
GetTooltipText

GetTooltipText 方法检索为控件显示的工具提示文本。
GetUserInput

GetUserInput 方法替代默认功能,该功能在获取期间显示提示用户输入字符串的消息。 应用程序提供 GetUserInput 方法的实现。
GetUserInput

检索用户输入的描述性信息,例如要存储的图像的标记名称。
GetWindow

GetWindow 方法检索进度对话框的句柄。
初始化

初始化选项对话框,并从注册表中读取任何保存的选项。
初始化

初始化插件时,Initialize 方法提供扩展功能。 应用程序提供 Initialize 方法的实现。
InitializeFromRegistry

InitializeFromRegistry 方法指定要从中初始化设置的注册表项。
InitializeItemList

InitializeItemList 方法枚举设备上的可传输项,并将每个项传递给可选的进度回调(如果提供)。
IsCancelled

IsCancelled 方法指示是否已通过进度对话框取消操作。
IsCheckboxChecked

IsCheckboxChecked 方法指示进度对话框中检查框是否 (通常指示是否在选择传输) 后删除文件。
ProcessItem

每次处理项目时,ProcessItem 方法都会提供其他功能。 应用程序提供 ProcessItem 方法的实现。
SaveData

SaveData 方法将获取设置从选项对话框保存到注册表,以便可以使用相同的设置初始化对话框的后续实例。
SetAcquisitionTime

SetAcquisitionTime 方法显式设置获取时间。
SetCaption

设置进度对话框的描述文字。
SetCheckboxText

SetCheckboxText 方法设置进度对话框中检查框的文本,指示是否在传输后删除图像。
SetCheckboxTooltip

SetCheckboxTooltip 方法设置进度对话框中检查框的工具提示文本。
SetFlags

SetFlags 方法设置照片获取标志。
SetGroupTag

SetGroupTag 方法设置购置会话的组标记。
SetImage

设置进度对话框中显示的缩略图、进度对话框标题栏中的图标或 Alt+TAB 组合键窗口中的图标。
SetOutputFilenameTemplate

SetOutputFilenameTemplate 方法指定一个格式字符串, (模板) 指定文件名的格式。
SetPercentComplete

SetPercentComplete 方法设置一个值,该值指示当前操作的已完成部分。
SetProgressText

SetProgressText 方法设置进度对话框中进度栏的文本。
SetProperty

SetProperty 方法设置项的属性。
SetSequencePaddingWidth

SetSequencePaddingWidth 方法设置一个值,该值指示文件名中顺序字段的宽度。
SetSequenceZeroPadding

SetSequenceZeroPadding 方法设置一个值,该值指示是使用零还是空格填充顺序文件名。
SetSubmitButtonText

SetPrompt 方法设置对话框中显示的文本,提示用户选择设备。
SetTitle

SetTitle 方法设置设备选择对话框的标题。
SetTitle

SetTitle 方法设置进度对话框的标题。
ShowCheckbox

ShowCheckbox 方法指示是否在进度对话框中显示检查框,指示是否在传输后删除图像。
StartDelete

StartDelete 方法在开始从设备中删除项时提供扩展功能。
StartEnumeration

开始枚举要获取的项时,StartEnumeration 方法提供扩展功能。
StartItemDelete

每次从设备中删除单个项时,StartItemDelete 方法都会提供扩展功能。 应用程序提供 StartItemDelete 方法的实现。
StartItemTransfer

每次开始传输项时,StartItemTransfer 方法都会提供扩展功能。 应用程序提供 StartItemTransfer 方法的实现。
StartTransfer

StartTransfer 方法在从设备开始传输项时提供额外的处理。 应用程序提供 StartTransfer 方法的实现。
TransferComplete

在传输会话完成时提供扩展功能。 应用程序提供 TransferComplete 方法的实现。
UpdateDeletePercent

当删除的项的百分比发生更改时,UpdateDeletePercent 方法提供扩展功能。 应用程序提供 UpdateDeletePercent 方法的实现。
UpdateTransferPercent

当传输的项百分比发生更改时,UpdateTransferPercent 方法提供扩展功能。 应用程序提供 UpdateTransferPercent 方法的实现。

接口

 
IPhotoAcquire

IPhotoAcquire 接口提供从设备获取照片的方法。
IPhotoAcquireDeviceSelectionDialog

提供一个对话框,用于选择要从中获取图像的设备。
IPhotoAcquireItem

IPhotoAcquireItem 接口提供用于处理从设备获取的项的方法。
IPhotoAcquireOptionsDialog

IPhotoAcquireOptionsDialog 界面用于显示选项对话框,用户可在其中选择照片获取设置(如文件名格式),以及是否旋转图像、提示输入标记名称或在导入后擦除相机中的照片。
IPhotoAcquirePlugin

如果要创建与 Windows Vista 用户界面 (UI) 一起运行的插件,以实现 IPhotoAcquirePlugin 接口。 启用插件需要注册表设置。
IPhotoAcquireProgressCB

如果要在获取过程中的不同阶段执行额外的处理,则可以实现 IPhotoAcquireProgressCB 接口。
IPhotoAcquireSettings

IPhotoAcquireSettings 接口用于处理图像获取设置,例如文件名格式。
IPhotoAcquireSource

IPhotoAcquireSource 接口用于从设备获取项。
IPhotoProgressDialog

提供枚举或导入图像时可能显示的进度对话框。 对话框是模式对话框,在自己的线程中运行。
IUserInputString

IUserInputString 接口表示在请求用户输入字符串时创建的对象,例如,在获取标记的名称时。