Scroller¶

Widget description¶
A scroller holds a single object and “scrolls it around”.
This means that it allows the user to use a scrollbar (or a finger) to drag the viewable region around, allowing to move through a much larger object that is contained in the scroller. The scroller will always have a small minimum size by default as it won’t be limited by the contents of the scroller.
This widget inherits from LayoutClass
,
so that all the functions acting on it also work for scroller objects.
Note
When Elementary is in embedded mode the scrollbars will not be draggable, they appear merely as indicators of how much has been scrolled.
Note
When Elementary is in desktop mode the thumbscroll(a.k.a. fingerscroll) won’t work.
Emitted signals¶
edge,left
- the left edge of the content has been reachededge,right
- the right edge of the content has been reachededge,top
- the top edge of the content has been reachededge,bottom
- the bottom edge of the content has been reachedscroll
- the content has been scrolled (moved)scroll,left
- the content has been scrolled (moved) leftwardsscroll,right
- the content has been scrolled (moved) rightwardsscroll,up
- the content has been scrolled (moved) upwardsscroll,down
- the content has been scrolled (moved) downwardsscroll,anim,start
- scrolling animation has startedscroll,anim,stop
- scrolling animation has stoppedscroll,drag,start
- dragging the contents around has startedscroll,drag,stop
- dragging the contents around has stoppedvbar,drag
- the vertical scroll bar has been draggedvbar,press
- the vertical scroll bar has been pressedvbar,unpress
- the vertical scroll bar has been unpressedhbar,drag
- the horizontal scroll bar has been draggedhbar,press
- the horizontal scroll bar has been pressedhbar,unpress
- the horizontal scroll bar has been unpressedscroll,page,changed
- the visible page has changed
Note
The “scroll,anim,*” and “scroll,drag,*” signals are only emitted by user intervention.
Layout content parts¶
default
- A content of the scroller
Enumerations¶
Scrollbar visibility¶
- efl.elementary.ELM_SCROLLER_POLICY_AUTO¶
Show scrollbars as needed
- efl.elementary.ELM_SCROLLER_POLICY_ON¶
Always show scrollbars
- efl.elementary.ELM_SCROLLER_POLICY_OFF¶
Never show scrollbars
Single direction¶
Type that controls how the content is scrolled.
- efl.elementary.ELM_SCROLLER_SINGLE_DIRECTION_NONE¶
Scroll every direction
- efl.elementary.ELM_SCROLLER_SINGLE_DIRECTION_SOFT¶
Scroll single direction if the direction is certain
- efl.elementary.ELM_SCROLLER_SINGLE_DIRECTION_HARD¶
Scroll only single direction
Movement block¶
Type that blocks the scroll movement in one or more direction.
- since:
1.8
- efl.elementary.ELM_SCROLLER_MOVEMENT_NO_BLOCK¶
Do not block movements
- efl.elementary.ELM_SCROLLER_MOVEMENT_BLOCK_VERTICAL¶
Block vertical movements
- efl.elementary.ELM_SCROLLER_MOVEMENT_BLOCK_HORIZONTAL¶
Block horizontal movements