Control.GiveFeedback Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica durante un'operazione di trascinamento.
public:
event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;public event System.Windows.Forms.GiveFeedbackEventHandler GiveFeedback;public event System.Windows.Forms.GiveFeedbackEventHandler? GiveFeedback;member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler Public Custom Event GiveFeedback As GiveFeedbackEventHandler Tipo evento
Esempio
Nell'esempio di codice seguente viene illustrata un'operazione di trascinamento della selezione tra due controlli ListBox. Nell'esempio viene chiamato il metodo DoDragDrop all'avvio dell'azione di trascinamento. L'azione di trascinamento inizia se il mouse è stato spostato più di SystemInformation.DragSize dalla posizione del mouse durante l'evento MouseDown. Il metodo IndexFromPoint viene utilizzato per determinare l'indice dell'elemento da trascinare durante l'evento MouseDown.
L'esempio illustra anche l'uso di cursori personalizzati per l'operazione di trascinamento della selezione. L'esempio richiede che due file di cursore, 3dwarro.cur e 3dwno.cur, esistano nella directory dell'applicazione, rispettivamente per il trascinamento personalizzato e i cursori senza rilascio. I cursori personalizzati verranno utilizzati se è selezionata la UseCustomCursorsCheckCheckBox. I cursori personalizzati vengono impostati nel gestore eventi GiveFeedback.
Lo stato della tastiera viene valutato nel gestore eventi DragOver per il ListBoxdestro, per determinare quale operazione di trascinamento si baserà sullo stato dei tasti MAIUSC, CTRL, ALT o CTRL+ALT. La posizione nel ListBox in cui si verifica l'eliminazione viene determinata anche durante l'evento DragOver. Se i dati da eliminare non sono un String, il DragEventArgs.Effect è impostato su None in DragDropEffects. Infine, lo stato del rilascio viene visualizzato nel DropLocationLabelLabel.
I dati da eliminare per il ListBox corretto sono determinati nel gestore eventi DragDrop e il valore String viene aggiunto nella posizione appropriata nel ListBox. Se l'operazione di trascinamento si sposta all'esterno dei limiti del form, l'operazione di trascinamento della selezione viene annullata nel gestore eventi QueryContinueDrag.
Questo estratto di codice illustra l'uso dell'evento GiveFeedback. Vedere il metodo DoDragDrop per l'esempio di codice completo.
void ListDragSource_GiveFeedback( Object^ /*sender*/, System::Windows::Forms::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;
}
}
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;
}
}
Private Sub ListDragSource_GiveFeedback(ByVal sender As Object, ByVal e As GiveFeedbackEventArgs) Handles ListDragSource.GiveFeedback
' Use custom cursors if the check box is checked.
If (UseCustomCursorsCheck.Checked) Then
' Set the custom cursor based upon the effect.
e.UseDefaultCursors = False
If ((e.Effect And DragDropEffects.Move) = DragDropEffects.Move) Then
Cursor.Current = MyNormalCursor
Else
Cursor.Current = MyNoDropCursor
End If
End If
End Sub
Commenti
L'evento GiveFeedback viene generato quando viene avviata un'operazione di trascinamento della selezione. Con l'evento GiveFeedback, l'origine di un evento di trascinamento può modificare l'aspetto del puntatore del mouse per fornire all'utente feedback visivo durante un'operazione di trascinamento della selezione.
Di seguito viene descritto come e quando vengono generati eventi correlati alle operazioni di trascinamento della selezione.
Il metodo DoDragDrop determina il controllo sotto la posizione corrente del cursore. Controlla quindi se il controllo è una destinazione di rilascio valida.
Se il controllo è una destinazione di rilascio valida, l'evento GiveFeedback viene generato con l'effetto di trascinamento della selezione specificato. Per un elenco degli effetti di trascinamento della selezione, vedere l'enumerazione DragDropEffects.
Vengono rilevate modifiche alla posizione del cursore del mouse, allo stato della tastiera e al pulsante del mouse.
Se l'utente si sposta all'esterno di una finestra, viene generato l'evento DragLeave.
Se il mouse entra in un altro controllo, viene generato il DragEnter per tale controllo.
Se il mouse si sposta ma rimane all'interno dello stesso controllo, viene generato l'evento DragOver.
Se si verifica una modifica dello stato della tastiera o del pulsante del mouse, viene generato l'evento QueryContinueDrag e determina se continuare il trascinamento, rilasciare i dati o annullare l'operazione in base al valore della proprietà Action dell'evento QueryContinueDragEventArgs.
Se il valore di DragAction è
Continue, l'evento DragOver viene generato per continuare l'operazione e l'evento GiveFeedback viene generato con il nuovo effetto in modo che sia possibile impostare il feedback visivo appropriato. Per un elenco di effetti di rilascio validi, vedere l'enumerazione DragDropEffects.Nota
Gli eventi DragOver e GiveFeedback vengono associati in modo che quando il mouse si sposta attraverso la destinazione di rilascio, all'utente viene assegnato il feedback più up-to-date sulla posizione del mouse.
Se il valore di DragAction è
Drop, il valore dell'effetto di rilascio viene restituito all'origine, in modo che l'applicazione di origine possa eseguire l'operazione appropriata sui dati di origine; Ad esempio, tagliare i dati se l'operazione è stata spostata.Se il valore di DragAction è
Cancel, viene generato l'evento DragLeave.
Per altre informazioni sulla gestione degli eventi, vedere Gestione e generazione di eventi.
