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>, ) -> bool

Start a native OS (outbound) drag for window_id, delegating to that window’s guard. Returns true if a native session started, false if the window isn’t attached or the backend declines (no outbound support). Called from teksilo-app’s WindowOps::begin_os_drag.

pub fn run_pending_outbound_drag(&self, window_id: TeksiloWindowId)

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. No-op if the window isn’t attached.

The guards borrow is deliberately held across the (blocking) drag loop: the only re-entrant guards mutation is attach / detach (window create / close), which cannot happen while the user is mid-drag on this window.

Trait Implementations

impl Clone for ExternalDndHandle

fn clone(&self) -> ExternalDndHandle

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.