MovieClip.hitTest()

Disponibilidad

Flash Player 5.

Sintaxis

my_mc.hitTest(x, y, shapeFlag)
my_mc.hitTest(target)

Parámetros

x Coordenada x del área activa del escenario.

y Coordenada y del área activa del escenario.

Las coordenadas x e y se definen en el espacio de coordenadas global.

target Ruta de destino del área activa que puede cruzarse o solaparse con la instancia especificada por my_mc. El parámetro target normalmente representa un botón o un campo de introducción de texto.

shapeFlag Valor booleano que especifica si se tiene en cuenta toda la forma de la instancia especificada (true) o solamente el recuadro de delimitación (false). Este parámetro sólo puede especificarse si el área activa se ha identificado con los parámetros de coordenadas x e y.

Valor devuelto

El valor booleano true si my_mc se solapa con el área activa especificada; de lo contrario, el valor false.

Descripción

Método; obtiene la instancia especificada por my_mc para ver si se solapa o cruza con el área activa identificada por el parámetro destino o los parámetros de coordenadas x e y.

Sintaxis 1: compara las coordenadas x e y con la forma o el recuadro de delimitación de la instancia especificada, según el valor de shapeFlag. Si shapeFlag está establecido en true, sólo se tiene en cuenta el área que ocupa actualmente la instancia en el escenario; si x e y se solapan en algún punto, se devuelve el valor true. Esto es muy útil para determinar si el clip de película se encuentra dentro del área activa especificada.

Sintaxis 2: obtiene los recuadros de delimitación de target y de la instancia especificada y devuelve el valor true si se solapan o se cruzan en algún momento.

Ejemplo

En el ejemplo siguiente se utiliza hitTest() con las propiedades _xmouse e _ymouse para determinar si el puntero del ratón se encuentra sobre el recuadro de delimitación del destino:

if (hitTest( _root._xmouse, _root._ymouse, false));

En el ejemplo siguiente se utiliza hitTest() para determinar si un clip de película ball se solapa o se cruza con el clip de película square:

if(_root.ball.hitTest(_root.square)){
  trace("ball intersects square");
}

Véase también

MovieClip.getBounds(), MovieClip.globalToLocal(), MovieClip.localToGlobal()