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).