org.gnu.gnome
Class Client

java.lang.Object
  extended by org.gnu.glib.Struct
      extended by org.gnu.glib.GObject
          extended by org.gnu.gnome.Client

Deprecated. This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may have an equivalent in java-gnome 4.0; have a look for org.gnome.gnome.Client.

public class Client
extends org.gnu.glib.GObject

The GnomeClient object makes it possible for your application to save session information when the user logs out. If, when logging out, the user chooses to save the current settings, a save_yourself signal is sent to each application. Then an application can save information in such a way that it is supported on the command line whenever the program automatically restarts a user login.


Constructor Summary
Client()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 
Method Summary
 void addListener(ClientListener listener)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void connect()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void disconnect()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void flush()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 java.lang.String getConfigPrefix()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 java.lang.String getDesktopID()
          Deprecated.  
 java.lang.Class getEventListenerClass(java.lang.String signal)
          Deprecated.  
 org.gnu.glib.EventType getEventType(java.lang.String signal)
          Deprecated.  
 ClientFlags getFlags()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 java.lang.String getGlobalConfigPrefix()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 java.lang.String getID()
          Deprecated.  
 java.lang.String getPreviousID()
          Deprecated.  
static org.gnu.glib.Type getType()
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void removeListener(ClientListener listener)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void requestPhase2()
          Deprecated.  
 void requestSave(SaveStyle saveStyle, boolean shutdown, InteractStyle interactStyle, boolean fast, boolean global)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void saveAnyDialog(org.gnu.gtk.Dialog dialog)
          Deprecated.  
 void saveErrorDialog(org.gnu.gtk.Dialog dialog)
          Deprecated.  
 void setCloneCommand(java.lang.String[] args)
          Deprecated.  
 void setCurrentDirectory(java.lang.String dir)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void setDiscardCommand(java.lang.String[] args)
          Deprecated.  
 void setEnvironment(java.lang.String name, java.lang.String value)
          Deprecated.  
 void setGlobalConfigPrefix(java.lang.String prefix)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void setID(java.lang.String id)
          Deprecated.  
 void setPriority(int priority)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void setProcessID(int id)
          Deprecated.  
 void setProgram(java.lang.String program)
          Deprecated.  
 void setResignCommand(java.lang.String[] args)
          Deprecated.  
 void setRestartCommand(java.lang.String[] args)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void setRestartStyle(RestartStyle style)
          Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.
 void setShutdownCommand(java.lang.String[] args)
          Deprecated.  
 void setUserID(java.lang.String id)
          Deprecated.  
 
Methods inherited from class org.gnu.glib.GObject
addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, collect, freezeNotify, getBooleanProperty, getData, getDoubleProperty, getFloatProperty, getGObjectFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getProperty, getStringProperty, hasProperty, notify, removeEventHandler, removeListener, setBooleanProperty, setData, setDoubleProperty, setFloatProperty, setIntProperty, setJavaObjectProperty, setLongProperty, setProperty, setStringProperty, thawNotify
 
Methods inherited from class org.gnu.glib.Struct
equals, getHandle, getNullHandle, hashCode
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Client

public Client()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Create a new session management client and try to connect to a session manager.

Method Detail

getConfigPrefix

public java.lang.String getConfigPrefix()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Get the config prefix for a client. The config prefix provides a suitable place to store any details about the state of the client which can not be described using the app's command line arguments (as set in the restart command).


getGlobalConfigPrefix

public java.lang.String getGlobalConfigPrefix()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Get the config prefix for clients which have NOT been restarted or cloned. This config prefix may be used to write the user's preferred config for these "new" clients.

You may also use this prefix as a place to store and retrieve config details that you wish to apply to ALL instances of the app. However, this practice limits user's freedom to configure each instance in a different way so it should be used with caution.


setGlobalConfigPrefix

public void setGlobalConfigPrefix(java.lang.String prefix)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Set the value used for the global config prefix. The config prefixes returned by getGlobalConfigPrefix() are formed by extending this prefix with a unique identifier.

The global config prefix defaults to a name based on the name of the executable. This function allows you to set it to a different value. It should be called BEFORE retrieving the config prefix for the first time.


getFlags

public ClientFlags getFlags()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Returns some flags, that give additional information about this client.


setRestartStyle

public void setRestartStyle(RestartStyle style)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

The session manager usually only restarts clients which are running when the session was last saved. You can set the restart style to make the manager restart the client: - at the start of every session (RESTART_AWAY) - whenever the client dies (RESTART_IMMEDIATELY) - never (RESTART_NEVER)


setPriority

public void setPriority(int priority)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

The gnome-session manager includes an extension to the protocol which allows the order in which clients are started up to be organized into a number of run levels. This method may be used to inform the gnome-session manager of where this client should appear in this run level ordering. The priority runs from 0 (started first) to 99 (started last) and defaults to 50.


setCurrentDirectory

public void setCurrentDirectory(java.lang.String dir)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Sets the directory where all commands are executed.


setRestartCommand

public void setRestartCommand(java.lang.String[] args)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Provide the command that should be used to restart this application.


setDiscardCommand

public void setDiscardCommand(java.lang.String[] args)
Deprecated. 

setResignCommand

public void setResignCommand(java.lang.String[] args)
Deprecated. 

setShutdownCommand

public void setShutdownCommand(java.lang.String[] args)
Deprecated. 

setEnvironment

public void setEnvironment(java.lang.String name,
                           java.lang.String value)
Deprecated. 

setCloneCommand

public void setCloneCommand(java.lang.String[] args)
Deprecated. 

setProcessID

public void setProcessID(int id)
Deprecated. 

setProgram

public void setProgram(java.lang.String program)
Deprecated. 

setUserID

public void setUserID(java.lang.String id)
Deprecated. 

saveAnyDialog

public void saveAnyDialog(org.gnu.gtk.Dialog dialog)
Deprecated. 

saveErrorDialog

public void saveErrorDialog(org.gnu.gtk.Dialog dialog)
Deprecated. 

requestPhase2

public void requestPhase2()
Deprecated. 

requestSave

public void requestSave(SaveStyle saveStyle,
                        boolean shutdown,
                        InteractStyle interactStyle,
                        boolean fast,
                        boolean global)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Request the session manager to save the session in some way.


flush

public void flush()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Flush the underlying connection to the connection manager. This is useful if you have some pending changes that you want to make sure get committed.


connect

public void connect()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Try to connect to a session manager. This should only be called after a disconnect().


disconnect

public void disconnect()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Disconnect from the session manager.


setID

public void setID(java.lang.String id)
Deprecated. 

getID

public java.lang.String getID()
Deprecated. 

getPreviousID

public java.lang.String getPreviousID()
Deprecated. 

getDesktopID

public java.lang.String getDesktopID()
Deprecated. 

getType

public static org.gnu.glib.Type getType()
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Retrieve the runtime type used by the GLib library.


addListener

public void addListener(ClientListener listener)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Register an object to handle Client events.

See Also:
ClientListener

removeListener

public void removeListener(ClientListener listener)
Deprecated. Superceeded by java-gnome 4.0; this method may or may not exist in the new bindings but if it does, it will likely have a different name or signature in order that the presented API is a more algorithmic mapping of the underlying native libraries.

Removes a listener

See Also:
addListener(ClientListener)

getEventListenerClass

public java.lang.Class getEventListenerClass(java.lang.String signal)
Deprecated. 
Overrides:
getEventListenerClass in class org.gnu.glib.GObject

getEventType

public org.gnu.glib.EventType getEventType(java.lang.String signal)
Deprecated. 
Overrides:
getEventType in class org.gnu.glib.GObject