DragEventArgs Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Daten für Drag-and-Drop-Ereignisse bereit.

public ref class DragEventArgs sealed : RoutedEventArgs

/// [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 DragEventArgs final : RoutedEventArgs

[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 DragEventArgs : RoutedEventArgs

Public NotInheritable Class DragEventArgs
Inherits RoutedEventArgs

Vererbung: Object Platform::Object IInspectable RoutedEventArgs DragEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

DragEventArgs wird als Ereignisdaten für diese Ereignisse verwendet:

Bei diesen Ereignissen handelt es sich um Routingereignisse. Das Ändern des Werts der Handled-Eigenschaft von DragEventArgs aus einem Ereignishandler kann das Verhalten eines Routingereignisses beeinflussen. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Die Control-Klasse verfügt über vorverkabelte Ereignishandler, die von Control abgeleitete Typen überschreiben können, um eine klassenbasierte Behandlung für die Drag-Drop-Ereignisse bereitzustellen, und diese Methoden verwenden auch DragEventArgs als Parameter. Diese Methoden werden im Anschluss beschrieben:

Die Windows-Runtime Implementierung von Drag-Drop-Konzepten erlaubt es nur bestimmten Steuerelementen und Eingabeaktionen, eine Drag-Drop-Aktion zu initiieren. Es gibt keine generalisierte DoDragDrop-Methode , die es jedem UI-Element ermöglicht, eine Drag-Drop-Aktion zu initiieren. Die Standard Quelle einer Drag-Drop-Aktion ist das Ziehen der Elemente einer Liste, z. B. GridView. Bei einer Listenelement-Drag-Drop-Aktion kann der Datenwert in Ereignisdaten möglicherweise aus den vom Steuerelement definierten Standarddaten für das Element geändert werden. Dazu wird das DragItemsStarting-Ereignis behandelt und mit dem DataPackage-Objekt gearbeitet, das von der DragItemsStartingEventArgs.Data-Eigenschaft in den Ereignisdaten abgerufen wird.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	AllowedOperations

Eigenschaften

AcceptedOperation	Ruft einen Wert ab, der angibt, welche Vorgänge (keine, Verschieben, Kopieren und/oder Verknüpfung) vom Ziel des Ziehereignisses akzeptiert werden können, oder legt diesen fest.
AllowedOperations	Ruft einen Wert ab, der angibt, welche Vorgänge (keine, Verschieben, Kopieren und/oder Verknüpfung) von der Quelle des Ziehereignisses zulässig sind.
Data	Ruft ein Datenobjekt (DataPackage) ab, das die Daten enthält, die dem entsprechenden Ziehereignis zugeordnet sind, oder legt es fest. Dieser Wert ist nicht in allen Ereignisfällen nützlich. Insbesondere muss das Ereignis von einem gültigen Ablageziel behandelt werden.
DataView	Ruft eine schreibgeschützte Kopie des Data-Objekts ab.
DragUIOverride	Ruft die visuelle Darstellung der gezogenen Daten ab.
Handled	Ruft einen Wert ab, der den aktuellen Zustand der Ereignisbehandlung für ein Routingereignis beim Durchlaufen der Route angibt, oder legt diesen fest.
Modifiers	Ruft eine Flagenumeration ab, die den aktuellen Zustand der UMSCHALTTASTE, der STRG-Taste und der ALT-Taste sowie den Zustand der Maustasten angibt.
OriginalSource	Ruft einen Verweis auf das -Objekt ab, das das -Ereignis ausgelöst hat. Dies ist häufig ein Vorlagenteil eines Steuerelements und nicht ein Element, das in der App-Benutzeroberfläche deklariert wurde. (Geerbt von RoutedEventArgs)

Methoden

GetDeferral()	Unterstützt asynchrone Drag-and-Drop-Vorgänge, indem ein DragOperationDeferral-Objekt erstellt und zurückgegeben wird.
GetPosition(UIElement)	Gibt einen Drop point zurück, der relativ zu einem angegebenen UIElement ist.

Gilt für:

Freigeben über