Freigeben über


DragEventArgs Klasse

Definition

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

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:

Weitere Informationen