Struct ashpd::WindowIdentifier

pub struct WindowIdentifier(_);

Most portals interact with the user by showing dialogs. These dialogs should generally be placed on top of the application window that triggered them. To arrange this, the compositor needs to know about the application window. Many portal requests expect a WindowIdentifier for this reason.

Under X11, the WindowIdentifier should have the form "x11:XID", where XID is the XID of the application window. Under Wayland, it should have the form "wayland:HANDLE", where HANDLE is a surface handle obtained with the xdg_foreign protocol.

For other windowing systems, or if you don't have a suitable handle, just use the Default implementation.

Normally, we should provide a From<gtk::Window> for WindowIdentifier implementation. But as that's currently impossible to do from Rust in a sane way, we should try to provide a C function that gives us a handle from the Gdk::Window and call it from Rust in the From implementation.

We would love merge requests that adds other From<T> for WindowIdentifier implementations for other toolkits.

Implementations

impl WindowIdentifier

pub fn new(identifier: &str) -> Self

Create a new window identifier

Trait Implementations

impl Clone for WindowIdentifier

fn clone(&self) -> WindowIdentifier

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WindowIdentifier

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WindowIdentifier

fn default() -> Self

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for WindowIdentifier

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for WindowIdentifier

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Type for WindowIdentifier

fn signature() -> Signature<'static>

Get the signature for the implementing type.