next up previous contents index
Next: 4. The Targets Table Up: 2. Protocol Basics Previous: 2. Protocol Messages   Contents   Index

3. Drag & Drop Flags

Many of the drag and drop messages contain a flag bitfield, which is called the ``DnD Flags'' throughout this documentation. The ``DnD Flags'' consist of four distinct bitfields - each of it is four bits wide and is labeled 1 through 4 in figure [*].

Not every message makes use of every of the four bitfields. Some drag and drop messages don't use the ``DnD Flags'' at all, although they contain a spare field with the same size and in the same position as the ``DnD Flags''. Below, the descriptions of the various drag and drop messages will refer to this bitfields 1 through 4. Thus, you can easily tell, which bitfields are used for a particular message.

Figure: The ``DnD Flags'' signal various status conditions during a drag and drop operation.
\begin{figure}
\hskip\leftmargin\epsfig {file=DD_Effect.eps,scale=1.09}\end{figure}

Their purpose is as follows:


\begin{itemlist}
% latex2html id marker 3236\item[\circled{1}] Operation: this...
...table \ref{completion_status} for valid
completion status codes.
\end{itemlist}




Table: Operation codes.
Identifier Value
XmDROP_NOOP 0x00
XmDROP_MOVE 0x01
XmDROP_COPY 0x02
XmDROP_LINK 0x04

Table: Completion status codes.
Identifier Value
XmDROP 0x00
XmDROP_HELP 0x01
XmDROP_CANCEL 0x02
XmDROP_INTERRUPT 0x03



Table: Drop site status codes.
Identifier Value
XmNO_DROP_SITE 0x01
XmDROP_SITE_INVALID 0x02
XmDROP_SITE_VALID 0x03
XmINVALID_DROP_SITE (DEPRECATED SYMBOL) 0x02
XmVALID_DROP_SITE (DEPRECATED SYMBOL) 0x03



next up previous contents index
Next: 4. The Targets Table Up: 2. Protocol Basics Previous: 2. Protocol Messages   Contents   Index
Danny Backx
2000-12-13