Struct gtk4::builders::DropTargetBuilder
source · pub struct DropTargetBuilder { /* private fields */ }
Expand description
A builder-pattern type to construct DropTarget
objects.
Implementations§
source§impl DropTargetBuilder
impl DropTargetBuilder
sourcepub fn actions(self, actions: DragAction) -> Self
pub fn actions(self, actions: DragAction) -> Self
The GdkDragActions
that this drop target supports.
sourcepub fn formats(self, formats: &ContentFormats) -> Self
pub fn formats(self, formats: &ContentFormats) -> Self
The gdk::ContentFormats
that determine the supported data formats.
sourcepub fn preload(self, preload: bool) -> Self
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.
sourcepub fn name(self, name: impl Into<GString>) -> Self
pub fn name(self, name: impl Into<GString>) -> Self
The name for this controller, typically used for debugging purposes.
sourcepub fn propagation_limit(self, propagation_limit: PropagationLimit) -> Self
pub fn propagation_limit(self, propagation_limit: PropagationLimit) -> Self
The limit for which events this controller will handle.
sourcepub fn propagation_phase(self, propagation_phase: PropagationPhase) -> Self
pub fn propagation_phase(self, propagation_phase: PropagationPhase) -> Self
The propagation phase at which this controller will handle events.
sourcepub fn build(self) -> DropTarget
pub fn build(self) -> DropTarget
Build the DropTarget
.