X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/717a57c2fabb054c8f00dc5dae70df1d03cfe532..afbe906abdf9aa69a56571b8b20b095351dd8f34:/docs/latex/wx/tclipbrd.tex diff --git a/docs/latex/wx/tclipbrd.tex b/docs/latex/wx/tclipbrd.tex index e22440d9c4..ae3f102ab3 100644 --- a/docs/latex/wx/tclipbrd.tex +++ b/docs/latex/wx/tclipbrd.tex @@ -1,15 +1,4 @@ -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% Name: tclipbrd.tex -%% Purpose: Data transfer (clipboard and drag and drop) overview -%% Author: Vadim Zeitlin -%% Modified by: -%% Created: 18.10.99 -%% RCS-ID: $Id$ -%% Copyright: (c) Vadim Zeitlin -%% Licence: wxWindows licence -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\section{Clipboard and drag and drop overview}\label{wxclipboardonfigoverview} +\section{wxDataObject overview}\label{wxdataobjectoverview} Classes: \helpref{wxDataObject}{wxdataobject}, \helpref{wxClipboard}{wxclipboard}, @@ -17,7 +6,7 @@ Classes: \helpref{wxDataObject}{wxdataobject}, \helpref{wxDropSource}{wxdropsource}, \helpref{wxDropTarget}{wxdroptarget} -See also: \helpref{DnD sample}{samplednd} +See also: \helpref{Drag and drop overview}{wxdndoverview} and \helpref{DnD sample}{samplednd} This overview discusses data transfer through clipboard or drag and drop. In wxWindows, these two ways to transfer data (either between different @@ -26,7 +15,7 @@ implement both of them using almost the same code - or, in other words, if you implement drag and drop support for your application, you get clipboard support for free and vice versa. -In the heart of both clipboard and drag and drop operations lies the +At the heart of both clipboard and drag and drop operations lies the \helpref{wxDataObject}{wxdataobject} class. The objects of this class (or, to be precise, classes derived from it) represent the data which is being carried by the mouse during drag and drop operation or copied to or pasted from the @@ -42,11 +31,11 @@ application and even the same window when, for example, you drag some text from one position to another in a word processor. Let us describe what each of them should do. -\subsection{The data provider (source) duties}{wxdataobjectsource} +\subsection{The data provider (source) duties}\label{wxdataobjectsource} The data provider is responsible for creating a \helpref{wxDataObject}{wxdataobject} containing the data to be -transfered. Then it should either pass it to the clipboard using +transferred. Then it should either pass it to the clipboard using \helpref{SetData}{wxclipboardsetdata} function or to \helpref{wxDropSource}{wxdropsource} and call \helpref{DoDragDrop}{wxdropsourcedodragdrop} function. @@ -66,14 +55,14 @@ deletes) data - in fact, this usually depends on which menu item the user chose. But for drag and drop it can only know it after \helpref{DoDragDrop}{wxdropsourcedodragdrop} returns (from its return value). -\subsection{The data receiver (target) duties}{wxdataobjecttarget} +\subsection{The data receiver (target) duties}\label{wxdataobjecttarget} To receive (paste in usual terminology) data from the clipboard, you should create a \helpref{wxDataObject}{wxdataobject} derived class which supports the data formats you need and pass it as argument to \helpref{wxClipboard::GetData}{wxclipboardgetdata}. If it returns {\tt FALSE}, no data in (any of) the supported format(s) is available. If it returns {\tt -TRUE}, the data has been successfully transfered to wxDataObject. +TRUE}, the data has been successfully transferred to wxDataObject. For drag and drop case, the \helpref{wxDropTarget::OnData}{wxdroptargetondata} virtual function will be called when a data object is dropped, from which the @@ -81,4 +70,3 @@ data itself may be requested by calling \helpref{wxDropTarget::GetData}{wxdroptargetwxdroptarget} method which fills the data object. -