# Source: dcopc.h |
Annotated List
Files
Globals
Hierarchy
Index

    /*
     * C interface to DCOP
     *
     * (C) 2000 Rik Hemsley <rik@kde.org>
     * (C) 2000 Simon Hausmann <hausmann@kde.org>
     */

    #ifndef __dcopc_h__
    #define __dcopc_h__

    #ifdef __cplusplus
    extern "C" {
    #endif

    #ifndef Bool
    #define Bool int
    #define True 1
    #define False 0
    #endif

    typedef void (*dcop_callback_t)(
      const char * object_id,
      const char * function,
      const char * data,
      unsigned int data_length
    );

    /**
     * Attach to the DCOP server.
     * This registers you as anonymous-pid - you may then register with a 'real'
     * name with dcop_register().
     */
    Bool dcop_attach(void);

    /**
     * Register as app 'app_name'.
     * If add_pid is true, you will be registered as app_name-pid.
     *
     * It might not be possible to give you the exact name you requested.
     * In this case, the retval will be different to what you expect, so you
     * should not rely on getting 'app_name'.
     *
     * If it was not possible to register, retval is 0.
     */
    char * dcop_register(const char * app_name, Bool add_pid);

    /**
     * Detach from the DCOP server.
     */
    Bool dcop_detach(void);

    /**
     * Register the callback function for an object id.
     * This function should have signature dcop_callback_t. The name of the
     * actual function that should be called is passed in the struct.
     */
    Bool dcop_register_callback(const char * object_id, dcop_callback_t callback);

    /**
     * Send a signal to a DCOP object.
     *
     * @p receiving_app     Name the target application is registered under.
     *                      Note that you may use wildcards here. For example,
     *                      you could send to all 'konsole' objects that are
     *                      registered using the '-pid' extension with
     *                      "konsole-*".
     *
     * @p object            Name of the remote object.
     * @p function          Name of the function to call.
     * @p data              Marshalled arguments to pass to function.
     * @p data_length       Number of octets in data.
     */
    Bool dcop_send_signal(
      const char * receiving_app,
      const char * object,
      const char * function,
      char * data,
      int data_length
    );

    /**
     * Call a function of a DCOP object.
     *
     * @p app_name          Name this application is registered under.
     * @p remote_app_name   Name the target application is registered under.
     * @p remote_object_id  Name of the remote object.
     * @p remote_function   Name of the function to call.
     * @p data              Marshalled arguments to pass to function.
     * @p data_length       Number of octets in data.
     * @p reply_type        Will be set to type of retval, represented as a string.
     * @p reply_data        Will be set to retval (marshalled).
     * @p reply_data_length Will be set to number of octets in retval.
     */
    Bool dcop_call(
      const char * app_name,
      const char * remote_app_name,
      const char * remote_object_id,
      const char * remote_function,
      const char * data,
      int data_length,
      char ** reply_type,
      char ** reply_data,
      int * reply_data_length
    );

    #ifdef __cplusplus
    }
    #endif

    #endif /* __dcopc_h__ */

Generated by: root@sparc.ports.openbsd.org on Wed May 2 09:33:39 2001, using kdoc 2.0a53.