nsIContentViewManager

content/base/public/nsIFrameLoader.idlScriptable

Manages the content views contained in a browser

1.0

Introduced

Gecko 2.0

Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Mobile Only in Gecko 2.0
Available only in Firefox Mobile as of 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.