class: AppLaunchContext

[20:7] extends: object

Handles launching an application in a graphical context. It is an implementation of GAppLaunchContext that provides startup notification and allows to launch applications on a specific workspace. ## Launching an application c GdkAppLaunchContext *context; context = gdk_display_get_app_launch_context (display); gdk_app_launch_context_set_timestamp (gdk_event_get_time (event)); 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);

Members

• handleObj
• lib
• retainedCallbacks
• signalHandlerNames
• signalSetterHandlers

Methods

• AppLaunchContext (Handle = null)

  Creates a new AppLaunchContext by wrapping a native handle or another wrapper.

  • @p Handle is the native handle or another wrapper whose handle to adopt.

• toNativeHandle (Source)

  Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.

  • @p Source is the raw handle, raw buffer, wrapper, or null.
  • @r A raw pointer carrier or null when no pointer is present.

• getLib ()

  Returns the opened native library for this generated wrapper.

  • @r The opened native library.

• handle ()

  Returns the wrapped NativeHandle.

  • @r The wrapped NativeHandle.

• isNull ()

  Returns true when the wrapped handle is null.

  • @r A bool.

• describe ()

  Returns a small string for debugging generated wrappers.

  • @r A string.

• asAppLaunchContext ()

  Wraps this handle as AppLaunchContext.

  • @r A AppLaunchContext object.

• get_display ()

  Gets the GdkDisplay that @context is for.

• set_desktop (int desktop)

  Sets the workspace on which applications will be launched. This only works when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints. Specifically this sets the _NET_WM_DESKTOP property described in that spec. This only works when using the X11 backend. 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.

  • @p desktop is the number of a workspace, or -1.
  • @r None.

• set_icon (object icon)

  Sets the icon for applications that are launched with this context. Window Managers can use this information when displaying startup notification. See also [method@Gdk.AppLaunchContext.set_icon_name].

  • @p icon is a GIcon.
  • @r None.

• set_icon_name (string icon_name)

  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 [method@Gdk.AppLaunchContext.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.
  • @p icon_name is an icon name.
  • @r None.

class: AppLaunchContextMeta

[168:14] static extends: object

Generated metadata helpers for AppLaunchContext class surfaces.

Methods

• properties ()

  Returns property metadata for AppLaunchContext.

  • @r A list.