org.kde.koala
public class KUniqueApplication extends KApplication implements DCOPObjectInterface
See Also: KApplication DCOPObject
UNKNOWN: Maintains only a single instance of a running application at a time.
Constructor Summary | |
---|---|
protected | KUniqueApplication(Class dummy) |
KUniqueApplication(boolean allowStyles, boolean GUIenabled, boolean configUnique)
Constructor. | |
KUniqueApplication(boolean allowStyles, boolean GUIenabled) | |
KUniqueApplication(boolean allowStyles) | |
KUniqueApplication() |
Method Summary | |
---|---|
static void | addCmdLineOptions()
Adds command line options specific for KUniqueApplication.
|
DCOPClient | callingDcopClient()
Returns the DCOPClient responsible for making the call.
|
String | className() |
boolean | connectDCOPSignal(String sender, String senderObj, String signal, String slot, boolean Volatile)
Connects to a DCOP signal. |
boolean | disconnectDCOPSignal(String sender, String senderObj, String signal, String slot)
Disconnects a DCOP signal.
|
void | dispose() Delete the wrapped C++ instance ahead of finalize() |
void | emitDCOPSignal(String signal, byte[] data)
Emit signal as DCOP signal from this object with data as
arguments |
protected void | finalize() Deletes the wrapped C++ instance |
static DCOPObjectInterface | find(String objId)
Try to find a dcop object with the given id.
|
ArrayList | functions()
Returns the list of functions understood by the object. |
ArrayList | functionsDynamic()
This function is of interest when you used an IDL compiler
to generate the implementation for functions() but
you still want to list some functions dynamically.
|
static boolean | hasObject(String objId)
Checks whether an object with the given id is known in this process.
|
ArrayList | interfaces()
Returns the names of the interfaces, specific ones last. |
ArrayList | interfacesDynamic()
This function is of interest when you used an IDL compiler
to generate the implementation for interfaces() but
you still want to list some interfaces dynamically.
|
boolean | isDisposed() Has the wrapped C++ instance been deleted? |
QMetaObject | metaObject() |
int | newInstance()
Creates a new "instance" of the application.
|
static String | objectName(QObject arg1)
Creates an object id for the QObject obj. This is done
using the QObject.name() function. |
String | objId()
Returns the object id of the DCOPObject. |
boolean | process(String fun, byte[] data, StringBuffer replyType, byte[] replyData)
Dispatches any incoming DCOP message for a new instance.
|
boolean | processDynamic(String fun, byte[] data, StringBuffer replyType, byte[] replyData)
This function is of interest when you used an IDL compiler
to generate the implementation for process() but
you still want to dispatch some functions dynamically.
|
boolean | restoringSession()
Returns whether newInstance() is being called while session
restoration is in progress. |
void | setCallingDcopClient(DCOPClient arg1) |
static void | setHandleAutoStarted() |
boolean | setObjId(String objId)
Renames a dcop object, if no other with the same name exists
Use with care, all dcop signals are disconnected |
static boolean | start()
Forks and registers with dcop.
|
Parameters: allowStyles Set to false to disable the loading on plugin based
styles. This is only useful to applications that do not display a GUI
normally. If you do create an application with allowStyles
set to false
it normally runs in the background but under special circumstances
displays widgets. Call KApplication.enableStyles() before
displaying any widgets. GUIenabled Set to false to disable all GUI stuff. This implies
no styles either. configUnique If true, the uniqueness of the application will
depend on the value of the "MultipleInstances"
key in the "KDE" group of the application config file.
UNKNOWN: Constructor.
UNKNOWN: Adds command line options specific for KUniqueApplication.
Returns: the DCOPClient responsible for making the call. This information is only guaranteed to be correct when entering your DCOP function.
UNKNOWN: Returns the DCOPClient responsible for making the call.
Parameters: sender the name of the client that emits the signal. When empty
the signal will be passed from any client. senderObj the name of the sending object that emits the signal. signal the name of the signal. The arguments should match with slot. slot The name of the slot to call. Its arguments should match with signal. Volatile If true, the connection will not be reestablished when
sender
unregisters and reregisters with DCOP. In this case the sender
must be registered when the connection is made.
If false, the connection will be reestablished when sender
reregisters.
In this case the connection can be made even if sender
is not registered
at that time.
Volatile
is true and sender
does not exist.
signal
and slot
do not have matching arguments.
UNKNOWN: Connects to a DCOP signal.
sender
& signal
are empty. In this
case all connections related to this object in the current client
are disconnected. (Both connections from as well as to this object!)Parameters: sender the name of the client that emits the signal. senderObj the name of the object that emits the signal. If empty all objects will be disconnected. signal the name of the signal. The arguments should match with slot. If empty all objects will be disconnected. slot The name of the slot the signal is connected to. If empty all slots will be disconnected.
Returns: false if no connection(s) where removed.
UNKNOWN: Disconnects a DCOP signal.
signal
as DCOP signal from this object with data
as
argumentsParameters: signal the signal to emit data the data to send
UNKNOWN: Emit signal
as DCOP signal from this object with data
as arguments
Parameters: objId the object id to search
Returns: the DCOPObject for the id objId.
UNKNOWN: Try to find a dcop object with the given id.
Returns: a list of functions
See Also: KUniqueApplication KUniqueApplication KUniqueApplication DCOPClient
UNKNOWN: Returns the list of functions understood by the object.
Returns: A list of the additional functions, default is an empty list.
See Also: KUniqueApplication
UNKNOWN: This function is of interest when you used an IDL compiler to generate the implementation for functions() but you still want to list some functions dynamically.
Returns: true if an object with the questionable objId
is
known in this process. This query does not ask proxies.
UNKNOWN: Checks whether an object with the given id is known in this process.
Returns: a list of interfaces
See Also: KUniqueApplication
UNKNOWN: Returns the names of the interfaces, specific ones last.
Returns: A list of the additional interfaces, default is an empty list.
See Also: KUniqueApplication
UNKNOWN: This function is of interest when you used an IDL compiler to generate the implementation for interfaces() but you still want to list some interfaces dynamically.
Returns: An exit value. The calling process will exit with this value.
UNKNOWN: Creates a new "instance" of the application.
obj.
This is done
using the QObject.name() function.Parameters: obj the object whose name will be used
Returns: the created object id
UNKNOWN: Creates an object id for the QObject obj.
Returns: the object's id
UNKNOWN: Returns the object id of the DCOPObject.
Parameters: fun DCOP function signature data the data for the arguments replyType the type of the reply value replyData the reply
See Also: DCOPObject
UNKNOWN: Dispatches any incoming DCOP message for a new instance.
Parameters: fun is the normalized function signature. Such a signature usually looks like foobar(String,int). The return type, qualifiers like "const" etc. are not part of the signature. data the received data replyType write the reply type in this string replyData write the reply data in this array
Returns: true if successful, false otherwise. The default implementation returns always false.
See Also: KUniqueApplication DCOPClient KUniqueApplication DCOPClient
UNKNOWN: This function is of interest when you used an IDL compiler to generate the implementation for process() but you still want to dispatch some functions dynamically.
UNKNOWN: Returns whether newInstance() is being called while session restoration is in progress.
UNKNOWN:
UNKNOWN:
Parameters: objId the new object id
UNKNOWN: Renames a dcop object, if no other with the same name exists Use with care, all dcop signals are disconnected
int main(String[] args) { KAboutData about("myappname", "myAppName", .....); KCmdLineArgs.init(args, &about); KCmdLineArgs.addCmdLineOptions( myCmdOptions ); KUniqueApplication.addCmdLineOptions(); if (!KUniqueApplication.start()) { fprintf(stderr, "myAppName is already running!\n"); exit(0); } KUniqueApplication a; a.exec(); }Note that it's not necessary to call start() explicitly. It will be called automatically before creating KUniqueApplication if it hasn't been called yet, without any performance impact.
Returns: true if registration is successful. false if another process was already running.
UNKNOWN: Forks and registers with dcop.