DragDrop.DragOver Evento Anexado
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que atua como alvo de queda.
see AddDragOverHandler, and RemoveDragOverHandler
see AddDragOverHandler, and RemoveDragOverHandler
see AddDragOverHandler, and RemoveDragOverHandler
Exemplos
O exemplo seguinte mostra o DragOver gestor de eventos para um Ellipse elemento. Este código verifica se o DataObject ser arrastado sobre a elipse contém dados de cadeia que podem ser convertidos para um Brush. Se assim for, define a DragEventArgs.Effects propriedade para Copy. Isto indica à fonte de arrasto que os dados podem ser copiados para a elipse. Se os dados não puderem ser convertidos para um Brush, a DragEventArgs.Effects propriedade é definida para None. Isto indica à fonte de arrastar que a elipse não é um alvo válido para os dados.
private void ellipse_DragOver(object sender, DragEventArgs e)
{
e.Effects = DragDropEffects.None;
// 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, allow copying.
BrushConverter converter = new BrushConverter();
if (converter.IsValid(dataString))
{
e.Effects = DragDropEffects.Copy | DragDropEffects.Move;
}
}
}
Private Sub Ellipse_DragOver(ByVal sender As System.Object, ByVal e As System.Windows.DragEventArgs)
e.Effects = DragDropEffects.None
' 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
e.Effects = DragDropEffects.Copy Or DragDropEffects.Move
End If
End If
End Sub
Observações
Este evento é levantado continuamente enquanto um objeto arrastado está dentro dos limites de um elemento que atua como alvo de queda. Este evento não é elevado se a propriedade do AllowDrop elemento for false.
O DragOver evento é emparelhado com o GiveFeedback evento na fonte de arrasto. No gestor de DragOver eventos, normalmente verifica-se se os dados transferidos estão num formato que o drop target consiga processar. Também pode verificar se alguma tecla modificadora está pressionada, o que normalmente indica se o utilizador pretende um movimento ou uma ação de cópia. Depois destas verificações, defines a DragEventArgs.Effects propriedade para notificar a fonte do arrasto qual o efeito que a largada dos dados terá para ser. A fonte de arrastar recebe esta informação na Effects propriedade dos GiveFeedback argumentos do evento e pode definir um cursor apropriado para dar feedback ao utilizador.
Informação sobre Eventos Roteados
| Iteme | Value |
|---|---|
| Campo identificador | DragOverEvent |
| Estratégia de encaminhamento | Borbulhar |
| Delegar | DragEventHandler |
O evento correspondente de tunelamento é PreviewDragOver.