ScrollbarPainter class
A CustomPainter for painting scrollbars.
Unlike CustomPainters that subclasses CustomPainter and only repaint when shouldRepaint returns true (which requires this CustomPainter to be rebuilt), this painter has the added optimization of repainting and not rebuilding when:
- the scroll position changes; and
- when the scrollbar fades away.
Calling update with the new ScrollMetrics will repaint the new scrollbar position.
Updating the value on the provided fadeoutOpacityAnimation will repaint with the new opacity.
You must call dispose on this ScrollbarPainter when it's no longer used.
See also:
- Scrollbar for a widget showing a scrollbar around a Scrollable in the Material Design style.
- CupertinoScrollbar for a widget showing a scrollbar around a Scrollable in the iOS style.
- Inheritance
- Object
- ChangeNotifier
- ScrollbarPainter
- Implemented types
Constructors
-
ScrollbarPainter({@required Color color, @required TextDirection textDirection, @required double thickness, @required Animation<
double> fadeoutOpacityAnimation, double mainAxisMargin: 0.0, double crossAxisMargin: 0.0, Radius radius, double minLength: _kMinThumbExtent, double minOverscrollLength: _kMinThumbExtent }) - Creates a scrollbar with customizations given by construction arguments.
Properties
- color → Color
-
Color of the thumb. Mustn't be null.
final
- crossAxisMargin → double
-
Distance from the scrollbar's side to the nearest edge in pixels. Musn't
be null.
final
-
fadeoutOpacityAnimation
→ Animation<
double> -
An opacity Animation that dictates the opacity of the thumb.
Changes in value of this Listenable will automatically trigger repaints.
Mustn't be null.
final
- mainAxisMargin → double
-
Distance from the scrollbar's start and end to the edge of the viewport in
pixels. Mustn't be null.
final
- minLength → double
-
The smallest size the scrollbar can shrink to when the total scrollable
extent is large and the current visible viewport is small, and the
viewport is not overscrolled. Mustn't be null.
final
- minOverscrollLength → double
-
The smallest size the scrollbar can shrink to when viewport is
overscrolled. Mustn't be null.
final
- radius → Radius
-
Radius of corners if the scrollbar should have rounded corners. [...]
final
- semanticsBuilder → SemanticsBuilderCallback
-
Returns a function that builds semantic information for the picture drawn
by this painter. [...]
read-only, override
- textDirection → TextDirection
-
TextDirection of the BuildContext which dictates the side of the
screen the scrollbar appears in (the trailing side). Mustn't be null.
final
- thickness → double
-
Thickness of the scrollbar in its cross-axis in pixels. Mustn't be null.
final
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- hasListeners → bool
-
Whether any listeners are currently registered. [...]
@protected, read-only, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Methods
-
dispose(
) → void -
Discards any resources used by the object. After this is called, the
object is not in a usable state and should be discarded (calls to
addListener and removeListener will throw after the object is
disposed). [...]
override
-
hitTest(
Offset position) → bool -
Called whenever a hit test is being performed on an object that is using
this custom paint delegate. [...]
override
-
paint(
Canvas canvas, Size size) → void -
Called whenever the object needs to paint. The given Canvas has its
coordinate space configured such that the origin is at the top left of the
box. The area of the box is the size of the
size
argument. [...]override -
shouldRebuildSemantics(
covariant CustomPainter oldDelegate) → bool -
Called whenever a new instance of the custom painter delegate class is
provided to the RenderCustomPaint object, or any time that a new
CustomPaint object is created with a new instance of the custom painter
delegate class (which amounts to the same thing, because the latter is
implemented in terms of the former). [...]
override
-
shouldRepaint(
covariant ScrollbarPainter old) → bool -
Called whenever a new instance of the custom painter delegate class is
provided to the RenderCustomPaint object, or any time that a new
CustomPaint object is created with a new instance of the custom painter
delegate class (which amounts to the same thing, because the latter is
implemented in terms of the former). [...]
override
-
update(
ScrollMetrics metrics, AxisDirection axisDirection) → void - Update with new ScrollMetrics. The scrollbar will show and redraw itself based on these new metrics. [...]
-
addListener(
VoidCallback listener) → void -
Register a closure to be called when the object changes. [...]
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
notifyListeners(
) → void -
Call all the registered listeners. [...]
@protected, inherited
-
removeListener(
VoidCallback listener) → void -
Remove a previously registered closure from the list of closures that are
notified when the object changes. [...]
inherited
-
toString(
) → String -
Returns a string representation of this object.
inherited
Operators
-
operator ==(
dynamic other) → bool -
The equality operator. [...]
inherited