| Index: content/browser/frame_host/render_frame_host_impl.h
|
| diff --git a/content/browser/frame_host/render_frame_host_impl.h b/content/browser/frame_host/render_frame_host_impl.h
|
| index 420a2c2795d7512d3ac241213dc4854290d45737..1dd851221cdf625aba822d208adc4836f4a77f44 100644
|
| --- a/content/browser/frame_host/render_frame_host_impl.h
|
| +++ b/content/browser/frame_host/render_frame_host_impl.h
|
| @@ -252,10 +252,23 @@ class CONTENT_EXPORT RenderFrameHostImpl : public RenderFrameHost,
|
| // TODO(clamy): Remove this once PlzNavigate ships.
|
| void set_is_loading(bool is_loading) { is_loading_ = is_loading; }
|
|
|
| - // This returns the RenderFrameHost's owned RenderWidgetHost if it has one,
|
| - // or else it returns nullptr.
|
| - // If the RenderFrameHost is the page's main frame, this returns instead a
|
| - // pointer to the RenderViewHost (which inherits RenderWidgetHost).
|
| + // Returns true if this is a top-level frame, or if this frame's RenderFrame
|
| + // is in a different process from its parent frame. Local roots are
|
| + // distinguished by owning a RenderWidgetHost, which manages input events
|
| + // and painting for this frame and its contiguous local subtree in the
|
| + // renderer process.
|
| + bool is_local_root() { return !!render_widget_host_; }
|
| +
|
| + // Returns the RenderWidgetHostImpl attached to this frame or the nearest
|
| + // ancestor frame, which could potentially be the root. For most input
|
| + // and rendering related purposes, GetView() should be preferred and
|
| + // RenderWidgetHostViewBase methods used. GetRenderWidgetHost() will not
|
| + // return a nullptr, whereas GetView() potentially will (for instance,
|
| + // after a renderer crash).
|
| + //
|
| + // This method crashes if this RenderFrameHostImpl does not own a
|
| + // a RenderWidgetHost and nor does any of its ancestors. That would
|
| + // typically mean that the frame has been detached from the frame tree.
|
| RenderWidgetHostImpl* GetRenderWidgetHost();
|
|
|
| GlobalFrameRoutingId GetGlobalFrameRoutingId();
|
|
|