3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
129 lines
4.1 KiB
Objective-C
129 lines
4.1 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/simplebook.h
|
|
// Purpose: wxSimplebook public API documentation.
|
|
// Author: wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxSimplebook
|
|
|
|
wxSimplebook is a control showing exactly one of its several pages.
|
|
|
|
It implements wxBookCtrlBase class interface but doesn't allow the user to
|
|
change the page being displayed, unlike all the other book control classes,
|
|
only the program can do it.
|
|
|
|
This class is created in the same manner as any other wxBookCtrl but then
|
|
the program will typically call ChangeSelection() to show different pages.
|
|
See the @ref page_samples_notebook for an example of wxSimplebook in
|
|
action.
|
|
|
|
Notice that is often convenient to use ShowNewPage() instead of the base
|
|
class AddPage().
|
|
|
|
There are no special styles defined for this class as it has no visual
|
|
appearance of its own.
|
|
|
|
There are also no special events, this class reuses
|
|
@c wxEVT_BOOKCTRL_PAGE_CHANGING and @c
|
|
wxEVT_BOOKCTRL_PAGE_CHANGED events for the events it generates if
|
|
the program calls SetSelection().
|
|
|
|
@library{none}
|
|
@category{bookctrl}
|
|
|
|
@see wxBookCtrl, wxNotebook, @ref page_samples_notebook
|
|
|
|
@since 2.9.5
|
|
*/
|
|
class wxSimplebook : public wxBookCtrlBase
|
|
{
|
|
public:
|
|
/**
|
|
Default constructor.
|
|
|
|
Use Create() (inherited from the base class) later to really create the
|
|
control.
|
|
*/
|
|
wxSimplebook();
|
|
|
|
/**
|
|
Constructs a simple book control.
|
|
*/
|
|
wxSimplebook(wxWindow* parent,
|
|
wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxEmptyString);
|
|
|
|
|
|
/**
|
|
Set the effects to use for showing and hiding the pages.
|
|
|
|
This method allows to specify the effects passed to
|
|
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() respectively
|
|
when the pages need to be shown or hidden.
|
|
|
|
By default, no effects are used, but as the pages are only changed
|
|
by the program and not the user himself, it may be useful to use some
|
|
visual effects to make the changes more noticeable.
|
|
|
|
@param showEffect
|
|
The effect to use for showing the newly selected page.
|
|
@param hideEffect
|
|
The effect to use for hiding the previously selected page.
|
|
|
|
@see SetEffectsTimeouts()
|
|
*/
|
|
void SetEffects(wxShowEffect showEffect, wxShowEffect hideEffect);
|
|
|
|
/**
|
|
Set the same effect to use for both showing and hiding the pages.
|
|
|
|
This is the same as <code>SetEffects(effect, effect)</code>.
|
|
|
|
@see SetEffectTimeout()
|
|
*/
|
|
void SetEffect(wxShowEffect effect);
|
|
|
|
/**
|
|
Set the effect timeout to use for showing and hiding the pages.
|
|
|
|
This method allows to configure the timeout arguments passed to
|
|
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() if a
|
|
non-default effect is used.
|
|
|
|
If this method is not called, default, system-dependent timeout is
|
|
used.
|
|
|
|
@param showTimeout
|
|
Timeout of the show effect, in milliseconds.
|
|
@param hideTimeout
|
|
Timeout of the hide effect, in milliseconds.
|
|
|
|
@see SetEffects()
|
|
*/
|
|
void SetEffectsTimeouts(unsigned showTimeout, unsigned hideTimeout);
|
|
|
|
/**
|
|
Set the same effect timeout to use for both showing and hiding the
|
|
pages.
|
|
|
|
This is the same as <code>SetEffectsTimeouts(timeout, timeout)</code>.
|
|
|
|
@see SetEffect()
|
|
*/
|
|
void SetEffectTimeout(unsigned timeout);
|
|
|
|
/**
|
|
Add a new page and show it immediately.
|
|
|
|
This is simply a thin wrapper around the base class
|
|
wxBookCtrlBase::AddPage() method using empty label (which is unused by
|
|
this class anyhow) and selecting the new page immediately.
|
|
*/
|
|
bool ShowNewPage(wxWindow* page);
|
|
};
|