PointerEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Contiene los argumentos devueltos por el último evento de puntero.
public ref class PointerEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class PointerEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class PointerEventArgs
Public NotInheritable Class PointerEventArgs
- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Ejemplos
void SetWindow(CoreWindow const & window)
{
window.PointerCursor(Windows::UI::Core::CoreCursor{ CoreCursorType::Arrow, 0 });
window.PointerPressed({ this, &App::OnPointerPressed });
window.PointerReleased({ this, &App::OnPointerReleased });
window.PointerMoved({ this, &App::OnPointerMoved });
}
// Pointer event data in PointerEventArgs.
void OnPointerPressed(Windows::UI::Core::CoreWindow const& /* sender */,
Windows::UI::Core::PointerEventArgs const& /* args */) {}
void OnPointerReleased(Windows::UI::Core::CoreWindow const& /* sender */,
Windows::UI::Core::PointerEventArgs const& /* args */) {}
void OnPointerMoved(Windows::UI::Core::CoreWindow const& /* sender */,
Windows::UI::Core::PointerEventArgs const& /* args */) {}
// returning pointer events data through PointerEventArgs
void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication::Run(), provided for context
_In_ CoreWindow^ window
)
{
window->PointerCursor = ref new CoreCursor(CoreCursorType::Arrow, 0);
// ...
window->PointerPressed +=
ref new TypedEventHandler<CoreWindow^, PointerEventArgs^>(this, &CoreWindowEvents::OnPointerPressed);
window->PointerReleased +=
ref new TypedEventHandler<CoreWindow^, PointerEventArgs^>(this, &CoreWindowEvents::OnPointerReleased);
window->PointerMoved +=
ref new TypedEventHandler<CoreWindow^, PointerEventArgs^>(this, &CoreWindowEvents::OnPointerMoved);
// ...
}
Comentarios
Un delegado registrado para uno de los siguientes eventos devuelve este objeto:
- CoreWindow.PointerCaptureLost
- CoreWindow.PointerEntered
- CoreWindow.PointerExited
- CoreWindow.PointerMoved
- CoreWindow.PointerPressed
- CoreWindow.PointerReleased
- CoreWindow.PointerWheelChanged
Nota:
Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulta Subprocesos y serialización (C++/CX).
Propiedades
CurrentPoint |
Obtiene los datos de puntero del último evento de puntero. |
Handled |
Obtiene o establece si se controló el evento de puntero. |
KeyModifiers |
Obtiene la tecla o teclas de teclado usadas para modificar la entrada del puntero, como la tecla "Ctrl" cuando se presiona junto con otra tecla, como en Ctrl+C. |
Métodos
GetIntermediatePoints() |
Recupera los datos de puntero de hasta las últimas 64 ubicaciones de puntero desde el último evento de puntero. |