UIElement.StartDragAsync(PointerPoint) 메서드

정의

네임스페이스:

Windows.UI.Xaml

끌어서 놓기 작업을 시작합니다.

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

사용자가 화면과 상호 작용하는 포인터의 좌표와 끌기 시각적 개체가 연결된 위치입니다.

반환

IAsyncOperation<DataPackageOperation>

끌어서 놓기 작업의 유형과 작업의 성공 여부를 나타내는 DataPackageOperation 값입니다.

특성

RemoteAsyncAttribute

예제

이 예제에서는 Image 요소에서 PointerPressed 이벤트를 처리하여 끌기 작업을 시작하는 방법을 보여줍니다.

<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 은 끌기 작업이 이동, 복사 또는 링크인지 여부를 나타냅니다. 성공 여부와 DropCompleted 이벤트 인수의 DropResult 속성에서 제공하는 값과 동일합니다.

추가 정보

• DragStarting
• CanDrag
• 샘플 끌어서 놓기(Windows 10)