diff options
Diffstat (limited to 'doc/html/dnd.html')
| -rw-r--r-- | doc/html/dnd.html | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/doc/html/dnd.html b/doc/html/dnd.html index 08e41e137..abd016e8b 100644 --- a/doc/html/dnd.html +++ b/doc/html/dnd.html @@ -62,7 +62,7 @@ sophistication): <tt>qt/examples/iconview/simple_dd</tt>, <tt>qt/examples/dragdr <a href="tqtextedit.html">TQTextEdit</a> widget source code. <p> <h2> Dragging </h2> -<a name="1"></a><p> To start a drag, for example in a <a href="tqwidget.html#mouseMoveEvent">mouse motion event</a>, create an object of the <a href="ntqdragobject.html">TQDragObject</a> +<a name="1"></a><p> To start a drag, for example in a <a href="tqwidget.html#mouseMoveEvent">mouse motion event</a>, create an object of the <a href="tqdragobject.html">TQDragObject</a> subclass appropriate for your media, such as <a href="tqtextdrag.html">TQTextDrag</a> for text and <a href="tqimagedrag.html">TQImageDrag</a> for images. Then call the drag() method. This is all you need for simple dragging of existing types. @@ -70,8 +70,8 @@ need for simple dragging of existing types. <pre> void MyWidget::startDrag() { - <a href="ntqdragobject.html">TQDragObject</a> *d = new <a href="tqtextdrag.html">TQTextDrag</a>( myHighlightedText(), this ); - d-><a href="ntqdragobject.html#dragCopy">dragCopy</a>(); + <a href="tqdragobject.html">TQDragObject</a> *d = new <a href="tqtextdrag.html">TQTextDrag</a>( myHighlightedText(), this ); + d-><a href="tqdragobject.html#dragCopy">dragCopy</a>(); // do NOT delete d. } </pre> @@ -127,14 +127,14 @@ void MyWidget::dropEvent(TQDropEvent* event) <p> <h2> The Clipboard </h2> -<a name="3"></a><p> The <a href="ntqdragobject.html">TQDragObject</a>, <a href="qdragenterevent.html">TQDragEnterEvent</a>, <a href="qdragmoveevent.html">TQDragMoveEvent</a>, and <a href="qdropevent.html">TQDropEvent</a> +<a name="3"></a><p> The <a href="tqdragobject.html">TQDragObject</a>, <a href="tqdragenterevent.html">TQDragEnterEvent</a>, <a href="tqdragmoveevent.html">TQDragMoveEvent</a>, and <a href="tqdropevent.html">TQDropEvent</a> classes are all subclasses of TQMimeSource: the class of objects which provide typed information. If you base your data transfers on TQDragObject, you not only get drag-and-drop, but you also get traditional cut-and-paste for free. The <a href="ntqclipboard.html">TQClipboard</a> has two functions: <pre> setData(TQMimeSource*) - <a href="qmimesource.html">TQMimeSource</a>* data()const + <a href="tqmimesource.html">TQMimeSource</a>* data()const </pre> With these functions you can trivially put your drag-and-drop oriented @@ -154,7 +154,7 @@ void MyWidget::paste() } </pre> -You can even use <a href="ntqdragobject.html">TQDragObject</a> subclasses as part of file IO. For +You can even use <a href="tqdragobject.html">TQDragObject</a> subclasses as part of file IO. For example, if your application has a subclass of TQDragObject that encodes CAD designs in DXF format, your saving and loading code might be: @@ -182,14 +182,14 @@ void MyWidget::load() } </pre> -Note how the <a href="ntqdragobject.html">TQDragObject</a> subclass is called "MyCadDrag", not +Note how the <a href="tqdragobject.html">TQDragObject</a> subclass is called "MyCadDrag", not "MyDxfDrag": because in the future you might extend it to provide DXF, DWG, SVF, WMF, or even <a href="ntqpicture.html">TQPicture</a> data to other applications. <p> <h2> Drag and Drop Actions </h2> <a name="4"></a><p> In the simpler cases, the target of a drag-and-drop receives a copy of the data being dragged and the source decides whether to delete the -original. This is the "Copy" action in <a href="qdropevent.html">TQDropEvent</a>. The target may also +original. This is the "Copy" action in <a href="tqdropevent.html">TQDropEvent</a>. The target may also choose to understand other actions, specifically the Move and Link actions. If the target understands the Move action, <em>the target</em> is responsible for both the copy and delete operations and the source will not attempt to delete the data itself. If the target @@ -214,11 +214,11 @@ which of those it can accept. For example, <a href="tqtextdrag.html">TQTextDrag< for the "<tt>text/plain</tt>" MIME type (ordinary unformatted text), and the Unicode formats "<tt>text/utf16</tt>" and "<tt>text/utf8</tt>"; <a href="tqimagedrag.html">TQImageDrag</a> provides for "<tt>image/*</tt>", where <tt>*</tt> is any image format that -<a href="tqimageio.html">TQImageIO</a> supports; and the <a href="quridrag.html">TQUriDrag</a> subclass provides +<a href="tqimageio.html">TQImageIO</a> supports; and the <a href="tquridrag.html">TQUriDrag</a> subclass provides "<tt>text/uri-list</tt>", a standard format for transferring a list of filenames (or URLs). <p> To implement drag-and-drop of some type of information for which there -is no available <a href="ntqdragobject.html">TQDragObject</a> subclass, the first and most important +is no available <a href="tqdragobject.html">TQDragObject</a> subclass, the first and most important step is to look for existing formats that are appropriate: the Internet Assigned Numbers Authority (<a href="http://www.iana.org">IANA</a>) provides a <a href="http://www.isi.edu/in-notes/iana/assignments/media-types/">hierarchical list of MIME media types</a> at the Information Sciences Institute @@ -226,12 +226,12 @@ list of MIME media types</a> at the Information Sciences Institute maximizes the inter-operability of your application with other software now and in the future. <p> To support an additional media type, subclass either TQDragObject or -<a href="qstoreddrag.html">TQStoredDrag</a>. Subclass TQDragObject when you need to provide support for +<a href="tqstoreddrag.html">TQStoredDrag</a>. Subclass TQDragObject when you need to provide support for multiple media types. Subclass the simpler TQStoredDrag when one type is sufficient. <p> Subclasses of TQDragObject will override the -<a href="qmimesource.html#format">const char* format(int i) const</a> and -<a href="qmimesource.html#encodedData">TQByteArray encodedData(const char* mimetype) const</a> +<a href="tqmimesource.html#format">const char* format(int i) const</a> and +<a href="tqmimesource.html#encodedData">TQByteArray encodedData(const char* mimetype) const</a> members, and provide a set-method to encode the media data and static members canDecode() and decode() to decode incoming data, similar to <a href="tqimagedrag.html#canDecode">bool canDecode(TQMimeSource*) const</a> and @@ -259,8 +259,8 @@ the drag start point and the drop event might look like this: <p> <pre> void MyEditor::startDrag() { - <a href="ntqdragobject.html">TQDragObject</a> *d = new <a href="tqtextdrag.html">TQTextDrag</a>(myHighlightedText(), this); - if ( d-><a href="ntqdragobject.html#drag">drag</a>() && d-><a href="ntqdragobject.html#target">target</a>() != this ) + <a href="tqdragobject.html">TQDragObject</a> *d = new <a href="tqtextdrag.html">TQTextDrag</a>(myHighlightedText(), this); + if ( d-><a href="tqdragobject.html#drag">drag</a>() && d-><a href="tqdragobject.html#target">target</a>() != this ) cutMyHighlightedText(); } |