Freigeben über

DragOver-Ereignis

  • Artikel

Wird ausgelöst, wenn ein Steuerelement über ein Zielobjekt gezogen wird.

PROCEDURE Object.DragOver
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord, nState

Parameter

Sie müssen in der Ereignisprozedur eine LPARAMETERS- oder eine PARAMETERS-Anweisung und einen Namen für jeden Parameter angeben, da sonst ein Fehler ausgegeben wird. Visual FoxPro übergibt dem DragOver-Ereignis vier bis fünf Parameter in der folgenden Reihenfolge:

  • nIndex
    Kennzeichnet ein Steuerelement eindeutig, wenn es sich in einem Steuerelementarray befindet.

  • oSource
    Enthält einen Verweis auf das Steuerelement, das gezogen wird. Sie können mit diesem Parameter Eigenschaften und Methoden des Steuerelements ansprechen.

  • nXCoord, nYCoord
    Enthält die horizontale (nXCoord) und vertikale (nYCoord) Position des Mauszeigers innerhalb des Formulars, wenn Daten auf einem Dropziel abgelegt werden. Diese Koordinaten beziehen sich auf das Koordinatensystem des Formulars. Die Maßeinheit wird durch die ScaleMode-Eigenschaft des Formulars festgelegt.

  • nState
    nState enthält eine Zahl, die den Übergangsstatus des Steuerelements, das gezogen wird, in Bezug auf das Zielobjekt angibt:

    Einstellung Beschreibung
    0 Hinein. Das Steuerelement wird in einen Zielbereich hineinbewegt.
    1 Hinaus. Das Steuerelement wird aus einem Zielbereich herausbewegt.
    2 Über. Das Steuerelement wurde innerhalb des Zielbereichs von einer Position zu einer anderen bewegt.

  • Mit Hilfe von nState können Sie Aktionen angeben, die an den Hauptübergangspunkten ausgeführt werden. Sie können z. B. ein mögliches Ziel hervorheben, wenn nState = 0 (Hinein) ist, und die Darstellung des Objekts wiederherstellen, wenn nState = 1 (Heraus) ist.

Wenn ein Objekt ein DragOver-Ereignis mit nState = 0 (Hinein) erkennt, gilt:

  • Ein DragDrop-Ereignis wird ausgelöst, wenn die Quellcodeverwaltung auf einem Zielobjekt abgelegt wird.
  • Ein weiteres DragOver-Ereignis mit nState = 1 (Heraus) wird ausgelöst, wenn die Quellcodeverwaltung nicht auf einem gültigen Zielobjekt abgelegt wird.

Hinweise

Das Objekt unter dem Drag-Symbol (dem Symbol, das beim Ziehen als Mauszeiger angezeigt wird) ist das Zielobjekt und reagiert auf das DragOver-Ereignis. Mit diesem Ereignis können Sie überwachen, wann der Mauszeiger in ein Zielobjekt hineinbewegt oder aus einem Zielobjekt herausbewegt wird und wann er sich über einem Zielobjekt befindet.

Mit Hilfe eines DragOver-Ereignisses können Sie festlegen, was geschieht, nachdem der Drag-Vorgang eingeleitet wurde und bevor ein Steuerelement auf einem Zielobjekt abgelegt wird. Sie können z. B. einen gültigen Zielbereich leichter erkennbar machen, indem Sie das Ziel mit Hilfe der BackColor- oder ForeColor-Eigenschaft hervorheben oder einen speziellen Mauszeiger anzeigen.

Siehe auch

Drag-Methode | DragDrop-Ereignis | DragIcon-Eigenschaft | DragMode-Eigenschaft | MouseDown-Ereignis | MouseUp-Ereignis | MouseMove-Ereignis

Betrifft: Kontrollkästchen-Steuerelement (Checkbox) | Kombinationsfeld-Steuerelement (ComboBox) | Befehlsschaltflächen-Steuerelement (CommandButton) | Schaltflächengruppe-Steuerelement (CommandGroup) | Control-Objekt | Bearbeitungsfeld-Steuerelement (EditBox) | Formularobjekt (Form) | Datenraster-Steuerelement (Grid) | Bild-Steuerelement (Image) | Bezeichnungs-Steuerelement (Label) | Linien-Steuerelement (Line) | Listenfeld-Steuerelement (ListBox) | Gebundenes OLE-Steuerelement | OLE-Container-Steuerelement | Optionsfeld-Steuerelement (OptionButton) | Optionsgruppen-Steuerelement (OptionGroup) | Seitenobjekt (Page) | Seitenrahmen-Steuerelement (PageFrame) | Form-Steuerelement (Shape) | Drehfeld-Steuerelement (Spinner) | Textfeld-Steuerelement (TextBox) | Symbolleisten-Objekt