DragDrop.Drop 연결된 이벤트

정의

이 이벤트는 개체를 놓기 대상의 역할을 하는 요소 경계 내에 놓는 동안 발생합니다.Occurs when an object is dropped within the bounds of an element that is acting as a drop target.

see AddDropHandler, and RemoveDropHandler
see AddDropHandler, and RemoveDropHandler
see AddDropHandler, and RemoveDropHandler

예제

다음 예제에서는 Ellipse 요소에 대한 Drop 이벤트 처리기를 보여 줍니다.The following example shows the Drop event handler for an Ellipse element. 이 코드는 끌어서 놓기 작업의 효과 적용 합니다.This code applies the effects of the drag-and-drop operation. 타원 위로 끄는 DataObjectBrush로 변환될 수 있는 문자열 데이터가 포함되어 있는지 여부를 확인합니다.It checks to see if the DataObject being dragged over the ellipse contains string data that can be converted to a Brush. 포함되어 있는 경우 Brush가 타원에 적용됩니다.If so, the Brush is applied to the ellipse. 데이터를 Brush로 변환할 수 없는 경우 아무 작업도 수행되지 않습니다.If the data cannot be converted to a Brush, no action is performed.

private void ellipse_Drop(object sender, DragEventArgs e)
{
    Ellipse ellipse = sender as Ellipse;
    if (ellipse != null)
    {
        // If the DataObject contains string data, extract it.
        if (e.Data.GetDataPresent(DataFormats.StringFormat))
        {
            string dataString = (string)e.Data.GetData(DataFormats.StringFormat);

            // If the string can be converted into a Brush, 
            // convert it and apply it to the ellipse.
            BrushConverter converter = new BrushConverter();
            if (converter.IsValid(dataString))
            {
                Brush newFill = (Brush)converter.ConvertFromString(dataString);
                ellipse.Fill = newFill;
            }
        }
    }
}
Private Sub Ellipse_Drop(ByVal sender As System.Object, ByVal e As System.Windows.DragEventArgs)
    Dim ellipse = TryCast(sender, Ellipse)
    If ellipse IsNot Nothing Then

        ' If the DataObject contains string data, extract it.
        If e.Data.GetDataPresent(DataFormats.StringFormat) Then
            Dim dataString = e.Data.GetData(DataFormats.StringFormat)

            ' If the string can be converted into a Brush, convert it.
            Dim converter As New BrushConverter()
            If converter.IsValid(dataString) Then
                Dim newFill As Brush = CType(converter.ConvertFromString(dataString), Brush)
                ellipse.Fill = newFill
            End If
        End If
    End If
End Sub

설명

Drop 이벤트는 놓기 대상 역할을 하는 요소 범위 내에서 개체 삭제 되는 경우 한 번씩 발생 합니다.The Drop event is raised once when an object is dropped within the bounds of an element that is acting as a drop target. 경우에이 이벤트가 발생 하지 않습니다 요소의 AllowDrop 속성은 false합니다.This event is not raised if the element's AllowDrop property is false. 이 이벤트는 끌어서 놓기 작업을 끝냅니다.This event ends the drag-and-drop operation.

Drop 에서 전송된 된 데이터를 추출 이벤트 처리기는 DataObject 애플리케이션에 필요한 데이터의 처리를 수행 합니다.In the Drop event handler, you extract the transferred data from the DataObject and perform any processing of the data that your application requires. 복사 또는 이동 등의 드롭 효과의 끌기 소스에 알리기 위해 설정 합니다 DragEventArgs.Effects 속성에는 Drop 이벤트 처리기입니다.To notify the drag source of the effect of the drop, such as a copy or move, set the DragEventArgs.Effects property in the Drop event handler. 이 속성의 값은 반환 값을 DoDragDrop 끌어서 놓기 작업을 시작 하는 메서드입니다.The value of this property is the return value of the DoDragDrop method that initiated the drag-and-drop operation. 반환 되는 값을 일치 하지 않는 경우 중 하나는 allowedEffects 에 대 한 호출에 지정 된 DoDragDrop, 끌어서 놓기 작업이 수행 되지 않습니다.If the value that is returned does not match one of the allowedEffects specified in the call to DoDragDrop, the drag-and-drop operation is not performed. 초기 값을 DragEventArgs.Effects 속성은 동일 합니다 allowedEffects 에 대 한 호출에 지정 된는 DoDragDrop 메서드.The initial value of the DragEventArgs.Effects property is the same as the allowedEffects specified in the call to the DoDragDrop method. 설정 하지 않은 경우는 DragEventArgs.Effects 속성을 초기 값이 반환 되 고 하나 것으로 가정 합니다 allowedEffects 발생 했습니다.If you do not set the DragEventArgs.Effects property, this initial value is returned and it is assumed that one the allowedEffects occurred.

라우팅 이벤트 정보Routed Event Information

식별자 필드Identifier field DropEvent
라우팅 전략Routing strategy 버블링Bubbling
대리자Delegate DragEventHandler

해당 터널링 이벤트가 PreviewDrop합니다.The corresponding tunneling event is PreviewDrop.

적용 대상

추가 정보