drag_action_requested


Description:

[ Version ( since = "3.10" ) ]
public signal int drag_action_requested (DragContext context, File dest_file, List<File> source_file_list)

When the user starts a drag-and-drop operation and the sidebar needs to ask the application for which drag action to perform, then the sidebar will emit this signal.

The application can evaluate the context for customary actions, or it can check the type of the files indicated by source_file_list against the possible actions for the destination dest_file.

The drag action to use must be the return value of the signal handler.

Parameters:

context

DragContext with information about the drag operation

dest_file

File with the tentative location that is being hovered for a drop

source_file_list

List of File that are being dragged

Returns:

The drag action to use, for example, COPY or MOVE, or 0 if no action is allowed here (i.e. drops are not allowed in the specified dest_file).