Freigeben über

AMOUSEOBJ( )-Funktion

  • Artikel

Erstellt ein Array, das Informationen über die Mauszeigerposition und das Objekt, über dem sich der Mauszeiger befindet, zurückgibt.

AMOUSEOBJ(ArrayName [, 1])

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt den Namen des Arrays an, das die Informationen über den Mauszeiger enthält. Ist das angegebene Array nicht vorhanden, wird es von Visual FoxPro automatisch erstellt. Ist das Array vorhanden, aber nicht groß genug, um alle Zeilen aus dem Memofeld aufzunehmen, vergrößert Visual FoxPro das Array automatisch. Ist das Array größer als notwendig, wird es abgeschnitten.

    Das erstellte Array enthält vier Zeilen. Die folgende Tabelle beschreibt den Inhalt einer jeden Zeile im Array:

    Arrayzeile Beschreibung
    1 Enthält einen Objektverweis auf das Objekt, über dem sich der Mauszeiger befindet, wenn AMOUSEOBJ( ) ausgeführt wird.
    2 Enthält einen Objektverweis auf den Container des Objekts, über dem sich der Mauszeiger befindet, wenn AMOUSEOBJ( ) ausgeführt wird.
    3 Enthält die horizontale (X) Koordinate des Mauszeigers in Pixel, relativ zum Container des Objekts, über dem sich der Mauszeiger befindet, wenn AMOUSEOBJ( ) ausgeführt wird.
    4 Enthält die vertikale (Y) Koordinate des Mauszeigers in Pixel, relativ zum Container des Objekts, über dem sich der Mauszeiger befindet, wenn AMOUSEOBJ( ) ausgeführt wird.

Beachten Sie, dass die erste und die zweite Zeile des Arrays dieselben Werte enthalten, wenn der Mauszeiger über einem generischen Container wie z. B. einem Seitenrahmen positioniert ist.

  • [, 1]
    Dieser optionale Parameter gibt an, dass die im Array enthaltenen Mauszeigerinformationen relativ zum aktuellen Formular (THISFORM) sind. Wenn diese Option einbezogen ist, enthält die zweite Arrayzeile einen Objektverweis auf das aktuelle Formular, und die dritte und vierte Zeile enthalten die Mauszeigerkoordinaten relativ zum aktuellen Formular.

Hinweise

Mit AMOUSEOBJ( ) lässt sich auch bestimmen, wo sich der Mauszeiger zur Entwurfszeit befinden soll. Die folgende Tabelle gibt die Elemente zur Entwurfszeit und die in den jeweiligen Arrayzeilen enthaltenen Werte an:

Entwurfszeitelement Inhalt des Arrays
Formular- und Klassendesigner Zeile 1 – Objektverweis auf das Steuerelement. Zeile 2 – Objektverweis auf das Formular. Zeile 3 – Mauszeiger der horizontalen (X) Koordinate in Bezug auf das Formular. Zeile 4 – Mauszeiger der vertikalen (Y) Koordinate in Bezug auf das Formular.
Projekt-Manager Zeile 1 – Objektverweis auf das Projekt. Zeile 2 – Objektverweis auf das Projekt. Zeile 3 – Null. Zeile 4 – Null.
Visual FoxPro-Desktop Zeile 1 – Objektverweis auf den Desktop. Zeile 2 – Objektverweis auf den Desktop. Zeile 3 – Mauszeiger der horizontalen (X) Koordinate in Bezug auf den Desktop. Zeile 4 – Mauszeiger der vertikalen (Y) Koordinate in Bezug auf den Desktop.

AMOUSEOBJ( ) gibt 4 (die Anzahl der Arrayzeilen) zurück, wenn sich der Mauszeiger über einem der oben angegebenen Bereiche befindet. Befindet sich der Mauszeiger über einem anderen als den oben angegebenen Bereichen, gibt AMOUSEOBJ( ) Null zurück, und falls das von Ihnen angegebene Array bereits vorhanden ist, so bleibt es unverändert. Wenn das von Ihnen angegebene Array nicht vorhanden ist, wird es nicht erstellt.

Siehe auch

MCOL( ) | MROW( ) | SYS(1270) - Objektposition | ASELOBJ( )-Funktion