DevicePicker Klasse

Definition

Namespace:

Windows.Devices.Enumeration

Stellt ein Auswahl-Flyout dar, das eine Liste von Geräten enthält, aus denen der Benutzer auswählen kann.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

Vererbung

Object Platform::Object IInspectable DevicePicker

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Konstruktoren

DevicePicker()

Erstellt ein DevicePicker-Objekt . Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Eigenschaften

Appearance	Ruft die Farben der Auswahl ab.
Filter	Ruft den Filter ab, mit dem ausgewählt wird, welche Geräte in der Auswahl angezeigt werden sollen.
RequestedProperties	Ruft eine Auflistung von Eigenschaften für das zurückgegebene Geräteinformationsobjekt ab.

Methoden

Hide()	Blendet die Auswahl aus.
PickSingleDeviceAsync(Rect)	Zeigt die Benutzeroberfläche der Auswahl an und gibt das ausgewählte Gerät zurück. erfordert keine Registrierung für ein Ereignis. Die Auswahl fliegt vom Rand des angegebenen Rechtecks aus.
PickSingleDeviceAsync(Rect, Placement)	Zeigt die Benutzeroberfläche der Auswahl an und gibt das ausgewählte Gerät zurück. erfordert keine Registrierung für ein Ereignis. Die Auswahl fliegt vom angegebenen Rand des angegebenen Rechtecks aus.
SetDisplayStatus(DeviceInformation, String, DevicePickerDisplayStatusOptions)	Updates die Benutzeroberfläche der Auswahl, um die bereitgestellten status und Anzeigeoptionen für ein angegebenes Gerät widerzuspiegeln. Der Zustand der Auswahlbenutzeroberfläche bleibt in der Regel erhalten, bis das Betriebssystem neu gestartet wird.
Show(Rect)	Zeigt die Benutzeroberfläche der Auswahl an. Die Auswahl fliegt vom Rand des angegebenen Rechtecks aus.
Show(Rect, Placement)	Zeigt die Benutzeroberfläche der Auswahl an. Die Auswahl fliegt vom angegebenen Rand des angegebenen Rechtecks aus.

Ereignisse

DevicePickerDismissed	Gibt an, dass die Geräteauswahl vom Benutzer leicht verworfen wurde. Das leichte Schließen tritt auf, wenn der Benutzer auf eine andere Stelle als die Benutzeroberfläche der Auswahl klickt und die Benutzeroberfläche der Auswahl ausgeblendet wird.
DeviceSelected	Gibt an, dass der Benutzer ein Gerät in der Auswahl ausgewählt hat.
DisconnectButtonClicked	Gibt an, dass der Benutzer in der Auswahl auf die Schaltfläche zum Trennen eines Geräts geklickt oder getippt hat.

Weitere Informationen

• Beispiel für erweiterte Umwandlung (Windows 10)
• Anzeigen von WinRT UI-Objekten, die von CoreWindow abhängig sind