hitTestChildren method

  1. @override
bool hitTestChildren(
  1. BoxHitTestResult result, {
  2. required Offset position,
})
override

Override this method to check whether any children are located at the given position.

Subclasses should return true if at least one child reported a hit at the specified position.

Typically children should be hit-tested in reverse paint order so that hit tests at locations where children overlap hit the child that is visually "on top" (i.e., paints later).

The caller is responsible for transforming position from global coordinates to its location relative to the origin of this RenderBox. Likewise, this RenderBox is responsible for transforming the position that it passes to its children when it calls hitTest on each child.

If transforming is necessary, BoxHitTestResult.addWithPaintTransform, BoxHitTestResult.addWithPaintOffset, or BoxHitTestResult.addWithRawTransform need to be invoked by subclasses to record the required transform operations in the BoxHitTestResult. These methods will also help with applying the transform to position.

Used by hitTest. If you override hitTest and do not call this function, then you don't need to implement this function.

Implementation

@override
bool hitTestChildren(BoxHitTestResult result, { required Offset position }) {
  for (final RenderBox child in _children.values) {
    final TwoDimensionalViewportParentData childParentData = parentDataOf(child);
    if (!childParentData.isVisible) {
      // Can't hit a child that is not visible.
      continue;
    }
    final bool isHit = result.addWithPaintOffset(
      offset: childParentData.paintOffset,
      position: position,
      hitTest: (BoxHitTestResult result, Offset transformed) {
        assert(transformed == position - childParentData.paintOffset!);
        return child.hitTest(result, position: transformed);
      },
    );
    if (isHit) {
      return true;
    }
  }
  return false;
}