[][src]Module wayland_raw_protocol_bindings::client::xdg_shell::xdg_positioner

child surface positioner

The xdg_positioner provides a collection of rules for the placement of a child surface relative to a parent surface. Rules can be defined to ensure the child surface remains within the visible area's borders, and to specify how the child surface changes its position, such as sliding along an axis, or flipping around a rectangle. These positioner-created rules are constrained by the requirement that a child surface must intersect with or be at least partially adjacent to its parent surface.

See the various requests for details about possible rules.

At the time of the request, the compositor makes a copy of the rules specified by the xdg_positioner. Thus, after the request is complete the xdg_positioner object can be destroyed or reused; further changes to the object will have no effect on previous usages.

For an xdg_positioner object to be considered complete, it must have a non-zero size set by set_size, and a non-zero anchor rectangle set by set_anchor_rect. Passing an incomplete xdg_positioner object when positioning a surface raises an error.

Structs

constraint_adjustment

constraint adjustments

Enums

anchor
error
gravity
xdg_positioner

Statics

xdg_positioner_interface

C representation of this interface, for interop

xdg_positioner_requests

C-representation of the messages of this interface, for interop

Traits

xdg_positioner_listener

An interface for handling events.

Functions

xdg_positioner_add_listener
xdg_positioner_add_rust_listener
xdg_positioner_destroy

destroy the xdg_positioner object

xdg_positioner_get_user_data
xdg_positioner_get_version
xdg_positioner_set_anchor

set anchor rectangle anchor

xdg_positioner_set_anchor_rect

set the anchor rectangle within the parent surface

xdg_positioner_set_constraint_adjustment

set the adjustment to be done when constrained

xdg_positioner_set_gravity

set child surface gravity

xdg_positioner_set_offset

set surface position offset

xdg_positioner_set_size

set the size of the to-be positioned rectangle

xdg_positioner_set_user_data