Ubuntu Platform API  2.8.1
A library helping with tight integration into the Ubuntu platform
clipboard.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2013 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU Lesser General Public License version 3 as
6  * published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Ricardo Mendoza <ricardo.mendoza@canonical.com>
17  * Thomas Voß <thomas.voss@canonical.com>
18  */
19 
20 #ifndef UBUNTU_APPLICATION_UI_CLIPBOARD_H_
21 #define UBUNTU_APPLICATION_UI_CLIPBOARD_H_
22 
23 #include <ubuntu/visibility.h>
24 
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29  /*
30  FIXME: See ua_ui_get_clipboard_content
31  */
34  void* data,
35  size_t size);
36 
37  /*
38  Memory pointed by data is owned by Ubuntu Application API.
39  Caller is expected to not attempt to modify or delete it.
40  It's also not guaranteed to remain valid after any other call is made
41  to the Ubuntu Application API.
42 
43  FIXME:
44  This API is bad as the user has no idea what kind of data the clipboard
45  contains. It should provide a mapping between mime types (as plain ascii strings)
46  and their respective data so the user is able to interpret the contents properly.
47  */
50  void** data,
51  size_t* size);
52 
53 #ifdef __cplusplus
54 }
55 #endif
56 
57 #endif /* UBUNTU_APPLICATION_UI_CLIPBOARD_H_ */
UBUNTU_DLL_PUBLIC void ua_ui_get_clipboard_content(void **data, size_t *size)
#define UBUNTU_DLL_PUBLIC
Definition: visibility.h:26
UBUNTU_DLL_PUBLIC void ua_ui_set_clipboard_content(void *data, size_t size)