mozilla
Your Search Results

    nsIFrameLoader

    Handles loading a frame.
    1.0
    28
    Introduced
    Gecko 1.8
    Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    Note: This interface works in tandem with the nsIContentView interface to manage frames across processes if Electrolysis is in use to support per-frame processes.

    Method overview

    void activateFrameEvent(in AString aType, in boolean capture); Mobile Only in Gecko 2.0
    void activateRemoteFrame(); Mobile Only in Gecko 2.0
    void destroy();
    void loadFrame();
    void loadURI(in nsIURI aURI);
    void sendCrossProcessKeyEvent(in AString aType, in long aKeyCode, in long aCharCode, in long aModifiers, [optional] in boolean aPreventDefault); Mobile Only in Gecko 2.0
    void sendCrossProcessMouseEvent(in AString aType, in float aX, in float aY, in long aButton, in long aClickCount, in long aModifiers, [optional] in boolean aIgnoreRootScrollFrame); Mobile Only in Gecko 2.0
    void updatePositionAndSize(in nsIFrame aIFrame); Native code only! Mobile Only in Gecko 2.0

    Attributes

    Attribute Type Description
    delayRemoteDialogs boolean Mobile Only in Gecko 2.0
    depthTooGreat boolean 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. Read only.
    docShell nsIDocShell Get the docshell from the frame loader. Read only.
    messageManager nsIChromeFrameMessageManager The message manager handling messages for this frame. Read only.

    Methods

    Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    activateFrameEvent()

    Activates event forwarding from client (remote frame) to parent.

    void activateFrameEvent(
      in AString aType,
      in boolean capture
    );
    
    Parameters
    aType
    The event type for which to enable forwarding.
    capture
    Whether or not to capture these events.

    Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    activateRemoteFrame()

    Activates the remote frame.

    void activateRemoteFrame();
    
    Parameters

    None.

    Exceptions thrown

    Throws an exception with non-remote frames.

    destroy()

    Destroys the frame loader and everything inside it. This will clear the weak owner content reference.

    void destroy();
    
    Parameters

    None.

    loadFrame()

    Starts loading the frame. This method figures out what to load from the owner content in the frame loader.

    void loadFrame();
    
    Parameters

    None.

    Requires Gecko 1.9 (Firefox 3)

    loadURI()

    Loads the specified URI in this frame. Behaves identically to loadFrame(), except that this method lets you specify the URI to load.

    void loadURI(
      in nsIURI aURI
    );
    
    Parameters
    aURI
    The URI to load into the frame.

    Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    sendCrossProcessKeyEvent()

    Mobile Only in Gecko 2.0
    Available only in Firefox Mobile as of Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    Creates and sends a KeyEvent to the content viewport's process. See nsIDOMWindowUtils.sendKeyEvent() for details; this method is its equivalent for cross-process event handling.

    void sendCrossProcessKeyEvent(
      in AString aType,
      in long aKeyCode,
      in long aCharCode,
      in long aModifiers,
      [optional] in boolean aPreventDefault
    );
    
    Parameters
    aType
    The event type.
    aKeyCode
    The key code.
    aCharCode
    The character code.
    aModifiers
    The modifier flags.
    aPreventDefault
    Whether or not to prevent default actions from being performed.

    Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    sendCrossProcessMouseEvent()

    Mobile Only in Gecko 2.0
    Available only in Firefox Mobile as of Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    Creates and sends a MouseEvent to the content viewport's process. See nsIDOMWindowUtils.sendMouseEvent() for details; this method is its equivalent for cross-process event handling.

    void sendCrossProcessMouseEvent(
      in AString aType,
      in float aX,
      in float aY,
      in long aButton,
      in long aClickCount,
      in long aModifiers,
      [optional] in boolean aIgnoreRootScrollFrame
    );
    
    Parameters
    aType
    The type of mouse event to send.
    aX
    The X coordinate of the mouse.
    aY
    The Y coordinate of the mouse.
    aButton
    Which button was clicked, if any.
    aClickCount
    The number of clicks comprising the mouse button event, if any.
    aModifiers
    The modifier keys in effect at the time of the event.
    aIgnoreRootScrollFrame Optional
    Whether or not to ignore the root scroll frame.

    Native code only!

    updatePositionAndSize

    Mobile Only in Gecko 2.0
    Available only in Firefox Mobile as of Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    Updates the position and size of the subdocument loaded by this frameloader.

    void updatePositionAndSize(
      in nsIFrame aIFrame
    );
    
    Parameters
    aIFrame
    The nsIFrame for the content node that owns this frameloader.

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy
    Last updated by: Sheppy,