X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/407f36811ed2513233df1343f0b3591f09efb77e..9c4ba61452d9381c9d71242f0d1610fb2551c846:/docs/latex/wx/txtdatob.tex diff --git a/docs/latex/wx/txtdatob.tex b/docs/latex/wx/txtdatob.tex index 342408feeb..ee654e9156 100644 --- a/docs/latex/wx/txtdatob.tex +++ b/docs/latex/wx/txtdatob.tex @@ -1,20 +1,25 @@ \section{\class{wxTextDataObject}}\label{wxtextdataobject} wxTextDataObject is a specialization of wxDataObject for text data. It can be -used without change to paste data into the \helpref{wxClipboard}{wxclipboard} +used without change to paste data into the \helpref{wxClipboard}{wxclipboard} or a \helpref{wxDropSource}{wxdropsource}. A user may wish to derive a new class from this class for providing text on-demand in order to minimize memory consumption when offering data in several formats, such as plain text and RTF because by default the text is stored in a string in this class, but it might -as well be generated when requested. For this, -\helpref{GetTextLength}{wxtextdataobjectgettextlength} and +as well be generated when requested. For this, +\helpref{GetTextLength}{wxtextdataobjectgettextlength} and \helpref{GetText}{wxtextdataobjectgettext} will have to be overridden. Note that if you already have the text inside a string, you will not achieve any efficiency gain by overriding these functions because copying wxStrings is -already a very efficient operation (data is not actualyl copied because +already a very efficient operation (data is not actually copied because wxStrings are reference counted). +\pythonnote{If you wish to create a derived wxTextDataObject class in +wxPython you should derive the class from wxPyTextDataObject +in order to get Python-aware capabilities for the various virtual +methods.} + \wxheading{Virtual functions to override} This class may be used as is, but all of data transfer functions may be @@ -31,10 +36,10 @@ overridden to increase efficiency. \wxheading{See also} -\helpref{Clipboard and drag and drop overview}{wxclipboardonfigoverview}, -\helpref{wxDataObject}{wxdataobject}, -\helpref{wxDataObjectSimple}{wxdataobjectsimple}, -\helpref{wxFileDataObject}{wxfiledataobject}, +\helpref{Clipboard and drag and drop overview}{wxdndoverview}, +\helpref{wxDataObject}{wxdataobject}, +\helpref{wxDataObjectSimple}{wxdataobjectsimple}, +\helpref{wxFileDataObject}{wxfiledataobject}, \helpref{wxBitmapDataObject}{wxbitmapdataobject} \latexignore{\rtfignore{\wxheading{Members}}} @@ -43,7 +48,7 @@ overridden to increase efficiency. \func{}{wxTextDataObject}{\param{const wxString\& }{text = wxEmptyString}} -Constructor, may be used to initialise the text (otherwise +Constructor, may be used to initialise the text (otherwise \helpref{SetText}{wxtextdataobjectsettext} should be used later). \membersection{wxTextDataObject::GetTextLength}\label{wxtextdataobjectgettextlength}