GiveFeedbackEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

GiveFeedbackEventArgs.cs

Fornece dados para o evento GiveFeedback, que ocorre durante uma operação de arrastar.

public class GiveFeedbackEventArgs : EventArgs

Herança

Object

EventArgs

GiveFeedbackEventArgs

Exemplos

O exemplo a seguir demonstra uma operação de arrastar e soltar entre dois controles ListBox. O exemplo chama o método DoDragDrop quando a ação de arrastar é iniciada. A ação de arrastar será iniciada se o mouse tiver se movido mais de SystemInformation.DragSize do local do mouse durante o evento MouseDown. O método IndexFromPoint é usado para determinar o índice do item a ser arrastado durante o evento MouseDown.

O exemplo também demonstra o uso de cursores personalizados para a operação de arrastar e soltar. O exemplo pressupõe que dois arquivos de cursor, 3dwarro.cur e 3dwno.cur, existam no diretório do aplicativo, para os cursores de arrastar e sem soltar personalizados, respectivamente. Os cursores personalizados serão usados se o UseCustomCursorsCheckCheckBox for verificado. Os cursores personalizados são definidos no manipulador de eventos GiveFeedback.

O estado do teclado é avaliado no manipulador de eventos DragOver para a ListBoxdireita, para determinar qual operação de arrastar será baseada no estado das teclas SHIFT, CTRL, ALT ou CTRL+ALT. O local no ListBox em que a queda ocorreria também é determinado durante o evento DragOver. Se os dados a serem removidos não forem um String, o DragEventArgs.Effect será definido como DragDropEffects.None. Por fim, o status da queda é exibido no DropLocationLabelLabel.

Os dados a serem removidos para o ListBox direito são determinados no manipulador de eventos DragDrop e o valor String é adicionado no local apropriado no ListBox. Se a operação de arrastar se mover para fora dos limites do formulário, a operação de arrastar e soltar será cancelada no manipulador de eventos QueryContinueDrag.

Este trecho de código demonstra o uso da classe GiveFeedbackEventArgs. Consulte o método DoDragDrop para o exemplo de código completo.

private void ListDragSource_GiveFeedback(object sender, GiveFeedbackEventArgs e)
{
    // Use custom cursors if the check box is checked.
    if (UseCustomCursorsCheck.Checked)
    {
        // Sets the custom cursor based upon the effect.
        e.UseDefaultCursors = false;
        if ((e.Effect & DragDropEffects.Move) == DragDropEffects.Move)
            Cursor.Current = MyNormalCursor;
        else
            Cursor.Current = MyNoDropCursor;
    }
}

Comentários

O evento GiveFeedback ocorre durante uma operação de arrastar. Ele permite que a origem de um evento de arrastar modifique a aparência do ponteiro do mouse para fornecer ao usuário comentários visuais durante uma operação de arrastar e soltar. Um objeto GiveFeedbackEventArgs especifica o tipo de operação de arrastar e soltar e se os cursores padrão são usados.

Para obter informações sobre o modelo de evento, consulte manipulação e geração de eventos.

Construtores

GiveFeedbackEventArgs(DragDropEffects, Boolean, Bitmap, Point, Boolean)	Inicializa uma nova instância da classe GiveFeedbackEventArgs.
GiveFeedbackEventArgs(DragDropEffects, Boolean)	Inicializa uma nova instância da classe GiveFeedbackEventArgs.

Propriedades

CursorOffset	Obtém ou define o deslocamento do cursor de imagem de arrastar.
DragImage	Obtém ou define o bitmap de imagem de arrastar.
Effect	Obtém os comentários da operação de arrastar e soltar exibidos.
UseDefaultCursors	Obtém ou define se a operação de arrastar deve usar os cursores padrão associados aos efeitos de arrastar-soltar.
UseDefaultDragImage	Obtém ou define um valor que indica se uma imagem de arrastar de janela em camadas é usada.

Aplica-se a