This should not be used from build methods, because the build context will not be rebuilt if the value that would be returned by this method changes. In general, inheritFromWidgetOfExactType is more appropriate for such cases. This method is useful only in esoteric cases where a widget needs to cause an ancestor to change its layout or paint behavior. For example, it is used by Material so that InkWell widgets can trigger the ink splash on the Material's actual render object.
Calling this method is relatively expensive (O(N) in the depth of the tree). Only call this method if the distance from this widget to the desired ancestor is known to be small and bounded.
This method should not be called from State.deactivate or State.dispose because the widget tree is no longer stable at that time. To refer to an ancestor from one of those methods, save a reference to the ancestor by calling ancestorRenderObjectOfType in State.didChangeDependencies.
RenderObject ancestorRenderObjectOfType(TypeMatcher matcher);