Struct ExternalDndHandle 

pub struct ExternalDndHandle { /* private fields */ }

Per-app external-drag service. Registered in app-state by TeksiloAppBuilder::install_external_dnd; teksilo-app calls Self::attach / Self::detach from its window lifecycle hooks. Cloneable; clones share the same backend and guard map.

Implementations

impl ExternalDndHandle

pub fn new<B: ExternalDndBackend + 'static>(backend: B) -> Self

Build a handle wrapping the given backend.

pub fn attach( &self, window_id: TeksiloWindowId, parent: ParentHandle, poster: Arc<dyn AppEventPoster>, )

Register the window as an OS drop target. Idempotent per window: a second attach for the same window_id replaces (and so revokes) the previous registration.

pub fn detach(&self, window_id: TeksiloWindowId)

Revoke the window’s OS drop-target registration (dropping its guard). Called from teksilo-app’s window-close path. No-op if the window was never attached.

pub fn attached_count(&self) -> usize

Number of currently-attached windows. Test/diagnostic helper.

pub fn set_scale_factor(&self, window_id: TeksiloWindowId, scale: f64)

Tell window_id’s backend the window’s current HiDPI scale factor. See ExternalDndGuard::set_scale_factor. No-op if not attached.

pub fn cancel_drag(&self, window_id: TeksiloWindowId)

Cancel an in-flight outbound OS drag for window_id (the user pressed Escape). See ExternalDndGuard::cancel_drag. No-op if not attached.

pub fn begin_drag( &self, window_id: TeksiloWindowId, data: &OutboundDragData, image: Option<&DragImageData>, pointer: PointerKind, ) -> OsDragStart

Start a native OS (outbound) drag for window_id, delegating to that window’s guard. OsDragStart::Declined if the window isn’t attached or the backend declines (no outbound support). Called from teksilo-app’s WindowOps::begin_os_drag. See ExternalDndGuard::begin_drag.

pub fn set_drop_accepted(&self, window_id: TeksiloWindowId, accepted: bool)

Push the widget tree’s accept verdict for an inbound OS drag over window_id to its backend. See ExternalDndGuard::set_drop_accepted. No-op if the window isn’t attached.

pub fn run_pending_outbound_drag( &self, window_id: TeksiloWindowId, on_start: &mut dyn FnMut(OsDragId), )

Run the deferred blocking outbound OS drag for window_id (Windows OLE DoDragDrop), if its guard stashed one via begin_drag. Called from teksilo-app when it receives an OutboundOsDragRequest; on_start runs right before the blocking loop (see ExternalDndGuard::run_pending_outbound_drag). No-op if the window isn’t attached.

The (blocking) drag loop runs on a shared handle to the guard, used without holding the guards map’s borrow, so on_start, which runs app handlers, may open or close a window (attach or detach a guard) without a borrow conflict.

Trait Implementations

impl Clone for ExternalDndHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExternalDndHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.