mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
2f1d036bc7
CLOSED TREE Backed out changeset e716d9ac93d7 (bug 1214148) Backed out changeset 5f693237c8c1 (bug 1214148) Backed out changeset 3a4865d79416 (bug 1214148)
243 lines
7.4 KiB
Plaintext
243 lines
7.4 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
interface nsFrameLoader;
|
|
interface nsIDocShell;
|
|
interface nsIURI;
|
|
interface nsIFrame;
|
|
interface nsSubDocumentFrame;
|
|
interface nsIMessageSender;
|
|
interface nsIVariant;
|
|
interface nsIDOMElement;
|
|
interface nsITabParent;
|
|
interface nsILoadContext;
|
|
|
|
[scriptable, builtinclass, uuid(1645af04-1bc7-4363-8f2c-eb9679220ab1)]
|
|
interface nsIFrameLoader : nsISupports
|
|
{
|
|
/**
|
|
* Get the docshell from the frame loader.
|
|
*/
|
|
readonly attribute nsIDocShell docShell;
|
|
|
|
/**
|
|
* Get this frame loader's TabParent, if it has a remote frame. Otherwise,
|
|
* returns null.
|
|
*/
|
|
readonly attribute nsITabParent tabParent;
|
|
|
|
/**
|
|
* Get an nsILoadContext for the top-level docshell. For remote
|
|
* frames, a shim is returned that contains private browsing and app
|
|
* information.
|
|
*/
|
|
readonly attribute nsILoadContext loadContext;
|
|
|
|
/**
|
|
* Start loading the frame. This method figures out what to load
|
|
* from the owner content in the frame loader.
|
|
*/
|
|
void loadFrame();
|
|
|
|
/**
|
|
* Loads the specified URI in this frame. Behaves identically to loadFrame,
|
|
* except that this method allows specifying the URI to load.
|
|
*/
|
|
void loadURI(in nsIURI aURI);
|
|
|
|
/**
|
|
* Loads the specified URI in this frame but using a different process.
|
|
* Behaves identically to loadURI, except that this method only works
|
|
* with remote frame. For a signed package, we need to specifiy the
|
|
* package identifier.
|
|
* Throws an exception with non-remote frames.
|
|
*/
|
|
void switchProcessAndLoadURI(in nsIURI aURI, in ACString aPackageId);
|
|
|
|
/**
|
|
* Puts the frameloader in prerendering mode.
|
|
*/
|
|
void setIsPrerendered();
|
|
|
|
/**
|
|
* Destroy the frame loader and everything inside it. This will
|
|
* clear the weak owner content reference.
|
|
*/
|
|
void destroy();
|
|
|
|
/**
|
|
* Find out whether the loader's frame is at too great a depth in
|
|
* the frame tree. This can be used to decide what operations may
|
|
* or may not be allowed on the loader's docshell.
|
|
*/
|
|
readonly attribute boolean depthTooGreat;
|
|
|
|
/**
|
|
* Updates the position and size of the subdocument loaded by this frameloader.
|
|
*
|
|
* @param aIFrame The nsIFrame for the content node that owns this frameloader
|
|
*/
|
|
[noscript] void updatePositionAndSize(in nsSubDocumentFrame aIFrame);
|
|
|
|
/**
|
|
* Activate remote frame.
|
|
* Throws an exception with non-remote frames.
|
|
*/
|
|
void activateRemoteFrame();
|
|
|
|
/**
|
|
* Deactivate remote frame.
|
|
* Throws an exception with non-remote frames.
|
|
*/
|
|
void deactivateRemoteFrame();
|
|
|
|
/**
|
|
* @see nsIDOMWindowUtils sendMouseEvent.
|
|
*/
|
|
void sendCrossProcessMouseEvent(in AString aType,
|
|
in float aX,
|
|
in float aY,
|
|
in long aButton,
|
|
in long aClickCount,
|
|
in long aModifiers,
|
|
[optional] in boolean aIgnoreRootScrollFrame);
|
|
|
|
/**
|
|
* Activate event forwarding from client (remote frame) to parent.
|
|
*/
|
|
void activateFrameEvent(in AString aType, in boolean capture);
|
|
|
|
// Note, when frameloaders are swapped, also messageManagers are swapped.
|
|
readonly attribute nsIMessageSender messageManager;
|
|
|
|
/**
|
|
* @see nsIDOMWindowUtils sendKeyEvent.
|
|
*/
|
|
void sendCrossProcessKeyEvent(in AString aType,
|
|
in long aKeyCode,
|
|
in long aCharCode,
|
|
in long aModifiers,
|
|
[optional] in boolean aPreventDefault);
|
|
|
|
/**
|
|
* Request that the next time a remote layer transaction has been
|
|
* received by the Compositor, a MozAfterRemoteFrame event be sent
|
|
* to the window.
|
|
*/
|
|
void requestNotifyAfterRemotePaint();
|
|
|
|
/**
|
|
* Request an event when the layer tree from the remote tab becomes
|
|
* available or unavailable. When this happens, a mozLayerTreeReady
|
|
* or mozLayerTreeCleared event is fired.
|
|
*/
|
|
void requestNotifyLayerTreeReady();
|
|
void requestNotifyLayerTreeCleared();
|
|
|
|
/**
|
|
* The default event mode automatically forwards the events
|
|
* handled in EventStateManager::HandleCrossProcessEvent to
|
|
* the child content process when these events are targeted to
|
|
* the remote browser element.
|
|
*
|
|
* Used primarly for input events (mouse, keyboard)
|
|
*/
|
|
const unsigned long EVENT_MODE_NORMAL_DISPATCH = 0x00000000;
|
|
|
|
/**
|
|
* With this event mode, it's the application's responsability to
|
|
* convert and forward events to the content process
|
|
*/
|
|
const unsigned long EVENT_MODE_DONT_FORWARD_TO_CHILD = 0x00000001;
|
|
|
|
attribute unsigned long eventMode;
|
|
|
|
/**
|
|
* If false, then the subdocument is not clipped to its CSS viewport, and the
|
|
* subdocument's viewport scrollbar(s) are not rendered.
|
|
* Defaults to true.
|
|
*/
|
|
attribute boolean clipSubdocument;
|
|
|
|
/**
|
|
* If false, then the subdocument's scroll coordinates will not be clamped
|
|
* to their scroll boundaries.
|
|
* Defaults to true.
|
|
*/
|
|
attribute boolean clampScrollPosition;
|
|
|
|
/**
|
|
* The element which owns this frame loader.
|
|
*
|
|
* For example, if this is a frame loader for an <iframe>, this attribute
|
|
* returns the iframe element.
|
|
*/
|
|
readonly attribute nsIDOMElement ownerElement;
|
|
|
|
|
|
/**
|
|
* Cached childID of the ContentParent owning the TabParent in this frame
|
|
* loader. This can be used to obtain the childID after the TabParent died.
|
|
*/
|
|
readonly attribute unsigned long long childID;
|
|
|
|
/**
|
|
* Get or set this frame loader's visibility.
|
|
*
|
|
* The notion of "visibility" here is separate from the notion of a
|
|
* window/docshell's visibility. This field is mostly here so that we can
|
|
* have a notion of visibility in the parent process when frames are OOP.
|
|
*/
|
|
[infallible] attribute boolean visible;
|
|
|
|
/**
|
|
* Find out whether the owner content really is a browser or app frame
|
|
* Especially, a widget frame is regarded as an app frame.
|
|
*/
|
|
readonly attribute boolean ownerIsBrowserOrAppFrame;
|
|
|
|
/**
|
|
* Find out whether the owner content really is a widget. If this attribute
|
|
* returns true, |ownerIsBrowserOrAppFrame| must return true.
|
|
*/
|
|
readonly attribute boolean ownerIsWidget;
|
|
|
|
};
|
|
|
|
%{C++
|
|
class nsFrameLoader;
|
|
%}
|
|
|
|
native alreadyAddRefed_nsFrameLoader(already_AddRefed<nsFrameLoader>);
|
|
|
|
[scriptable, uuid(c4abebcf-55f3-47d4-af15-151311971255)]
|
|
interface nsIFrameLoaderOwner : nsISupports
|
|
{
|
|
/**
|
|
* The frame loader owned by this nsIFrameLoaderOwner
|
|
*/
|
|
readonly attribute nsIFrameLoader frameLoader;
|
|
[noscript, notxpcom] alreadyAddRefed_nsFrameLoader GetFrameLoader();
|
|
|
|
/**
|
|
* Puts the FrameLoaderOwner in prerendering mode.
|
|
*/
|
|
void setIsPrerendered();
|
|
|
|
/**
|
|
* Swap frame loaders with the given nsIFrameLoaderOwner. This may
|
|
* only be posible in a very limited range of circumstances, or
|
|
* never, depending on the object implementing this interface.
|
|
*
|
|
* @throws NS_ERROR_NOT_IMPLEMENTED if the swapping logic is not
|
|
* implemented for the two given frame loader owners.
|
|
* @throws NS_ERROR_DOM_SECURITY_ERR if the swap is not allowed on
|
|
* security grounds.
|
|
*/
|
|
void swapFrameLoaders(in nsIFrameLoaderOwner aOtherOwner);
|
|
};
|