WorkflowView.OnQueryContinueDrag(QueryContinueDragEventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre durante uma operação de arrastar e permite que a origem de arrastar determine se a opção de arrastar deve ser cancelada.
protected:
override void OnQueryContinueDrag(System::Windows::Forms::QueryContinueDragEventArgs ^ qcdevent);
protected override void OnQueryContinueDrag (System.Windows.Forms.QueryContinueDragEventArgs qcdevent);
override this.OnQueryContinueDrag : System.Windows.Forms.QueryContinueDragEventArgs -> unit
Protected Overrides Sub OnQueryContinueDrag (qcdevent As QueryContinueDragEventArgs)
Parâmetros
- qcdevent
- QueryContinueDragEventArgs
Um QueryContinueDragEventArgs que contém informações sobre o evento.
Comentários
O OnQueryContinueDrag evento é acionado quando há uma alteração no estado do teclado ou do botão do mouse durante uma operação de arrastar. O OnQueryContinueDrag evento permite que a origem do arrasto determine se a operação de arrastar deve ser cancelada.
Eventos relacionados a operações de arrastar são gerados quando o controle é um destino de soltar válido. O OnGiveFeedback evento é gerado com o efeito de arrastar especificado. Para obter uma lista de efeitos de arrastar, consulte a DragDropEffects enumeração .
As alterações na posição do cursor do mouse, no estado do teclado e no estado do botão do mouse são controladas.
Se o usuário sair de uma janela, o OnDragLeave evento será gerado.
Se o mouse entrar em outro controle, o OnDragEnter para esse controle será gerado.
Se o mouse se mover, mas permanecer dentro do mesmo controle, o OnDragOver evento será gerado.
Se houver uma alteração no estado do botão do teclado ou do mouse, o OnQueryContinueDrag evento será acionado e determinará se deseja continuar o arrastar, soltar os dados ou cancelar a operação com base no valor da Action
propriedade do evento QueryContinueDragEventArgs.
Se o valor for DragAction.Continue
, o OnDragOver evento será gerado para continuar a operação e o OnGiveFeedback evento será gerado com o novo efeito para que os comentários visuais apropriados possam ser definidos. Para obter uma lista de efeitos suspensos válidos, consulte a DragDropEffects enumeração .
Observação
Os OnDragOver eventos e OnGiveFeedback são emparelhados para que, à medida que o mouse se move pelo destino de soltar, o usuário recebe os comentários mais atualizados sobre a posição do mouse.
Se o valor for DragAction.Drop
, o valor do efeito de queda será retornado à origem, para que o aplicativo de origem possa executar a operação apropriada nos dados de origem; por exemplo, corte os dados se a operação for uma movimentação.
Se o valor for DragAction.Cancel
, o OnDragLeave evento será gerado.
Por padrão, o OnQueryContinueDrag evento define DragAction.Cancel
Action
como se a tecla ESC foi pressionada e define Action
DragAction.Drop
como se o botão esquerdo, do meio ou do mouse direito for pressionado.