#include </home/zeitlin/src/wx/github/interface/wx/ribbon/page.h>

Inheritance diagram for wxRibbonPage:

Detailed Description

Container for related ribbon panels, and a tab within a ribbon bar.

参照:: wxRibbonBar; wxRibbonPanel

Library: wxRibbon

Public Member Functions
	wxRibbonPage ()
	Default constructor.
	wxRibbonPage (wxRibbonBar *parent, wxWindowID id=wxID_ANY, const wxString &label=wxEmptyString, const wxBitmap &icon=wxNullBitmap, long style=0)
	Constructs a ribbon page, which must be a child of a ribbon bar.
virtual	~wxRibbonPage ()
	Destructor.
bool	Create (wxRibbonBar *parent, wxWindowID id=wxID_ANY, const wxString &label=wxEmptyString, const wxBitmap &icon=wxNullBitmap, long style=0)
	Create a ribbon page in two-step ribbon page construction.
void	SetArtProvider (wxRibbonArtProvider *art)
	Set the art provider to be used.
wxBitmap &	GetIcon ()
	Get the icon used for the page in the ribbon bar tab area (only displayed if the ribbon bar is actually showing icons).
void	SetSizeWithScrollButtonAdjustment (int x, int y, int width, int height)
	Set the size of the page and the external scroll buttons (if any).
void	AdjustRectToIncludeScrollButtons (wxRect *rect) const
	Expand a rectangle of the page to include external scroll buttons (if any).
bool	DismissExpandedPanel ()
	Dismiss the current externally expanded panel, if there is one.
virtual bool	Realize ()
	Perform a full re-layout of all panels on the page.
virtual bool	ScrollLines (int lines)
	Scroll the page by some amount up / down / left / right.
bool	ScrollPixels (int pixels)
	Scroll the page by a set number of pixels up / down / left / right.
wxOrientation	GetMajorAxis () const
	Get the direction in which ribbon panels are stacked within the page.

List of all members.

Constructor & Destructor Documentation

wxRibbonPage::wxRibbonPage ( )

Default constructor.

With this constructor, Create() should be called in order to create the ribbon page.

wxRibbonPage::wxRibbonPage	(	wxRibbonBar *	parent,
		wxWindowID	id = `wxID_ANY`,
		const wxString &	label = `wxEmptyString`,
		const wxBitmap &	icon = `wxNullBitmap`,
		long	style = `0`
	)

Constructs a ribbon page, which must be a child of a ribbon bar.

Parameters:

parent	Pointer to a parent wxRibbonBar (unlike most controls, a wxRibbonPage can only have wxRibbonBar as a parent).
id	Window identifier.
label	Label to be used in the wxRibbonBar's tab list for this page (if the ribbon bar is set to display labels).
icon	Icon to be used in the wxRibbonBar's tab list for this page (if the ribbon bar is set to display icons).
style	Currently unused, should be zero.

virtual wxRibbonPage::~wxRibbonPage ( ) [virtual]

Destructor.

Member Function Documentation

void wxRibbonPage::AdjustRectToIncludeScrollButtons ( wxRect * rect ) const

Expand a rectangle of the page to include external scroll buttons (if any).

When no scroll buttons are shown, has no effect.

Parameters:

[in,out] rect The rectangle to adjust. The width and height will not be reduced, and the x and y will not be increased.

bool wxRibbonPage::Create	(	wxRibbonBar *	parent,
		wxWindowID	id = `wxID_ANY`,
		const wxString &	label = `wxEmptyString`,
		const wxBitmap &	icon = `wxNullBitmap`,
		long	style = `0`
	)

Create a ribbon page in two-step ribbon page construction.

Should only be called when the default constructor is used, and arguments have the same meaning as in the full constructor.

bool wxRibbonPage::DismissExpandedPanel ( )

Dismiss the current externally expanded panel, if there is one.

When a ribbon panel automatically minimises, it can be externally expanded into a floating window. When the user clicks a button in such a panel, the panel should generally re-minimise. Event handlers for buttons on ribbon panels should call this method to achieve this behaviour.

Returns:: true if a panel was minimised, false otherwise.

wxBitmap& wxRibbonPage::GetIcon ( )

Get the icon used for the page in the ribbon bar tab area (only displayed if the ribbon bar is actually showing icons).

wxOrientation wxRibbonPage::GetMajorAxis ( ) const

Get the direction in which ribbon panels are stacked within the page.

This is controlled by the style of the containing wxRibbonBar, meaning that all pages within a bar will have the same major axis. As well as being the direction in which panels are stacked, it is also the axis in which scrolling will occur (when required).

Returns:: wxHORIZONTAL or wxVERTICAL (never wxBOTH).

virtual bool wxRibbonPage::Realize ( ) [virtual]

Perform a full re-layout of all panels on the page.

Should be called after panels are added to the page, or the sizing behaviour of a panel on the page changes (i.e. due to children being added to it). Usually called automatically when wxRibbonBar::Realize() is called.

Will invoke wxRibbonPanel::Realize() for all child panels.

Reimplemented from wxRibbonControl.

virtual bool wxRibbonPage::ScrollLines ( int lines ) [virtual]

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 programmatically scrolled. Positive values of 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.

Returns:: true if the page scrolled at least one pixel in the given direction, false if it did not scroll.

参照:: GetMajorAxis(); ScrollPixels()

Reimplemented from wxWindow.

bool wxRibbonPage::ScrollPixels ( int pixels )

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 programmatically scrolled. Positive values of lines will scroll right or down, while negative values will scroll up or left (depending on the direction in which panels are stacked).

Returns:: true if the page scrolled at least one pixel in the given direction, false if it did not scroll.

参照:: GetMajorAxis(); ScrollLines()

void wxRibbonPage::SetArtProvider ( wxRibbonArtProvider * art ) [virtual]

Set the art provider to be used.

Normally called automatically by wxRibbonBar when the page is created, or the art provider changed on the bar.

The new art provider will be propagated to the children of the page.

Reimplemented from wxRibbonControl.

void wxRibbonPage::SetSizeWithScrollButtonAdjustment	(	int	x,
		int	y,
		int	width,
		int	height
	)

Set the size of the page and the external scroll buttons (if any).

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-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 are scroll buttons, it positions them at the edges of the given area, and then calls SetSize() with the remaining area.

This is provided as a separate function to SetSize() rather than within the implementation of SetSize(), as interacting algorithms may not expect SetSize() to also set the size of siblings.

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

Member Function Documentation