DevicePicker Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DevicePicker final/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DevicePicker[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 DevicePickerfunction DevicePicker()Public NotInheritable Class DevicePicker- Inheritance
- Attributes
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, 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. |
| 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. |
| 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, Placement) |
Shows the picker UI. The picker flies out from the specified edge of the specified rectangle. |
| Show(Rect) |
Shows the picker UI. The picker flies out from the 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. |