/////////////////////////////////////////////////////////////////////////////
// Name: clipboard.h
-// Purpose: documentation for global functions
+// Purpose: interface of global functions
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
/**
-Gets the name of a registered clipboard format, and puts it into the buffer @e
+Gets the name of a registered clipboard format, and puts it into the buffer @a
formatName which is of maximum
-length @e maxCount. @e dataFormat must not specify a predefined clipboard
+length @e maxCount. @a dataFormat must not specify a predefined clipboard
format.
*/
bool wxGetClipboardFormatName(int dataFormat,
/**
Gets data from the clipboard.
-
-@e dataFormat may be one of:
-
+@a dataFormat may be one of:
wxCF_TEXT or wxCF_OEMTEXT: returns a pointer to new memory containing a
null-terminated text string.
wxCF_BITMAP: returns a new wxBitmap.
-
The clipboard must have previously been opened for this call to succeed.
*/
-wxObject * wxGetClipboardData(int dataFormat);
+wxObject* wxGetClipboardData(int dataFormat);
/**
Returns @true if the given data format is available on the clipboard.
to the clipboard. Each call to this function specifies a known
available format; the function returns the format that appears next in
the list.
-
- @e dataFormat specifies a known format. If this parameter is zero,
+ @a dataFormat specifies a known format. If this parameter is zero,
the function returns the first format in the list.
-
The return value specifies the next known clipboard data format if the
- function is successful. It is zero if the @e dataFormat parameter specifies
+ function is successful. It is zero if the @a dataFormat parameter specifies
the last format in the list of available formats, or if the clipboard
is not open.
-
Before it enumerates the formats function, an application must open the
clipboard by using the
wxOpenClipboard function.