org.kde.koala

Interface DCOPClientSignals

public interface DCOPClientSignals

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

Method Detail

applicationRegistered

public void applicationRegistered(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

UNKNOWN: Indicates that the application appId has been registered with the server we are attached to.

applicationRemoved

public void applicationRemoved(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

UNKNOWN: Indicates that the formerly registered application appId has been removed.

attachFailed

public void attachFailed(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

UNKNOWN: Indicates that the process of establishing DCOP communications failed in some manner.

blockUserInput

public 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

UNKNOWN: Indicates that user input shall be blocked or released, depending on the argument.

callBack

public void callBack(int arg1, 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: DCOPClientSignals

UNKNOWN: