Struct PresentationSource 

pub struct PresentationSource { /* private fields */ }

Connects the root visual of a top-level to its platform implementation, renderer, layout manager and input.

Implementations

impl PresentationSource

pub fn new( root_visual: Ref<InputElement>, default_focus_visual: &Ref<InputElement>, platform_impl: Rc<dyn ITopLevelImpl>, dependency_resolver: &dyn IFerroDependencyResolver, ) -> Rc<PresentationSource>

Creates the presentation source of a top-level.

root_visual becomes the root of the visual tree, default_focus_visual receives keyboard input when nothing is focused, platform_impl is the platform implementation of the top-level and the services of the source are taken from dependency_resolver.

pub fn platform_impl(&self) -> Option<Rc<dyn ITopLevelImpl>>

The platform implementation of the top-level; None once the source has been disposed.

pub fn focus_manager(&self) -> &Rc<FocusManager>

The focus manager of the tree.

pub fn root_visual(&self) -> Option<Ref<InputElement>>

The root of the visual tree; None after the top-level has closed.

pub fn set_root_visual(&self, value: Option<Ref<InputElement>>)

Sets the root of the visual tree: the old root is detached from the source and the new one attached to it.

pub fn root_element(&self) -> Ref<InputElement>

The root input element; the root visual.

Panics

Panics after the top-level has closed.

pub fn from_root_visual(root_visual: &Visual) -> Option<Rc<PresentationSource>>

The presentation source whose root visual is root_visual, if the visual is the root of one (upstream casts the source of the root visual to this class).

pub fn platform_settings(&self) -> Option<Rc<dyn IPlatformSettings>>

The platform settings of the application.

pub fn dispose(&self)

Detaches the source from its platform implementation and releases the renderer, the layout manager and the input subscriptions.

pub fn get_last_pointer_position( &self, _top_level: &Visual, ) -> Option<PixelPoint>

The last known position of the pointer, in screen coordinates.

impl PresentationSource

pub fn set_cursor_override(&self, cursor: Option<Rc<Cursor>>)

This should only be used by the in-process drag source.

impl PresentationSource

pub fn input_root(&self) -> Rc<dyn IInputRoot>

The source as the input root of its tree.

pub fn focus_root(&self) -> Ref<InputElement>

The element keyboard input is sent to when nothing is focused.

Panics

Panics when the element has been dropped.

impl PresentationSource

pub fn layout_scaling(&self) -> f64

The scaling factor to use in layout.

pub fn layout_manager(&self) -> &Rc<LayoutManager>

The layout manager of the tree.

impl PresentationSource

pub fn typed_renderer(&self) -> &Rc<dyn ITopLevelRenderer>

The renderer of the tree.

pub fn hit_tester(&self) -> Rc<dyn IHitTester>

The hit tester of the tree: the override when one is set, otherwise the hit tester of the renderer, otherwise one that walks the visual tree.

pub fn hit_tester_override(&self) -> Option<Rc<dyn IHitTester>>

The hit tester used instead of the renderer’s, for unit tests that do not set up a hit-testable visual tree.

pub fn set_hit_tester_override(&self, value: Option<Rc<dyn IHitTester>>)

pub fn render_scaling(&self) -> f64

The scaling factor to use in rendering.

pub fn client_size(&self) -> Size

The size of the client area of the platform implementation.

pub fn point_to_screen(&self, point: Point) -> Option<PixelPoint>

Converts a point from client to screen coordinates.

pub fn point_to_client(&self, point: PixelPoint) -> Option<Point>

Converts a point from screen to client coordinates.

Trait Implementations

impl IInputRoot for PresentationSource

fn hit_test_chrome_element( &self, point: Point, ) -> Option<WindowDecorationsElementRole>

Performs a hit-test for chrome/decoration elements at the given position, in root-relative coordinates.

fn focus_manager(&self) -> Option<Rc<FocusManager>>

The focus manager of the root.

fn pointer_over_element(&self) -> Option<Ref<InputElement>>

The input element that the pointer is currently over.

fn set_pointer_over_element(&self, value: Option<Ref<InputElement>>)

Sets the input element that the pointer is currently over.

fn cursor_element(&self) -> Option<Ref<InputElement>>

The element whose cursor is shown.

fn set_cursor_element(&self, value: Option<Ref<InputElement>>)

Sets the element whose cursor is shown.

fn input_method(&self) -> Option<Rc<dyn ITextInputMethodImpl>>

The input method of the platform for this root, if it has one.

fn root_element(&self) -> Ref<InputElement>

The root input element.

fn try_root_element(&self) -> Option<Ref<InputElement>>

Deviation (DEVIATIONS.md, Input): the optional form of root_element.

fn focus_root(&self) -> Ref<InputElement>

The element keyboard input is sent to when nothing is focused.

fn pointer_over_invalidated(&self)

Called when what is under the pointer may have changed without the pointer moving, e.g. when the capture of a pointer changes.

impl ILayoutRoot for PresentationSource

fn layout_scaling(&self) -> f64

The scaling factor to use in layout.

fn layout_manager(&self) -> Rc<dyn ILayoutManager>

The layout manager that lays out the tree.

fn root_visual(&self) -> Ref<Layoutable>

The root layoutable.

impl IPresentationSource for PresentationSource

fn root_visual(&self) -> Option<Ref<Visual>>

The root visual of the tree.

fn render_scaling(&self) -> f64

The scaling factor to use in rendering.

fn renderer(&self) -> Rc<dyn IRenderer>

The renderer of the tree.

fn layout_root(&self) -> Rc<dyn ILayoutRoot>

The layout root of the tree.

fn client_size(&self) -> Size

The size of the client area, in device-independent pixels.

fn platform_settings(&self) -> Option<Rc<dyn IPlatformSettings>>

The platform settings of the host, if it has any.

fn hit_tester(&self) -> Rc<dyn IHitTester>

The hit tester of the tree.

fn input_root(&self) -> Rc<dyn IInputRoot>

The input root of the tree.

fn point_to_screen(&self, point: Point) -> Option<PixelPoint>

Converts a point from client to screen coordinates, if the host is on a screen.

fn point_to_client(&self, point: PixelPoint) -> Option<Point>

Converts a point from screen to client coordinates, if the host is on a screen.