ToolStripItem.GiveFeedback Evento

Definição

Ocorre durante uma operação de arrastar.Occurs during a drag operation.

public:
 event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;
[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.GiveFeedbackEventHandler GiveFeedback;
member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler 
Public Custom Event GiveFeedback As GiveFeedbackEventHandler 
Atributos

Exemplos

O exemplo de código a seguir demonstra o uso desse membro.The following code example demonstrates the use of this member. No exemplo, um manipulador de eventos relata a ocorrência do GiveFeedback evento.In the example, an event handler reports on the occurrence of the GiveFeedback event. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração.This report helps you to learn when the event occurs and can assist you in debugging. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.Show Console.WriteLine ou anexar a mensagem a uma multilinha TextBox.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para executar o código de exemplo, Cole-o em um projeto que contém uma instância de um tipo que ToolStripItemherda de, como ToolStripButton um ToolStripMenuItemou.To run the example code, paste it into a project that contains an instance of a type that inherits from ToolStripItem, such as a ToolStripButton or ToolStripMenuItem. Em seguida, nomeie ToolStripItem1 a instância e verifique se o manipulador de eventos está GiveFeedback associado ao evento.Then name the instance ToolStripItem1 and ensure that the event handler is associated with the GiveFeedback event.

private void ToolStripItem1_GiveFeedback(Object sender, GiveFeedbackEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Effect", e.Effect );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "UseDefaultCursors", e.UseDefaultCursors );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "GiveFeedback Event" );
}
Private Sub ToolStripItem1_GiveFeedback(sender as Object, e as GiveFeedbackEventArgs) _ 
     Handles ToolStripItem1.GiveFeedback

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Effect", e.Effect)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "UseDefaultCursors", e.UseDefaultCursors)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"GiveFeedback Event")

End Sub

Comentários

O evento GiveFeedback é acionado quando uma operação do tipo "arrastar-e-soltar" é iniciada.The GiveFeedback event is raised when a drag-and-drop operation is started. O GiveFeedback evento permite que a origem de um evento de arrastar modifique a aparência do ponteiro do mouse para dar aos comentários visuais do usuário durante uma operação de arrastar e soltar.The GiveFeedback event allows the source of a drag event to modify the appearance of the mouse pointer in order to give the user visual feedback during a drag-and-drop operation.

Os comentários a seguir descrevem como e quando eventos relacionados a operações de arrastar e soltar são gerados.The following remarks describe how and when events related to drag-and-drop operations are raised.

O DoDragDrop método determina o item sob o local do cursor atual.The DoDragDrop method determines the item under the current cursor location. Em seguida, ele verifica se o item é um destino de soltura válido.It then checks to see if the item is a valid drop target.

Se o item for um destino de soltura válido, GiveFeedback o evento será gerado com o efeito de arrastar e soltar especificado.If the item is a valid drop target, the GiveFeedback event is raised with the drag-and-drop effect specified. Para obter uma lista de efeitos de arrastar e soltar, consulte a DragDropEffects enumeração.For a list of drag-and-drop effects, see the DragDropEffects enumeration.

As alterações na posição do cursor do mouse, no estado do teclado e no estado do botão do mouse são rastreadas da seguinte maneira:Changes in the mouse cursor position, keyboard state, and mouse button state are tracked in the following manner:

  • Se o usuário sai de uma janela, o DragLeave evento é gerado.If the user moves out of a window, the DragLeave event is raised.

  • Se o mouse entrar em outro item, DragEnter o para esse controle será gerado.If the mouse enters another item, the DragEnter for that control is raised.

  • Se o mouse se mover, mas permanecer dentro do mesmo item DragOver , o evento será gerado.If the mouse moves but stays within the same item, the DragOver event is raised.

Se houver uma alteração no estado do botão do mouse ou do teclado, QueryContinueDrag o evento será gerado e determinará se deseja continuar a arrastar, para descartar os dados ou para cancelar a operação com base no Action valor da QueryContinueDragEventArgsPropriedade do evento.If there is a change in the keyboard or mouse button state, the QueryContinueDrag event is raised and determines whether to continue the drag, to drop the data, or to cancel the operation based on the value of the Action property of the event's QueryContinueDragEventArgs.

Se o valor de DragAction for Continue, o DragOver evento será gerado para continuar a operação e o GiveFeedback evento será gerado com o novo efeito, de modo que os comentários visuais apropriados possam ser definidos.If the value of DragAction is Continue, the DragOver event is raised to continue the operation and the GiveFeedback event is raised with the new effect so appropriate visual feedback can be set. Para obter uma lista de efeitos de remoção válidos, DragDropEffects consulte a enumeração.For a list of valid drop effects, see the DragDropEffects enumeration.

Os DragOver eventos GiveFeedback e são emparelhados de forma que, à medida que o mouse se move entre o destino de soltura, o usuário recebe os comentários mais atualizados sobre a posição do mouse, da seguinte maneira:The DragOver and GiveFeedback events are paired so that as the mouse moves across the drop target, the user is given the most up-to-date feedback on the mouse's position, as follows:

  • Se o valor de DragAction for Drop, o valor do efeito de soltar será retornado para a origem, de modo que o aplicativo de origem poderá executar a operação apropriada nos dados de origem; por exemplo, recortar os dados se a operação foi movida.If the value of DragAction is Drop, the drop effect value is returned to the source, so the source application can perform the appropriate operation on the source data; for example, cut the data if the operation was a move.

  • Se o valor de DragAction for Cancel, o DragLeave evento será gerado.If the value of DragAction is Cancel, the DragLeave event is raised.

Aplica-se a