/**
Get the icon used for the page in the ribbon bar tab area (only
- displayed if the ribbon bar is actuallt showing icons).
+ displayed if the ribbon bar is actually showing icons).
*/
wxBitmap& GetIcon();
When a page is too small to display all of its children, scroll buttons
will appear (and if the page is sized up enough, they will disappear again).
- Slightly counter-intuively, these buttons are created as siblings of the
+ Slightly counter-intuitively, these buttons are created as siblings of the
page rather than children of the page (to achieve correct cropping and
paint ordering of the children and the buttons). When there are no scroll
buttons, this function behaves the same as SetSize(), however when there
then calls SetSize() with the remaining area.
This is provided as a separate function to SetSize() rather than within
- the implementation of SetSize(), as iteracting algorithms may not expect
+ the implementation of SetSize(), as interacting algorithms may not expect
SetSize() to also set the size of siblings.
*/
void SetSizeWithScrollButtonAdjustment(int x, int y, int width, int height);
Scroll the page by some amount up / down / left / right.
When the page's children are too big to fit in the onscreen area given to
- the page, scroll buttons will appear, and the page can be programatically
+ the page, scroll buttons will appear, and the page can be programmatically
scrolled. Positive values of @a lines will scroll right or down, while
negative values will scroll up or left (depending on the direction in which
panels are stacked). A line is equivalent to a constant number of pixels.
@see GetMajorAxis()
@see ScrollPixels()
+ @see ScrollSections()
*/
virtual bool ScrollLines(int lines);
Scroll the page by a set number of pixels up / down / left / right.
When the page's children are too big to fit in the onscreen area given to
- the page, scroll buttons will appear, and the page can be programatically
+ the page, scroll buttons will appear, and the page can be programmatically
scrolled. Positive values of @a lines will scroll right or down, while
negative values will scroll up or left (depending on the direction in which
panels are stacked).
@see GetMajorAxis()
@see ScrollLines()
+ @see ScrollSections()
*/
bool ScrollPixels(int pixels);
+ /**
+ Scroll the page by an entire child section.
+
+ The @a sections parameter value should be 1 or -1. This will scroll
+ enough to uncover a partially visible child section or totally uncover
+ the next child section that may not be visible at all.
+
+ @return @true if the page scrolled at least one pixel in the given
+ direction, @false if it did not scroll.
+
+ @see ScrollPixels()
+ @see ScrollSections()
+
+ @since 2.9.5
+ */
+ bool ScrollSections(int sections);
+
/**
Get the direction in which ribbon panels are stacked within the page.