UIElement.StartDragAsync(PointerPoint) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициирует операцию перетаскивания.
public:
virtual IAsyncOperation<DataPackageOperation> ^ StartDragAsync(PointerPoint ^ pointerPoint) = StartDragAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<DataPackageOperation> StartDragAsync(PointerPoint const& pointerPoint);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<DataPackageOperation> StartDragAsync(PointerPoint pointerPoint);function startDragAsync(pointerPoint)Public Function StartDragAsync (pointerPoint As PointerPoint) As IAsyncOperation(Of DataPackageOperation)Параметры
- pointerPoint
- PointerPoint
Координаты указателя, в котором пользователь взаимодействует с экраном и где прикреплен визуальный элемент перетаскивания.
Возвращаемое значение
Значение DataPackageOperation , указывающее тип операции перетаскивания и успешность операции.
- Атрибуты
Примеры
В этом примере показано, как обработать событие PointerPressed в элементе Image , чтобы инициировать операцию перетаскивания.
<Image x:Name="myImage" Source="ms-appx:///Assets/Logo.png"
PointerPressed="myImage_PointerPressed" />
private async void myImage_PointerPressed(object sender, PointerRoutedEventArgs e)
{
var pointerPoint = e.GetCurrentPoint(sender as UIElement);
var dropStatus = await myImage.StartDragAsync(pointerPoint);
if (dropStatus == DataPackageOperation.Move)
{
// App specific code for a "move" operation.
}
}
Комментарии
При реализации пользовательского обнаружения жестов для инициации операции перетаскивания можно вызвать метод StartDragAsync, чтобы программно инициировать операцию перетаскивания для любого элемента UIElement. Вызов этого метода приводит к возникновению события DragStarting . Обработайте событие DragStarting , чтобы указать другие свойства операции, такие как пакет данных и визуальный элемент перетаскивания.
Параметр pointerPoint — это точка, в которой пользователь взаимодействует с экраном с помощью устройства ввода (сенсорного ввода, мыши или пера). Визуальный элемент перетаскивания, отображаемый во время операции перетаскивания, прикрепляется к указателю, указанному в предоставленном вызывающей точкой PointerPoint.
Объект DataPackageOperation, возвращаемый этим методом, указывает, является ли операция перетаскивания перемещением, копированием или ссылкой; и является ли это успехом. Это то же значение, которое предоставляется свойством DropResult в аргументах события DropCompleted .