Compartir a través de

AMOUSEOBJ( ) (Función)

  • Artículo

Crea una matriz que contiene información acerca de la posición del puntero del mouse (ratón) y el objeto sobre el que está colocado el puntero.

AMOUSEOBJ(ArrayName [, 1])

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz que contiene la información del puntero del mouse. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si la matriz existe y no es suficientemente grande para contener todas las líneas del campo memo, Visual FoxPro aumenta automáticamente el tamaño de la matriz. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño.

    La matriz que se crea contiene cuatro filas. La siguiente tabla muestra el contenido de cada fila de la matriz:

    Fila de
    la matriz    		 Descripción
    1 Contiene una referencia al objeto sobre el que está colocado el puntero del mouse cuando se ejecuta AMOUSEOBJ( ).
    2 Contiene una referencia de objeto al contenedor del objeto sobre el que está colocado el puntero del mouse cuando se ejecuta AMOUSEOBJ( ).
    3 Contiene la coordenada horizontal (X) en píxeles del puntero del mouse, relativa al contenedor del objeto sobre el que está colocado el puntero del mouse cuando se ejecuta AMOUSEOBJ( ).
    4 Contiene la coordenada vertical (Y) en píxeles del puntero del mouse, relativa al contenedor del objeto sobre el que está colocado el puntero del mouse cuando se ejecuta AMOUSEOBJ( ).

Observe que la primera y segunda filas de la matriz pueden contener los mismos valores si el mouse está colocado sobre un contenedor genérico, por ejemplo, un marco de página.

  • [, 1]
    Este parámetro opcional especifica que la información del puntero del mouse contenida en la matriz hace referencia al formulario actual (THISFORM). Si se incluye esta opción, la segunda fila de la matriz siempre contiene una referencia de objeto al formulario actual, y la tercera y cuarta filas contienen las coordenadas del puntero del mouse relativas al formulario actual.

Observaciones

También puede utilizar AMOUSEOBJ( ) para determinar dónde está colocado el puntero del mouse en tiempo de diseño. La siguiente tabla muestra el elemento en tiempo de diseño y los valores contenidos en cada fila de la matriz:

Elemento en tiempo
de diseño		 Contenido de la matriz
Diseñadores de formularios y clases Fila 1 – Referencia de objeto al control.Fila 2 – Referencia de objeto al formulario.Fila 3 – Coordenada horizontal (X) del puntero del mouse relativa al formulario.Fila 4 – Coordenada vertical (Y) del puntero del mouse relativa al formulario.
Administrador de proyectos Fila 1 – Referencia de objeto al proyecto.Fila 2 – Referencia de objeto al proyecto.Fila 3 – Cero.Fila 4 – Cero.
Escritorio de Visual FoxPro Fila 1 – Referencia de objeto al escritorio.Fila 2 – Referencia de objeto al escritorio.Fila 3 – Coordenada horizontal (X) del puntero del mouse relativa al escritorio.Fila 4 – Coordenada vertical (Y) del puntero del mouse relativa al escritorio.

AMOUSEOBJ( ) devuelve 4 (el número de filas de la matriz) si el puntero del mouse está colocado sobre una de las áreas mencionadas arriba. Si el puntero del mouse está colocado sobre un área que no figure arriba, AMOUSEOBJ( ) devuelve cero y si la matriz que especifica ya existe, permanece sin cambios. Si la matriz que especifica no existe, no se crea.

Vea también

MCOL( ) | MROW( ) | SYS(1270) - Ubicación de objetos | ASELOBJ( ) (Función)