Struct gtk4::builders::DropTargetBuilder

pub struct DropTargetBuilder { /* private fields */ }

A builder-pattern type to construct DropTarget objects.

Implementations

impl DropTargetBuilder

pub fn actions(self, actions: DragAction) -> Self

The GdkDragActions that this drop target supports.

pub fn formats(self, formats: &ContentFormats) -> Self

The gdk::ContentFormats that determine the supported data formats.

pub fn preload(self, preload: bool) -> Self

Whether the drop data should be preloaded when the pointer is only hovering over the widget but has not been released.

Setting this property allows finer grained reaction to an ongoing drop at the cost of loading more data.

The default value for this property is false to avoid downloading huge amounts of data by accident.

For example, if somebody drags a full document of gigabytes of text from a text editor across a widget with a preloading drop target, this data will be downloaded, even if the data is ultimately dropped elsewhere.

For a lot of data formats, the amount of data is very small (like GDK_TYPE_RGBA), so enabling this property does not hurt at all. And for local-only Drag-and-Drop operations, no data transfer is done, so enabling it there is free.

pub fn name(self, name: impl Into<GString>) -> Self

The name for this controller, typically used for debugging purposes.

pub fn propagation_limit(self, propagation_limit: PropagationLimit) -> Self

The limit for which events this controller will handle.

pub fn propagation_phase(self, propagation_phase: PropagationPhase) -> Self

The propagation phase at which this controller will handle events.

pub fn build(self) -> DropTarget

Build the DropTarget.