DevicePicker 类

定义

命名空间:

Windows.Devices.Enumeration

表示选取器浮出控件，其中包含可供用户选择的设备列表。

在桌面应用中，在以显示 UI 的方式使用此类的实例之前，需要将该对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public ref class DevicePicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DevicePicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DevicePicker

function DevicePicker()

Public NotInheritable Class DevicePicker

继承

Object Platform::Object IInspectable DevicePicker

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

构造函数

DevicePicker()

创建 DevicePicker 对象。 在桌面应用中，在以显示 UI 的方式使用此类的实例之前，需要将该对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

属性

Appearance	获取选取器的颜色。
Filter	获取用于选择要在选取器中显示的设备的筛选器。
RequestedProperties	获取返回的设备信息对象的属性集合。

方法

Hide()	隐藏选取器。
PickSingleDeviceAsync(Rect)	显示选取器 UI 并返回所选设备;不要求注册事件。 选取器从指定矩形的边缘飞出。
PickSingleDeviceAsync(Rect, Placement)	显示选取器 UI 并返回所选设备;不要求注册事件。 选取器从指定矩形的指定边缘飞出。
SetDisplayStatus(DeviceInformation, String, DevicePickerDisplayStatusOptions)	汇报选取器 UI 以反映指定设备提供的状态和显示选项。 选取器 UI 的状态通常一直持续到操作系统 (操作系统) 重启。
Show(Rect)	显示选取器 UI。 选取器从指定矩形的边缘飞出。
Show(Rect, Placement)	显示选取器 UI。 选取器从指定矩形的指定边缘飞出。

事件

DevicePickerDismissed	指示设备选取器被用户轻消除。 当用户单击选取器 UI 以外的某个位置并且选取器 UI 消失时，会发生轻量消除。
DeviceSelected	指示用户在选取器中选择了设备。
DisconnectButtonClicked	指示用户单击或点击选取器中设备的断开连接按钮。

另请参阅

• 高级转换示例 (Windows 10)
• 显示依赖于 CoreWindow 的 WinRT UI 对象