gp_clipboard.h

// SPDX-License-Identifier: LGPL-2.1-or-later
/*
 * Copyright (C) 2009-2021 Cyril Hrubis <metan@ucw.cz>
 */
/*
 
  Clipboard is, by definition, asynchronous. Getting a clipboard data requires
  roundtrip to a server in most cases.
 
  Getting the clipboard starts by sending a clipboard request. Once clipboard
  data are ready the application will get an GP_EV_SYS_CLIPBOARD event and the
  data can be retrieved by calling the clipboard get function.
 
 */
 
#ifndef BACKENDS_GP_CLIPBOARD_H
#define BACKENDS_GP_CLIPBOARD_H
 
#include <backends/gp_types.h>
 
enum gp_clipboard_op {
        GP_CLIPBOARD_SET,
        GP_CLIPBOARD_REQUEST,
        GP_CLIPBOARD_GET,
        GP_CLIPBOARD_CLEAR,
};
 
struct gp_clipboard {
        enum gp_clipboard_op op;
        union {
                const char *str;
                char *ret;
        };
        size_t len;
};
 
int gp_backend_clipboard(gp_backend *self, gp_clipboard *op);
 
static inline int gp_backend_clipboard_set(gp_backend *self, const char *str, size_t len)
{
        struct gp_clipboard op = {
                .op = GP_CLIPBOARD_SET,
                .str = str,
                .len = len,
        };
 
        return gp_backend_clipboard(self, &op);
}
 
static inline int gp_backend_clipboard_request(gp_backend *self)
{
        struct gp_clipboard op = {.op = GP_CLIPBOARD_REQUEST};
 
        return gp_backend_clipboard(self, &op);
}
 
static inline char *gp_backend_clipboard_get(gp_backend *self)
{
        struct gp_clipboard op = {.op = GP_CLIPBOARD_GET};
 
        gp_backend_clipboard(self, &op);
 
        return op.ret;
}
 
static inline void gp_backend_clipboard_ready(gp_backend *self)
{
        gp_ev_queue_push(self->event_queue, GP_EV_SYS, GP_EV_SYS_CLIPBOARD, 0, 0);
}
 
#endif /* BACKENDS_GP_CLIPBOARD_H */