다음을 통해 공유


DragEventArgs 클래스

정의

끌어서 놓기 이벤트에 대한 데이터를 제공합니다.

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
상속
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

DragEventArgs는 다음 이벤트에 대한 이벤트 데이터로 사용됩니다.

이러한 이벤트는 라우트된 이벤트입니다. 이벤트 처리기에서 DragEventArgs의 Handled 속성 값을 변경하면 라우트된 이벤트가 동작하는 방식에 영향을 줄 수 있습니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

Control 클래스에는 끌어서 놓기 이벤트에 대한 클래스 기반 처리를 제공하기 위해 Control 파생 형식이 재정의할 수 있는 미리 연결된 이벤트 처리기가 있으며, 이러한 메서드는 DragEventArgs를 매개 변수로 사용합니다. 이러한 메서드는 다음과 같습니다.

끌어서 놓기 개념의 Windows 런타임 구현은 특정 컨트롤 및 입력 작업만 끌어서 놓기 작업을 시작할 수 있도록 허용합니다. UI 요소가 끌어서 놓기 작업을 시작할 수 있도록 허용하는 일반화된 DoDragDrop 메서드는 없습니다. 끌어서 놓기 작업의 기본 소스는 GridView와 같은 목록의 항목을 끌 때입니다. 목록 항목 끌어서 놓기 작업의 경우 이벤트 데이터의 데이터 값은 잠재적으로 항목에 대한 컨트롤 정의 기본 데이터에서 수정할 수 있습니다. 이 작업은 DragItemsStarting 이벤트를 처리하고 이벤트 데이터의 DragItemsStartingEventArgs.Data 속성에서 가져온 DataPackage 개체를 사용하여 수행됩니다.

버전 기록

Windows 버전 SDK 버전 추가된 값
1607 14393 AllowedOperations

속성

AcceptedOperation

끌기 이벤트의 대상에서 수락할 수 있는 작업(없음, 이동, 복사 및/또는 링크)을 지정하는 값을 가져오거나 설정합니다.

AllowedOperations

끌기 이벤트의 원본에서 허용되는 작업(없음, 이동, 복사 및/또는 링크)을 지정하는 값을 가져옵니다.

Data

해당 끌기 이벤트와 연결된 데이터를 포함하는 데이터 개체(DataPackage)를 가져오거나 설정합니다. 이 값은 모든 이벤트 사례에서 유용하지 않습니다. 특히 이벤트는 유효한 놓기 대상에 의해 처리되어야 합니다.

DataView

Data 개체의 읽기 전용 복사본을 가져옵니다.

DragUIOverride

끌 데이터의 시각적 표현을 가져옵니다.

Handled

경로를 따라 이동할 때 라우트된 이벤트의 현재 이벤트 처리 상태를 나타내는 값을 가져오거나 설정합니다.

Modifiers

Shift, Ctrl 및 Alt 키의 현재 상태와 마우스 단추의 상태를 나타내는 플래그 열거형을 가져옵니다.

OriginalSource

이벤트를 발생시킨 개체에 대한 참조를 가져옵니다. 앱 UI에서 선언된 요소가 아닌 컨트롤의 템플릿 부분입니다.

(다음에서 상속됨 RoutedEventArgs)

메서드

GetDeferral()

DragOperationDeferral 개체를 만들고 반환하여 비동기 끌어서 놓기 작업을 지원합니다.

GetPosition(UIElement)

지정된 UIElement를 기준으로 하는 드롭포인트를 반환합니다.

적용 대상

추가 정보