foo-webview-sdk
    Preparing search index...

    Interface DndEnterPayload

    Payload of the dnd:enter event. A drag entered the window. Only the window under the cursor gets it, never another one, because real filesystem paths are sensitive. paths is empty when the drag carries no CF_HDROP file list (browser links, virtual shell objects, archive entries) or when the document origin is not trusted with real paths.

    interface DndEnterPayload {
        hasFiles: boolean;
        paths: string[];
        resolvedPaths: (string | null)[];
        sessionId: string;
        source: "external" | "self" | "other-window";
        x: number;
        y: number;
    }
    Index
    hasFiles: boolean

    Whether the drag carries a CF_HDROP file list; reported truthfully even when paths is withheld, since it reveals nothing by itself.

    paths: string[]

    Absolute filesystem paths, in DataTransfer.files order; empty when the drag carries no file list or the document origin is not trusted with paths.

    resolvedPaths: (string | null)[]

    Target of the .lnk shortcut at the same index of paths, or null; always as long as paths, including when both are withheld and empty. Only .lnk is resolved: a shortcut to a shell object, a target too long to read back intact (Windows caps it at MAX_PATH), an unavailable COM apartment and an entry skipped to keep the drop responsive all report null, never an empty string. A broken shortcut reports the path it recorded, so a non-null entry says where the shortcut points, not that a file is there.

    sessionId: string

    Ties the dnd:enter, dnd:leave and dnd:drop of one drag together. Unique across the host process, so it also tells which window the drag belongs to.

    source: "external" | "self" | "other-window"

    Where the drag came from: self when it started in this window's page, other-window when it started in another window of the same foobar2000 (the main window or a popup), external for everything else, such as Explorer, another application, another foobar2000 process or a drag that started in a Default UI or Columns UI panel. The host reads it from a marker it adds to every drag that starts in a window it hosts; any program can imitate that marker, so treat the value as a hint about the drag's origin, not as a security check.

    x: number

    Cursor x in client-area physical pixels; divide by devicePixelRatio for CSS pixels.

    y: number

    Cursor y in client-area physical pixels; divide by devicePixelRatio for CSS pixels.