paint method
Paints the border around the given Rect on the given Canvas, with the given rows and columns.
Uniform borders are more efficient to paint than more complex borders.
The rows
argument specifies the vertical positions between the rows,
relative to the given rectangle. For example, if the table contained two
rows of height 100.0 each, then rows
would contain a single value,
100.0, which is the vertical position between the two rows (relative to
the top edge of rect
).
The columns
argument specifies the horizontal positions between the
columns, relative to the given rectangle. For example, if the table
contained two columns of height 100.0 each, then columns
would contain a
single value, 100.0, which is the vertical position between the two
columns (relative to the left edge of rect
).
The verticalInside border is only drawn if there are at least two columns. The horizontalInside border is only drawn if there are at least two rows. The horizontal borders are drawn after the vertical borders.
The outer borders (in the order top, right, bottom, left, with left above the others) are painted after the inner borders.
The paint order is particularly notable in the case of partially-transparent borders.
Implementation
void paint(Canvas canvas, Rect rect, {
@required Iterable<double> rows,
@required Iterable<double> columns,
}) {
// properties can't be null
assert(top != null);
assert(right != null);
assert(bottom != null);
assert(left != null);
assert(horizontalInside != null);
assert(verticalInside != null);
// arguments can't be null
assert(canvas != null);
assert(rect != null);
assert(rows != null);
assert(rows.isEmpty || (rows.first >= 0.0 && rows.last <= rect.height));
assert(columns != null);
assert(columns.isEmpty || (columns.first >= 0.0 && columns.last <= rect.width));
if (columns.isNotEmpty || rows.isNotEmpty) {
final Paint paint = Paint();
final Path path = Path();
if (columns.isNotEmpty) {
switch (verticalInside.style) {
case BorderStyle.solid:
paint
..color = verticalInside.color
..strokeWidth = verticalInside.width
..style = PaintingStyle.stroke;
path.reset();
for (double x in columns) {
path.moveTo(rect.left + x, rect.top);
path.lineTo(rect.left + x, rect.bottom);
}
canvas.drawPath(path, paint);
break;
case BorderStyle.none:
break;
}
}
if (rows.isNotEmpty) {
switch (horizontalInside.style) {
case BorderStyle.solid:
paint
..color = horizontalInside.color
..strokeWidth = horizontalInside.width
..style = PaintingStyle.stroke;
path.reset();
for (double y in rows) {
path.moveTo(rect.left, rect.top + y);
path.lineTo(rect.right, rect.top + y);
}
canvas.drawPath(path, paint);
break;
case BorderStyle.none:
break;
}
}
}
paintBorder(canvas, rect, top: top, right: right, bottom: bottom, left: left);
}