nsIContentViewManager 编辑

content/base/public/nsIFrameLoader.idlScriptable Manages the content views contained in a browser 1.0 66 Introduced Gecko 2.0 Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

To obtain a reference to the view manager for a document, you can QueryInterface() the nsIFrameLoader object to nsIContentViewManager. See Getting access to content views for details. Once you have the view manager, you can call getContentViewsIn() to get a list of the content views for a given portion of the browser display, then use those nsIContentView objects to manipulate the content views.

Method overview

void getContentViewsIn(in float aXPx, in float aYPx, in float aTopSize, in float aRightSize, in float aBottomSize, in float aLeftSize, [optional] out unsigned long aLength, [retval, array, size_is(aLength)] out nsIContentView aResult);

Attributes

Attribute	Type	Description
rootContentView	nsIContentView	The root content view. Read only.

Methods

getContentViewsIn()

Returns an array of nsIContentView objects representing all of the content views that intersect with the specified rectangle in the browser.

Note: The rectangle is specified using an anchor point, then four distances to indicate how far in each direction to expand the rectangle. This lets you, for example, take the coordinates at which the user clicked (or touched) the screen, and expand outward to create a rectangle from that point.

Pixels are in chrome device pixels and are relative to the browser element.

void getContentViewsIn(
  in float aXPx,
  in float aYPx,
  in float aTopSize,
  in float aRightSize,
  in float aBottomSize,
  in float aLeftSize,
  out unsigned long aLength, Optional
  [retval, array, size_is(aLength)] out nsIContentView aResult
);

Parameters

aXPx

The X coordinate of the anchor point of the rectangle, in CSS pixels.

aYPx

The Y coordinate of the anchor point of the rectangle, in CSS pixels.

aTopSize

The distance upward from the Y anchor to expand the rectangle.

aRightSize

The distance to the right from the X anchor to expand the rectangle.

aBottomSize

The distance downward from the Y anchor to expand the rectangle.

aLeftSize

The distance to the left from the X anchor to expand the rectangle.

aLength Optional

If specified, on return this parameter indicates the number of nsIContentView objects returned in the aResult array.

aResult

On return, an array of nsIContentView objects representing the content views in the specified rectangle.

See also

• Working with content views
• nsIContentView
• nsIFrameLoader
• nsIDOMWindowUtils