The toolbar may contain multiple pages toolbar buttons (icons), depending on how many toolbar buttons are defined by the menu file, the tools the and the value of config node plugins/lib_hid_common/toolbar/icons_per_page (that specifies how manu icons to put on a page). When there are multiple pages there is always one page of icons displayed and the page index can be modified by the up/down arrow buttons on the left side of the toolbar.

This action is both an accessor for scripts and utility for keyboard/menu bindings. The first argument is a subcommand; some subcommands take a page index as the second argument. The subcommands are:

get Return the index of the currently active page (integer; for user scripting).
max Return the index of the last page (integer; for user scripting).
set Second argument is an integer page index between 0 and max, inclusive.
up Same effect as if the 'up' arrow button was pressed: select previous page, rolling over from page 0 to max page.
down Same effect as if the 'down' arrow button was pressed: select next page, rolling over from max page to page 0.