DevicePicker Class

Definition

Namespace:

Windows.Devices.Enumeration

Represents a picker flyout that contains a list of devices for the user to choose from.

In a desktop app, before using an instance of this class in a way that displays UI, you'll need to associate the object with its owner's window handle. For more info, and code examples, see Display WinRT UI objects that depend on CoreWindow.

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

Inheritance

Object Platform::Object IInspectable DevicePicker

Attributes

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Constructors

DevicePicker()

Creates a DevicePicker object. In a desktop app, before using an instance of this class in a way that displays UI, you'll need to associate the object with its owner's window handle. For more info, and code examples, see Display WinRT UI objects that depend on CoreWindow.

Properties

Appearance	Gets the colors of the picker.
Filter	Gets the filter used to choose what devices to show in the picker.
RequestedProperties	Gets a collection of properties for the returned device information object.

Methods

Hide()	Hides the picker.
PickSingleDeviceAsync(Rect)	Shows the picker UI and returns the selected device; does not require you to register for an event. The picker flies out from the edge of the specified rectangle.
PickSingleDeviceAsync(Rect, Placement)	Shows the picker UI and returns the selected device; does not require you to register for an event. The picker flies out from the specified edge of the specified rectangle.
SetDisplayStatus(DeviceInformation, String, DevicePickerDisplayStatusOptions)	Updates the picker UI to reflect the provided status and display options for a specified device. The state of the picker UI typically persists until the operating system (OS) is restarted.
Show(Rect)	Shows the picker UI. The picker flies out from the edge of the specified rectangle.
Show(Rect, Placement)	Shows the picker UI. The picker flies out from the specified edge of the specified rectangle.

Events

DevicePickerDismissed	Indicates that the device picker was light dismissed by the user. Light dismiss happens when the user clicks somewhere other than the picker UI and the picker UI disappears.
DeviceSelected	Indicates that the user selected a device in the picker.
DisconnectButtonClicked	Indicates that the user clicked or tapped the disconnect button for a device in the picker.

See also

• Advanced casting sample (Windows 10)
• Display WinRT UI objects that depend on CoreWindow