Iconos de puntero del mouse

Usando los cursores predeterminados del sistema

Los usuarios están familiarizados con diferentes convenciones para interactuar con diferentes tipos de objetos en dispositivos de pantalla grande. Android, sin necesidad de agregar ningún cambio, ofrece a los desarrolladores algunos de los iconos de cursor más comunes con los que los usuarios están familiarizados. Agregar algunos de estos iconos de cursor predeterminados del sistema es fácil. Echemos un vistazo al siguiente fragmento de Kotlin:

myView.setOnHoverListener { view, _ ->
      view.pointerIcon =
         PointerIcon.getSystemIcon(applicationContext, PointerIcon.TYPE_HAND)
      false // Listener did not consume the event.
}

myView es la vista que será asociada con cierto ícono de puntero bajo ciertas circumstancias. La condición utilizada para demostrar en este escenario es el estado al desplazarse sobre la vista (hover) . (En otros escenarios, puede ser recomendable tener un ícono de espera mientras la aplicación esté haciendo una tarea de procesamiento o un punto de mira en el caso de juegos). Aquí se utiliza setOnHoverListener para escuchar cuando el puntero se desliza sobre la vista y entonces actuar en ese evento. Dentro del método que escucha por el evento , se llama a view.pointerIcon para actualizar el ícono para esa vista en particular. Un ícono existente del sistema se utiliza para este caso. En Android existen varios íconos del sistema ya integrados y se puede encontrar una lista completa al final de esta página. En el ejemplo se uso el icono TYPE_HAND que muestra una mano cerrada con el dedo indice extendido.

Usando tu propio cursor especial

Es posible que los iconos del sistema Android no cubran todas sus necesidades. Por ejemplo, si tiene una aplicación de comercio de acciones, es posible que desee mostrar un “$” verde como puntero del mouse cuando los usuarios se ciernen sobre el botón de compra. Analicemos el siguiente fragmento de Kotlin:

// Loading a bitmap to use as a pointer icon
val dollarBitmap = Bitmap.createScaledBitmap(
    BitmapFactory.decodeResource(
        this.resources,
        R.drawable.dollar_sign
    ), CURSOR_WIDTH, CURSOR_HEIGHT, false
)

// Creating the pointer icon and sending clicks from the center of the mouse icon
PointerIcon.create(dollarBitmap, (CURSOR_WIDTH/2).toFloat(), (CURSOR_HEIGHT/2).toFloat())

Primero, cree un mapa de bits para el icono. Aquí se carga desde un recurso dibujable (drawable). Luego, cree el objeto PointerIcon usando el mapa de bits. Establezca el punto de acceso (ubicación en píxeles donde se originarán los clics) para que sea el centro del icono.

Ejemplos

Agregar iconos de puntero a su aplicación es una excelente manera de ayudar a que sus usuarios tengan experiencias más intuitivas en los diferentes factores de forma de dispositivo que usan. Hay muchos íconos de sistema predeterminados disponibles y si no se ajustan a sus necesidades, siempre puede cargar o crear los suyos propios.

• Arrastrar y soltar: si su aplicación admite arrastrar desde otra aplicación y soltar en su aplicación, podría implementar el ícono TYPE_NO_DROP . Esto daría una indicación visual de que su aplicación no es compatible con el tipo MIME que está tratando de caer en su aplicación.
• Mapas - Si su aplicación contiene mapas y le gustaría mostrar a sus usuarios que pueden desplazar el mapa puede utiizar el ícono TYPE_GRAB cuando el puntero del mouse se deslice sobre el mapa y cuando el usuario hace clic, actualizar el ícono a arrastrar para demostrar el efecto de desplazamiento del mapa.
• Edición de fotos - A los usuarios de edición de fotos les gusta tener controles que les permitan seleccionar una lupa para acercarla. Puede cambiar el cursor a una lupa con el ícono TYPE_ZOOM_IN cuando se selecciona el modo acercar.
• Y muchas más oportunidades

Apéndice

Cursores predeterminados del sistema

Estos son los cursores disponibles por defecto en el sistema Android.

Nombre del cursor	Icono
TYPE_ALIAS
TYPE_ALL_SCROLL
TIPO__ ARROW
TYPE_CELL
TYPE_CONTEXT_MENU
TYPE_COPY
TYPE_CROSSHAIR
TYPE_DEFAULT
TYPE_GRAB
TYPE_GRABBING
TYPE_HAND
TYPE_HELP
TYPE_HORIZONTAL_DOUBLE_ARROW
TYPE_NO_DROP
TYPE_NULL	No se mostrará ningún cursor
TYPE_TEXT
TYPE_TOP_LEFT_DIAGONAL_DOUBLE_ARROW
TYPE_TOP_RIGHT_DIAGONAL_DOUBLE_ARROW
TYPE_VERTICAL_DOUBLE_ARROW
TYPE_VERTICAL_TEXT
TYPE_WAIT
TYPE_ZOOM_IN
TYPE_ZOOM_OUT