ToolStripItem.DragOver Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ToolStripItem.cs

Nastane, když uživatel přetáhne položku přes oblast klienta této položky.

public:
 event System::Windows::Forms::DragEventHandler ^ DragOver;

[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.DragEventHandler? DragOver;

[<System.ComponentModel.Browsable(false)>]
member this.DragOver : System.Windows.Forms.DragEventHandler 

Public Custom Event DragOver As DragEventHandler 

Event Type

DragEventHandler

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V tomto příkladu obslužná rutina události hlásí výskyt DragOver události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct při ladění. Chcete-li hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy do víceřádkového řetězce TextBox.

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu, který dědí z ToolStripItemobjektu , například nebo ToolStripButtonToolStripMenuItem. Potom instanci ToolStripItem1 pojmenujte a ujistěte se, že je obslužná rutina události přidružená k DragOver události.

private void ToolStripItem1_DragOver(Object sender, DragEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Data", e.Data );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyState", e.KeyState );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "AllowedEffect", e.AllowedEffect );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Effect", e.Effect );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "DragOver Event" );
}

Private Sub ToolStripItem1_DragOver(sender as Object, e as DragEventArgs) _ 
     Handles ToolStripItem1.DragOver

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Data", e.Data)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyState", e.KeyState)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "AllowedEffect", e.AllowedEffect)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Effect", e.Effect)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"DragOver Event")

End Sub

Poznámky

Událost DragOver se vyvolá, když se kurzor myši přesune v mezích ovládacího prvku během operace přetažení.

Následující poznámky popisují, jak a kdy jsou vyvolány události související s operacemi přetažení.

Metoda DoDragDrop určuje položku pod aktuálním umístěním kurzoru. Pak zkontroluje, jestli je položka platným cílem pro odstranění.

Pokud je položka platným cílem přetažení, GiveFeedback je událost vyvolána se zadaným efektem přetažení. Seznam efektů přetažení najdete v výčtu DragDropEffects .

Změny v poloze kurzoru myši, stavu klávesnice a stavu tlačítka myši se sledují následujícím způsobem:

• Pokud se uživatel přesune mimo okno, DragLeave vyvolá se událost.

• Pokud myš zadá jinou položku, DragEnter je pro tento ovládací prvek vyvolán.

• Pokud se myš přesune, ale zůstane ve stejné položce, DragOver vyvolá se událost.

Pokud dojde ke změně stavu klávesnice nebo tlačítka myši, QueryContinueDrag událost se vyvolá a určí, zda má pokračovat přetažením, přetažením dat nebo zrušením operace na základě hodnoty Action vlastnosti události QueryContinueDragEventArgs.

Pokud je Continuehodnota DragAction , DragOver událost je vyvolána, aby pokračovala v operaci a GiveFeedback událost je vyvolána s novým efektem, aby bylo možné nastavit odpovídající vizuální zpětnou vazbu. Seznam platných efektů přetažení najdete ve výčtu DragDropEffects .

GiveFeedback Události DragOver jsou spárované tak, aby se při pohybu myši přes cíl přetažení dostal uživatel nejvíce up-to- datum zpětné vazby na pozici myši, jak je znázorněno níže:

• Pokud je Drophodnota DragAction , vrátí se hodnota efektu poklesu do zdroje, takže zdrojová aplikace může provést příslušnou operaci se zdrojovými daty, například vyjmout data, pokud byla operace přesunutím.

• Pokud je Cancelhodnota DragAction , DragLeave je vyvolána událost.