org.kde.koala
Interface DCOPClientSignals


public interface DCOPClientSignals


Method Summary
 void applicationRegistered(java.lang.String appId)
          Indicates that the application appId has been registered with the server we are attached to.
 void applicationRemoved(java.lang.String appId)
          Indicates that the formerly registered application appId has been removed.
 void attachFailed(java.lang.String msg)
          Indicates that the process of establishing DCOP communications failed in some manner.
 void blockUserInput(boolean block)
          Indicates that user input shall be blocked or released, depending on the argument.
 void callBack(int arg1, java.lang.String arg2, byte[] arg3)
          Signal used for callbacks of async calls.
 

Method Detail

applicationRegistered

void applicationRegistered(java.lang.String appId)
Indicates that the application appId has been registered with the server we are attached to. You need to call setNotifications() first, to tell the DCOP server that you want to get these events.

Parameters:
appId - the id of the new application

applicationRemoved

void applicationRemoved(java.lang.String appId)
Indicates that the formerly registered application appId has been removed. You need to call setNotifications() first, to tell the DCOP server that you want to get these events.

Parameters:
appId - the id of the removed application

attachFailed

void attachFailed(java.lang.String msg)
Indicates that the process of establishing DCOP communications failed in some manner. Usually attached to a dialog box or some other visual aid.

Parameters:
msg - the message tha contains further information

blockUserInput

void blockUserInput(boolean block)
Indicates that user input shall be blocked or released, depending on the argument. The signal is emitted whenever the client has to wait too long (i.e. more than 1/10 of a second) for an answer to a synchronous call. In that case, it will enter a local event loop to keep the GUI updated until finally an answer arrives. In KDE, the KApplication object connects to this signal to be able to block any user input (i.e. mouse and key events) while we are waiting for an answer. If we did not do this, the application might end up in an illegal state, as a keyboard shortcut or a mouse action might cause another dcop call to be issued.

Parameters:
block - true to block user input, false otherwise

callBack

void callBack(int arg1,
              java.lang.String arg2,
              byte[] arg3)
Signal used for callbacks of async calls. This signal is automatically connected to the call back slot specified in the async call.

See Also:
#callAsync