This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtCancelDnd()

Cancel a drag-and-drop operation

Synopsis:

int PtCancelDnd( PhRid_t rid,
                 unsigned flags,
                 PhPoint_t const *pos,
                 unsigned ig,
                 unsigned long handle );

Arguments:

rid

The region ID.

flags

A combination of the following bits:

• Pt_DND_SILENT -- the initiator gets no notifications of drag-and-drop progress (valid only if no request data types were added to the PtTransportCtrl_t structure).
• Pt_DND_LOCAL -- the drop can occur only within the context of the application that initiated the drag-and-drop. That is to say that the user can't drop the data on any other application. This is very useful for allowing the dragging and dropping of private data or pointer references that are meaningful only within a single application's context.

pos

The position where the drag started.

ig

The input group.

handle

A number that you can use to identify a transaction.

Library:

ph

Description:

PtCancelDnd() cancels a drag-and-drop operation.

Returns:

0

Success.

-1

An error occurred.

Classification:

Photon

See also:

PhPoint_t, PtCreateTransportCtrl(), PtDndFetch_t, PtDndSelect(), PtTransportCtrl_t, PtTransportType()

Drag and Drop chapter of the Photon Programmer's Guide