2 * WIN32 clipboard implementation
4 * Copyright 1994 Martin Ayotte
7 * 2003 Ulrich Czekalla for CodeWeavers
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
24 * This file contains the implementation for the WIN32 Clipboard API
25 * and Wine's internal clipboard cache.
26 * The actual contents of the clipboard are held in the clipboard cache.
27 * The internal implementation talks to a "clipboard driver" to fill or
28 * expose the cache to the native device. (Currently only the X11 and
29 * TTY clipboard driver are available)
33 #include "wine/port.h"
37 #include <sys/types.h>
49 #include "user_private.h"
52 #include "wine/debug.h"
53 #include "wine/unicode.h"
54 #include "wine/server.h"
56 WINE_DEFAULT_DEBUG_CHANNEL(clipboard);
58 #define CF_REGFORMATBASE 0xC000
67 } CLIPBOARDINFO, *LPCLIPBOARDINFO;
70 * Indicates if data has changed since open.
72 static BOOL bCBHasChanged = FALSE;
75 /**************************************************************************
76 * CLIPBOARD_SetClipboardOwner
78 * Set the global wineserver clipboard owner. The current process will
79 * be the owner and <hWnd> will get the render notifications.
81 static BOOL CLIPBOARD_SetClipboardOwner(HWND hWnd)
85 TRACE(" hWnd(%p)\n", hWnd);
87 SERVER_START_REQ( set_clipboard_info )
89 req->flags = SET_CB_OWNER;
90 req->owner = wine_server_user_handle( hWnd );
91 bRet = !wine_server_call_err( req );
99 /**************************************************************************
100 * CLIPBOARD_GetClipboardInfo
102 static BOOL CLIPBOARD_GetClipboardInfo(LPCLIPBOARDINFO cbInfo)
106 SERVER_START_REQ( set_clipboard_info )
110 if (((bRet = !wine_server_call_err( req ))))
112 cbInfo->hWndOpen = wine_server_ptr_handle( reply->old_clipboard );
113 cbInfo->hWndOwner = wine_server_ptr_handle( reply->old_owner );
114 cbInfo->hWndViewer = wine_server_ptr_handle( reply->old_viewer );
115 cbInfo->seqno = reply->seqno;
116 cbInfo->flags = reply->flags;
125 /**************************************************************************
126 * CLIPBOARD_ReleaseOwner
128 BOOL CLIPBOARD_ReleaseOwner(void)
132 SERVER_START_REQ( set_clipboard_info )
134 req->flags = SET_CB_RELOWNER | SET_CB_SEQNO;
136 if (wine_server_call_err( req ))
138 ERR("Failed to set clipboard.\n");
151 /**************************************************************************
152 * CLIPBOARD_OpenClipboard
154 static BOOL CLIPBOARD_OpenClipboard(HWND hWnd)
158 SERVER_START_REQ( set_clipboard_info )
160 req->flags = SET_CB_OPEN;
161 req->clipboard = wine_server_user_handle( hWnd );
162 bRet = !wine_server_call( req );
170 /**************************************************************************
171 * CLIPBOARD_CloseClipboard
173 static BOOL CLIPBOARD_CloseClipboard(void)
177 TRACE(" Changed=%d\n", bCBHasChanged);
179 SERVER_START_REQ( set_clipboard_info )
181 req->flags = SET_CB_CLOSE;
182 if (bCBHasChanged) req->flags |= SET_CB_SEQNO;
183 bRet = !wine_server_call_err( req );
190 /**************************************************************************
191 * CLIPBOARD_SetClipboardViewer
193 static HWND CLIPBOARD_SetClipboardViewer( HWND hWnd )
197 SERVER_START_REQ( set_clipboard_info )
199 req->flags = SET_CB_VIEWER;
200 req->viewer = wine_server_user_handle( hWnd );
201 if (!wine_server_call_err( req ))
202 hwndPrev = wine_server_ptr_handle( reply->old_viewer );
209 /**************************************************************************
210 * WIN32 Clipboard implementation
211 **************************************************************************/
213 /**************************************************************************
214 * RegisterClipboardFormatW (USER32.@)
216 UINT WINAPI RegisterClipboardFormatW(LPCWSTR FormatName)
218 return USER_Driver->pRegisterClipboardFormat(FormatName);
222 /**************************************************************************
223 * RegisterClipboardFormatA (USER32.@)
225 UINT WINAPI RegisterClipboardFormatA(LPCSTR formatName)
231 len = MultiByteToWideChar(CP_ACP, 0, formatName, -1, NULL, 0);
232 wFormat = HeapAlloc(GetProcessHeap(), 0, len*sizeof(WCHAR));
233 MultiByteToWideChar(CP_ACP, 0, formatName, -1, wFormat, len);
235 ret = RegisterClipboardFormatW(wFormat);
236 HeapFree(GetProcessHeap(), 0, wFormat);
241 /**************************************************************************
242 * GetClipboardFormatNameW (USER32.@)
244 INT WINAPI GetClipboardFormatNameW(UINT wFormat, LPWSTR retStr, INT maxlen)
246 return USER_Driver->pGetClipboardFormatName(wFormat, retStr, maxlen);
250 /**************************************************************************
251 * GetClipboardFormatNameA (USER32.@)
253 INT WINAPI GetClipboardFormatNameA(UINT wFormat, LPSTR retStr, INT maxlen)
256 LPWSTR p = HeapAlloc( GetProcessHeap(), 0, maxlen*sizeof(WCHAR) );
257 if(p == NULL) return 0; /* FIXME: is this the correct failure value? */
259 ret = GetClipboardFormatNameW( wFormat, p, maxlen );
261 if (ret && maxlen > 0 && !WideCharToMultiByte( CP_ACP, 0, p, -1, retStr, maxlen, 0, 0))
262 retStr[maxlen-1] = 0;
263 HeapFree( GetProcessHeap(), 0, p );
268 /**************************************************************************
269 * OpenClipboard (USER32.@)
271 * Note: Netscape uses NULL hWnd to open the clipboard.
273 BOOL WINAPI OpenClipboard( HWND hWnd )
277 TRACE("(%p)...\n", hWnd);
279 bRet = CLIPBOARD_OpenClipboard(hWnd);
281 TRACE(" returning %i\n", bRet);
287 /**************************************************************************
288 * CloseClipboard (USER32.@)
290 BOOL WINAPI CloseClipboard(void)
294 TRACE("(%d)\n", bCBHasChanged);
296 if (CLIPBOARD_CloseClipboard())
300 HWND hWndViewer = GetClipboardViewer();
302 USER_Driver->pEndClipboardUpdate();
305 SendMessageW(hWndViewer, WM_DRAWCLIPBOARD, (WPARAM) GetClipboardOwner(), 0);
307 bCBHasChanged = FALSE;
317 /**************************************************************************
318 * EmptyClipboard (USER32.@)
319 * Empties and acquires ownership of the clipboard
321 BOOL WINAPI EmptyClipboard(void)
323 CLIPBOARDINFO cbinfo;
327 if (!CLIPBOARD_GetClipboardInfo(&cbinfo) ||
328 ~cbinfo.flags & CB_OPEN)
330 WARN("Clipboard not opened by calling task!\n");
331 SetLastError(ERROR_CLIPBOARD_NOT_OPEN);
335 /* Destroy private objects */
336 if (cbinfo.hWndOwner)
337 SendMessageW(cbinfo.hWndOwner, WM_DESTROYCLIPBOARD, 0, 0);
339 /* Tell the driver to acquire the selection. The current owner
340 * will be signaled to delete it's own cache. */
342 /* Assign ownership of the clipboard to the current client. We do
343 * this before acquiring the selection so that when we do acquire the
344 * selection and the selection loser gets notified, it can check if
345 * it has lost the Wine clipboard ownership. If it did then it knows
346 * that a WM_DESTORYCLIPBOARD has already been sent. Otherwise it
347 * lost the selection to a X app and it should send the
348 * WM_DESTROYCLIPBOARD itself. */
349 CLIPBOARD_SetClipboardOwner(cbinfo.hWndOpen);
351 /* Acquire the selection. This will notify the previous owner
352 * to clear it's cache. */
353 USER_Driver->pAcquireClipboard(cbinfo.hWndOpen);
355 /* Empty the local cache */
356 USER_Driver->pEmptyClipboard(FALSE);
358 bCBHasChanged = TRUE;
364 /**************************************************************************
365 * GetClipboardOwner (USER32.@)
366 * FIXME: Can't return the owner if the clipboard is owned by an external X-app
368 HWND WINAPI GetClipboardOwner(void)
372 SERVER_START_REQ( set_clipboard_info )
375 if (!wine_server_call_err( req )) hWndOwner = wine_server_ptr_handle( reply->old_owner );
379 TRACE(" hWndOwner(%p)\n", hWndOwner);
385 /**************************************************************************
386 * GetOpenClipboardWindow (USER32.@)
388 HWND WINAPI GetOpenClipboardWindow(void)
392 SERVER_START_REQ( set_clipboard_info )
395 if (!wine_server_call_err( req )) hWndOpen = wine_server_ptr_handle( reply->old_clipboard );
399 TRACE(" hWndClipWindow(%p)\n", hWndOpen);
405 /**************************************************************************
406 * SetClipboardViewer (USER32.@)
408 HWND WINAPI SetClipboardViewer( HWND hWnd )
410 HWND hwndPrev = CLIPBOARD_SetClipboardViewer(hWnd);
413 SendMessageW(hWnd, WM_DRAWCLIPBOARD, (WPARAM) GetClipboardOwner(), 0);
414 TRACE("(%p): returning %p\n", hWnd, hwndPrev);
420 /**************************************************************************
421 * GetClipboardViewer (USER32.@)
423 HWND WINAPI GetClipboardViewer(void)
427 SERVER_START_REQ( set_clipboard_info )
430 if (!wine_server_call_err( req )) hWndViewer = wine_server_ptr_handle( reply->old_viewer );
434 TRACE(" hWndViewer=%p\n", hWndViewer);
440 /**************************************************************************
441 * ChangeClipboardChain (USER32.@)
443 BOOL WINAPI ChangeClipboardChain(HWND hWnd, HWND hWndNext)
446 HWND hWndViewer = GetClipboardViewer();
450 if (WIN_GetFullHandle(hWnd) == hWndViewer)
451 CLIPBOARD_SetClipboardViewer(WIN_GetFullHandle(hWndNext));
453 bRet = !SendMessageW(hWndViewer, WM_CHANGECBCHAIN, (WPARAM)hWnd, (LPARAM)hWndNext);
456 ERR("hWndViewer is lost\n");
462 /**************************************************************************
463 * SetClipboardData (USER32.@)
465 HANDLE WINAPI SetClipboardData(UINT wFormat, HANDLE hData)
467 CLIPBOARDINFO cbinfo;
470 TRACE("(%04X, %p) !\n", wFormat, hData);
472 /* If it's not owned, data can only be set if the format isn't
473 available and its rendering is not delayed */
474 if (!CLIPBOARD_GetClipboardInfo(&cbinfo) ||
475 (!(cbinfo.flags & CB_OWNER) && !hData))
477 WARN("Clipboard not owned by calling task. Operation failed.\n");
481 if (USER_Driver->pSetClipboardData(wFormat, hData, cbinfo.flags & CB_OWNER))
484 bCBHasChanged = TRUE;
491 /**************************************************************************
492 * CountClipboardFormats (USER32.@)
494 INT WINAPI CountClipboardFormats(void)
496 INT count = USER_Driver->pCountClipboardFormats();
497 TRACE("returning %d\n", count);
502 /**************************************************************************
503 * EnumClipboardFormats (USER32.@)
505 UINT WINAPI EnumClipboardFormats(UINT wFormat)
507 CLIPBOARDINFO cbinfo;
509 TRACE("(%04X)\n", wFormat);
511 if (!CLIPBOARD_GetClipboardInfo(&cbinfo) ||
512 (~cbinfo.flags & CB_OPEN))
514 WARN("Clipboard not opened by calling task.\n");
515 SetLastError(ERROR_CLIPBOARD_NOT_OPEN);
518 return USER_Driver->pEnumClipboardFormats(wFormat);
522 /**************************************************************************
523 * IsClipboardFormatAvailable (USER32.@)
525 BOOL WINAPI IsClipboardFormatAvailable(UINT wFormat)
527 BOOL bret = USER_Driver->pIsClipboardFormatAvailable(wFormat);
528 TRACE("%04x, returning %d\n", wFormat, bret);
533 /**************************************************************************
534 * GetClipboardData (USER32.@)
536 HANDLE WINAPI GetClipboardData(UINT wFormat)
539 CLIPBOARDINFO cbinfo;
541 TRACE("%04x\n", wFormat);
543 if (!CLIPBOARD_GetClipboardInfo(&cbinfo) ||
544 (~cbinfo.flags & CB_OPEN))
546 WARN("Clipboard not opened by calling task.\n");
547 SetLastError(ERROR_CLIPBOARD_NOT_OPEN);
551 hData = USER_Driver->pGetClipboardData( wFormat );
553 TRACE("returning %p\n", hData);
558 /**************************************************************************
559 * GetPriorityClipboardFormat (USER32.@)
561 INT WINAPI GetPriorityClipboardFormat(UINT *list, INT nCount)
567 if(CountClipboardFormats() == 0)
570 for (i = 0; i < nCount; i++)
571 if (IsClipboardFormatAvailable(list[i]))
578 /**************************************************************************
579 * GetClipboardSequenceNumber (USER32.@)
580 * Supported on Win2k/Win98
581 * MSDN: Windows clipboard code keeps a serial number for the clipboard
582 * for each window station. The number is incremented whenever the
583 * contents change or are emptied.
584 * If you do not have WINSTA_ACCESSCLIPBOARD then the function returns 0
586 DWORD WINAPI GetClipboardSequenceNumber(VOID)
590 SERVER_START_REQ( set_clipboard_info )
593 if (!wine_server_call_err( req )) seqno = reply->seqno;
597 TRACE("returning %x\n", seqno);