gnome-shell/src/st/st-clipboard.h

/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
/*
 * st-clipboard.h: clipboard object
 *
 * Copyright 2009 Intel Corporation.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms and conditions of the GNU Lesser General Public License,
 * version 2.1, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for
 * more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

#if !defined(ST_H_INSIDE) && !defined(ST_COMPILATION)
#error "Only <st/st.h> can be included directly.h"
#endif

#ifndef _ST_CLIPBOARD_H
#define _ST_CLIPBOARD_H

#include <glib-object.h>
#include <meta/meta-selection.h>

G_BEGIN_DECLS

#define ST_TYPE_CLIPBOARD st_clipboard_get_type()
G_DECLARE_FINAL_TYPE (StClipboard, st_clipboard, ST, CLIPBOARD, GObject)

typedef struct _StClipboard StClipboard;

/**
 * StClipboard:
 *
 * The contents of this structure is private and should only be accessed using
 * the provided API.
 */
struct _StClipboard
{
  /*< private >*/
  GObject parent;
};

typedef enum {
  ST_CLIPBOARD_TYPE_PRIMARY,
  ST_CLIPBOARD_TYPE_CLIPBOARD
} StClipboardType;

/**
 * StClipboardCallbackFunc:
 * @clipboard: A #StClipboard
 * @text: text from the clipboard
 * @user_data: user data
 *
 * Callback function called when text is retrieved from the clipboard.
 */
typedef void (*StClipboardCallbackFunc) (StClipboard *clipboard,
                                         const gchar *text,
                                         gpointer     user_data);

/**
 * StClipboardContentCallbackFunc:
 * @clipboard: A #StClipboard
 * @bytes: content from the clipboard
 * @user_data: user data
 *
 * Callback function called when content is retrieved from the clipboard.
 */
typedef void (*StClipboardContentCallbackFunc) (StClipboard *clipboard,
                                                GBytes      *bytes,
                                                gpointer     user_data);

StClipboard* st_clipboard_get_default (void);

GList * st_clipboard_get_mimetypes (StClipboard             *clipboard,
                                    StClipboardType          type);

void st_clipboard_get_text (StClipboard             *clipboard,
                            StClipboardType          type,
                            StClipboardCallbackFunc  callback,
                            gpointer                 user_data);
void st_clipboard_set_text (StClipboard             *clipboard,
                            StClipboardType          type,
                            const gchar             *text);

void st_clipboard_set_content (StClipboard          *clipboard,
                               StClipboardType       type,
                               const gchar          *mimetype,
                               GBytes               *bytes);
void st_clipboard_get_content (StClipboard                    *clipboard,
                               StClipboardType                 type,
                               const gchar                    *mimetype,
                               StClipboardContentCallbackFunc  callback,
                               gpointer                        user_data);

void st_clipboard_set_selection (MetaSelection *selection);

G_END_DECLS

#endif /* _ST_CLIPBOARD_H */