Struct AppLaunchContext 

pub struct AppLaunchContext { /* private fields */ }

GdkAppLaunchContext is an implementation of gio::AppLaunchContext that handles launching an application in a graphical context. It provides startup notification and allows to launch applications on a specific screen or workspace.

Launching an application

⚠️ The following code is in C ⚠️

GdkAppLaunchContext *context;

context = gdk_display_get_app_launch_context (display);

gdk_app_launch_context_set_screen (screen);
gdk_app_launch_context_set_timestamp (event->time);

if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &error))
  g_warning ("Launching failed: %s\n", error->message);

g_object_unref (context);

Properties

display

Readable | Writeable | Construct Only

Implements

gio::prelude::AppLaunchContextExt

Implementations

impl AppLaunchContext

pub fn set_desktop(&self, desktop: i32)

Sets the workspace on which applications will be launched when using this context when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints.

When the workspace is not specified or desktop is set to -1, it is up to the window manager to pick one, typically it will be the current workspace.

desktop

the number of a workspace, or -1

pub fn set_icon(&self, icon: Option<&impl IsA<Icon>>)

Sets the icon for applications that are launched with this context.

Window Managers can use this information when displaying startup notification.

See also set_icon_name().

icon

a gio::Icon, or None

pub fn set_icon_name(&self, icon_name: Option<&str>)

Sets the icon for applications that are launched with this context. The icon_name will be interpreted in the same way as the Icon field in desktop files. See also set_icon().

If both icon and icon_name are set, the icon_name takes priority. If neither icon or icon_name is set, the icon is taken from either the file that is passed to launched application or from the GAppInfo for the launched application itself.

icon_name

an icon name, or None

pub fn set_screen(&self, screen: &Screen)

Sets the screen on which applications will be launched when using this context. See also gdk_app_launch_context_set_display().

Note that, typically, a Screen represents a logical screen, not a physical monitor.

If both screen and display are set, the screen takes priority. If neither screen or display are set, the default screen and display are used.

screen

a Screen

pub fn set_timestamp(&self, timestamp: u32)

Sets the timestamp of self. The timestamp should ideally be taken from the event that triggered the launch.

Window managers can use this information to avoid moving the focus to the newly launched application when the user is busy typing in another window. This is also known as ‘focus stealing prevention’.

timestamp

a timestamp

pub fn display(&self) -> Option<Display>

Trait Implementations

impl Clone for AppLaunchContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppLaunchContext

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

Formats the value using the given formatter.

impl Display for AppLaunchContext

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

Formats the value using the given formatter.

impl Eq for AppLaunchContext

impl HasParamSpec for AppLaunchContext

type ParamSpec = ParamSpecObject

type SetValue = AppLaunchContext

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(&str) -> ParamSpecObjectBuilder<'_, AppLaunchContext>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for AppLaunchContext

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IsA<AppLaunchContext> for AppLaunchContext

impl Ord for AppLaunchContext

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for AppLaunchContext

type Parent = AppLaunchContext

impl<OT: ObjectType> PartialEq<OT> for AppLaunchContext

fn eq(&self, other: &OT) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<OT: ObjectType> PartialOrd<OT> for AppLaunchContext

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for AppLaunchContext

fn static_type() -> Type

Returns the type identifier of Self.