23efdd028e
Changed dnd and clipboard overviews. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@5138 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
121 lines
3.7 KiB
TeX
121 lines
3.7 KiB
TeX
\section{\class{wxClipboard}}\label{wxclipboard}
|
|
|
|
A class for manipulating the clipboard. Note that this is not compatible with the
|
|
clipboard class from wxWindows 1.xx, which has the same name but a different implementation.
|
|
|
|
To use the clipboard, you call member functions of the global {\bf wxTheClipboard} object.
|
|
|
|
See also the \helpref{wxDataObject overview}{wxdataobjectoverview} for further information.
|
|
|
|
Call \helpref{wxClipboard::Open}{wxclipboardopen} to get ownership of the clipboard. If this operation returns TRUE, you
|
|
now own the clipboard. Call \helpref{wxClipboard::SetData}{wxclipboardsetdata} to put data
|
|
on the clipboard, or \helpref{wxClipboard::GetData}{wxclipboardgetdata} to
|
|
retrieve data from the clipboard. Call \helpref{wxClipboard::Close}{wxclipboardclose} to close
|
|
the clipboard and relinquish ownership. You should keep the clipboard open only momentarily.
|
|
|
|
For example:
|
|
|
|
\begin{verbatim}
|
|
// Write some text to the clipboard
|
|
if (wxTheClipboard->Open())
|
|
{
|
|
// This data objects are held by the clipboard,
|
|
// so do not delete them in the app.
|
|
wxTheClipboard->SetData( new wxTextDataObject("Some text") );
|
|
wxTheClipboard->Close();
|
|
}
|
|
|
|
// Read some text
|
|
if (wxTheClipboard->Open())
|
|
{
|
|
if (wxTheClipboard->IsSupported( wxDF_TEXT ))
|
|
{
|
|
wxTextDataObject data;
|
|
wxTheClipboard->GetData( data );
|
|
wxMessageBox( data.GetText() );
|
|
}
|
|
wxTheClipboard->Close();
|
|
}
|
|
\end{verbatim}
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxObject}{wxobject}
|
|
|
|
\wxheading{Include files}
|
|
|
|
<wx/clipbrd.h>
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{Drag and drop overview}{wxdndoverview}, \helpref{wxDataObject}{wxdataobject}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
\membersection{wxClipboard::wxClipboard}
|
|
|
|
\func{}{wxClipboard}{\void}
|
|
|
|
Constructor.
|
|
|
|
\membersection{wxClipboard::\destruct{wxClipboard}}
|
|
|
|
\func{}{\destruct{wxClipboard}}{\void}
|
|
|
|
Destructor.
|
|
|
|
\membersection{wxClipboard::Clear}\label{wxclipboardclear}
|
|
|
|
\func{void}{Clear}{\void}
|
|
|
|
Clears the global clipboard object and the system's clipboard if possible.
|
|
|
|
\membersection{wxClipboard::Close}\label{wxclipboardclose}
|
|
|
|
\func{bool}{Close}{\void}
|
|
|
|
Call this function to close the clipboard, having opened it with \helpref{wxClipboard::Open}{wxclipboardopen}.
|
|
|
|
\membersection{wxClipboard::GetData}\label{wxclipboardgetdata}
|
|
|
|
\func{bool}{GetData}{\param{wxDataObject\&}{ data}}
|
|
|
|
Call this function to fill {\it data} with data on the clipboard, if available in the required
|
|
format. Returns TRUE on success.
|
|
|
|
\membersection{wxClipboard::IsSupported}\label{wxclipboardissupported}
|
|
|
|
\func{bool}{IsSupported}{\param{const wxDataFormat\&}{ format}}
|
|
|
|
Returns TRUE if the format of the given data object is available on the clipboard.
|
|
|
|
\membersection{wxClipboard::Open}\label{wxclipboardopen}
|
|
|
|
\func{bool}{Open}{\void}
|
|
|
|
Call this function to open the clipboard before calling \helpref{wxClipboard::SetData}{wxclipboardsetdata}
|
|
and \helpref{wxClipboard::GetData}{wxclipboardgetdata}.
|
|
|
|
Call \helpref{wxClipboard::Close}{wxclipboardclose} when you have finished with the clipboard. You
|
|
should keep the clipboard open for only a very short time.
|
|
|
|
Returns TRUE on success. This should be tested (as in the sample shown above).
|
|
|
|
\membersection{wxClipboard::SetData}\label{wxclipboardsetdata}
|
|
|
|
\func{bool}{SetData}{\param{wxDataObject*}{ data}}
|
|
|
|
Call this function to set the data object to the clipboard. This function will
|
|
clear all previous contents in the clipboard, so calling it several times
|
|
does not make any sense.
|
|
|
|
\membersection{wxClipboard::UsePrimarySelection}\label{wxclipboarduseprimary}
|
|
|
|
\func{void}{UsePrimarySelection}{\param{bool}{ primary = TRUE}}
|
|
|
|
On platforms supporting it (currently only GTK), selects the so called
|
|
PRIMARY SELECTION as the clipboard as opposed to the normal clipboard,
|
|
if {\it primary} is TRUE.
|
|
|
|
|