SessionClient

---

Object Hierarchy:

Description:

Content:

Properties:

• public int auto_reconnect_interval { get; set; }
• public string client_id { get; construct; }
• public string[] clone_command { get; set; }
• public string current_directory { get; set; }
• public string desktop_file { owned get; set; }
• public uint8 priority { get; set construct; }
• public string[] restart_command { get; set; }
• public SessionClientRestartStyle restart_style { get; set construct; }
• public bool resumed { get; }

Static methods:

• public static unowned SessionClient? @get ()
  Returns the singleton instance of SessionClient, if one has been created.
• public static SessionClient @new ()
  Creates the application's SM client instance.
• public static Quark error_quark ()
  Gets the XfceSessionClient Error Quark.
• public static OptionGroup get_option_group (int argc, string argv)
  Constructs a OptionGroup suitable for use with Glib's command-line option parser.
• public static SessionClient new_full (SessionClientRestartStyle restart_style, uint8 priority, string resumed_client_id, string current_directory, string restart_command, string desktop_file)
  Creates a new SM client instance, allowing the application fine-grained control over the initial properties set.
• public static SessionClient new_with_argv (int argc, string argv, SessionClientRestartStyle restart_style, uint8 priority)
  Creates a new SessionClient instance.

Creation methods:

• protected SessionClient ()

Methods:

• public void add_window (Window window, string name)
  Asks the session manager to keep track of window so its WM state can be restored later.
• public bool connect () throws Error
  Attempts to connect to the session manager.
• public void discard ()
  Asks the session manager to discard all stored data about this session, and then disconnects the application from the session manager.
• public void disconnect ()
  Disconnects the application from the session manager.
• public unowned string get_client_id ()
  Retrieves the session client's unique ID.
• public unowned string[] get_clone_command ()
  Retrieves the session client's clone command.
• public unowned string get_current_directory ()
  Retrieves the session client's working directory.
• public uint8 get_priority ()
  Retrieves the session client's restart priority.
• public unowned string[] get_restart_command ()
  Retrieves the session client's restart command.
• public SessionClientRestartStyle get_restart_style ()
  Retrieves the session client's restart style.
• public unowned string get_state_file ()
  Constructs a filename that can be used to restore or save state information.
• public bool is_connected ()
  Determines whether or not the application has connected to the session manager.
• public bool is_resumed ()
  Determines whether the application was resumed from a previous session, or if the application has been started fresh with no state information associated with it.
• public void remove_window (string name)
  Asks the session manager to forget all state about the window identified by name.
• public void rename_window (Window window, string new_name)
  Asks the session manager to rename window's stored state name to new_name.
• public void request_shutdown (SessionClientShutdownHint shutdown_hint)
  Sends a request to the session manager to end the session.
• public void restore_window (Window window, string name)
  Asks the session manager to restore WM state for name and associate it with window.
• public void set_auto_reconnect_interval (int auto_reconnect_interval_ms)
  Sets the non-zero interval at which this will automatically attempt to reconnect to the session manager if the connection is lost.
• public void set_client_id (string? client_id)
  Resets this's client ID to client_id, or clears it if null is passed.
• public void set_clone_command (string clone_command)
  Sets the application's "clone" command, which is used to start a fresh instance of the application without restoring any state.
• public void set_current_directory (string current_directory)
  Sets the startup working directory of this to current_directory.
• public void set_desktop_file (string desktop_file)
  Sets the application's .
• public void set_priority (uint8 priority)
  Sets the startup priority for this to priority.
• public void set_restart_command (string restart_command)
  Sets the application's "restart" command, which is used to restart the application and restore any saved state from the previous run.
• public void set_restart_style (SessionClientRestartStyle restart_style)
  Sets the restart style hint to restart_style.

Signals:

• public signal void quit ()
  Emitted when the application is required to quit.
• public signal void quit_cancelled ()
  Informs the application that it will not need to quit.
• public signal bool quit_requested ()
  Signals the client that the session manager will soon want the application to quit, perhaps as a part of ending the session (but this should not be assumed).
• public signal bool replaced ()
  Informs the application that another instance of the app has taken over the session ID.
• public signal void save_state ()
  Signals the client that it should save a copy of its current state such that it could be restarted later in exactly the same state as it is at the time of signal emission.
• public signal void save_state_extended ()
  Allows the application to save extra state information after all other applications in the session have had a chance to save their state.

Inherited Members: