DragEventArgs Klasse
Definition
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.
Stellt Daten für Drag-and-Drop-Ereignisse bereit.
public ref class DragEventArgs sealed : RoutedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DragEventArgs : RoutedEventArgsPublic NotInheritable Class DragEventArgs
Inherits RoutedEventArgs- Vererbung
- Attribute
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 von 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 DragEventArgs auch 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.
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. |