UIElement.PointerReleased Evento

Definición

Espacio de nombres:
Microsoft.UI.Xaml
Editar

Se produce cuando se libera el dispositivo de puntero que inició previamente una acción Presionar , mientras que dentro de este elemento. Tenga en cuenta que no se garantiza que el final de una acción Press active un PointerReleased evento; otros eventos pueden activarse en su lugar. Para obtener más información, consulta Comentarios.

public:
 virtual event PointerEventHandler ^ PointerReleased;
// Register
event_token PointerReleased(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerReleased(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerReleased;
function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;
Public Custom Event PointerReleased As PointerEventHandler 
<uiElement PointerReleased="eventhandler"/>

Tipo de evento

PointerEventHandler

Comentarios

Las interacciones táctiles, del mouse y del lápiz y del lápiz se reciben, procesan y administran como entrada de puntero en una aplicación. Cualquiera de estas interacciones puede producir un PointerReleased evento. Para obtener más información, consulta Handle pointer input (Controlar entrada de puntero).

Otros eventos en lugar de PointerReleased pueden activarse al final de la acción( por ejemplo, PointerCanceled o PointerCaptureLost. No confíes en PointerPressed y PointerReleased los eventos siempre se producen en pares. Para funcionar correctamente, la aplicación debe escuchar y controlar todos los eventos que representan las conclusiones probables de la acción Presionar . Algunas de las razones por las que es posible que no obtenga una PointerReleased aparición son:

  • Diferencias en la forma en que el hardware específico controla las acciones táctiles y las acciones de prensa
  • Captura de puntero mediante programación desde un puntero diferente
  • Acciones del usuario que cambian la relación del área de visualización, como cambiar la resolución o la configuración del monitor
  • Interacciones de entrada como un lápiz óptico que toca la misma superficie que una acción táctil anterior

La acción del usuario que desencadena un PointerReleased evento inicialmente puede dar lugar al Tapped evento o también puede dar lugar a RightTapped condiciones que varían por dispositivo. Para obtener más información, consulta Tapped y RightTapped.

La entrada del mouse está asociada a un único puntero asignado cuando se detecta por primera vez la entrada del mouse. Al hacer clic en un botón del mouse (izquierda, rueda o derecha), se crea una asociación secundaria entre el puntero y ese botón a través del evento PointerPressed . El PointerReleased evento solo se desencadena cuando se suelta el mismo botón del mouse (no se puede asociar ningún otro botón al puntero hasta que se complete este evento). Debido a esta asociación exclusiva, otros clics de botón del mouse se enrutan a través del evento PointerMoved . Puede probar el estado del botón del mouse al controlar este evento, como se muestra en el ejemplo siguiente.

PointerReleased es un evento enrutado. Para obtener más información sobre el concepto de evento enrutado, consulta Información general sobre eventos y eventos enrutados.

Para las acciones táctiles y también para los eventos específicos de interacción o manipulación que son consecuencias de una acción táctil, un elemento debe ser visible para las pruebas de contacto para poder ser la fuente del evento y activar el evento asociado a la acción. UIElement.Visibility debe ser Visible. Otras propiedades de tipos derivados también afectan a la visibilidad de las pruebas de posicionamiento. Para obtener más información, consulta Vista general de eventos y eventos enrutados.

PointerReleased admite la capacidad de adjuntar controladores de eventos a la ruta que se invocará incluso si los datos del evento se marcan como Handled. Consulte AddHandler.

Es posible que los controles de Windows Runtime específicos tengan control basado en clases para el PointerReleased evento de entrada. Si es así, es probable que el control tenga una invalidación para el método OnPointerReleased. Normalmente, el controlador de clases marca el evento y PointerReleased no se genera el evento para controlarlo ningún controlador de código de usuario en ese control. Para obtener más información sobre cómo funciona el control basado en clases para eventos, consulta Información general sobre eventos y eventos enrutados.

Los controles también pueden tener una animación de personalidad PointerUpThemeAnimation que se ejecute independientemente del evento.

Se aplica a

Consulte también