Struct zng_ext_input::pointer_capture::POINTER_CAPTURE

pub struct POINTER_CAPTURE;

Mouse and touch capture service.

Mouse and touch is captured when mouse and touch events are redirected to a specific target. The user can still move the cursor or touch contact outside of the target but the widgets outside do not react to this.

You can request capture by calling capture_widget or capture_subtree with a widget that was pressed by a mouse button or by touch. The capture will last for as long as any of the mouse buttons or touch contacts are pressed, the widget is visible and the window is focused.

Windows capture by default, this cannot be disabled. For other widgets this is optional.

Provider

This service is provided by the PointerCaptureManager extension.

Implementations

impl POINTER_CAPTURE

pub fn current_capture(&self) -> ReadOnlyArcVar<Option<CaptureInfo>>

Variable that gets the current capture target and mode.

pub fn capture_widget(&self, widget_id: WidgetId)

Set a widget to redirect all mouse and touch events to.

The capture will be set only if the widget is pressed.

pub fn capture_subtree(&self, widget_id: WidgetId)

Set a widget to be the root of a capture subtree.

Mouse and touch events targeting inside the subtree go to target normally. Mouse and touch events outside the capture root are redirected to the capture root.

The capture will be set only if the widget is pressed.

pub fn release_capture(&self)

Release the current mouse and touch capture back to window.

Note: The capture is released automatically when the mouse buttons or touch are released or when the window loses focus.