Determines if a link being dragged can be dropped.
boolean canDropLink( in nsIDOMDragEvent aEvent, in PRBool aAllowSameDocument );
- A dragenter or dragover event.
false, drops are only allowed if the document of the source of the drag is different from the destination. This check includes any parent, sibling and child frames in the same content tree. If
true, the source is not checked.
true if the link being dragged can be dropped.
- Missing Description
Given a drop event, determines the link being dragged. If a uri is returned the caller can, for instance, load it. If
null is returned, there is no valid link to be dropped.
AString dropLink( in nsIDOMDragEvent aEvent, out AString aName );
- A drop event.
- The link title if it exists, or an empty string otherwise.
A uri, or
null if there is no valid link to be dropped.
- Error will be thrown and the event canceled if the receiving target should not load the uri for security reasons. This will occur if the source of the drag initiated a link for dragging that it itself cannot access. This prevents a source document from tricking the user into a dragging a chrome url for example.