// Name: wx/infobar.h
// Purpose: interface of wxInfoBar
// Author: Vadim Zeitlin
-// RCS-ID: $Id$
// Copyright: (c) 2009 Vadim Zeitlin <vadim@wxwidgets.org>
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
void MyFrame::SomeMethod()
{
- m_infoBar->ShowMessage("Something happend", wxICON_INFORMATION);
+ m_infoBar->ShowMessage("Something happened", wxICON_INFORMATION);
}
@endcode
native implementation requires a recent -- as of this writing -- GTK+ 2.18
version.
- @library{wxadv}
+ @library{wxcore}
@category{miscwnd}
@see wxStatusBar, wxMessageDialog
@since 2.9.1
*/
-class wxInfoBar : public wxWindow
+class wxInfoBar : public wxControl
{
public:
/**
The id of the info bar window, usually unused as currently no
events are generated by this class.
*/
- wxInfoBar(wxWindow *parent, wxWindowID winid = wxID_ANY);
+ bool Create(wxWindow *parent, wxWindowID winid = wxID_ANY);
/**
Add a button to be shown in the info bar.
This method hides the window and lays out the parent window to account
for its disappearance (unlike a simple Hide()).
*/
- void Dismiss();
+ virtual void Dismiss();
/**
Remove a button previously added by AddButton().
Either or both of the parameters can be set to wxSHOW_EFFECT_NONE to
disable using effects entirely.
- Notice that if you place the bar at the bottom of the window you should
- reverse the effects used for showing and hiding for better appearance.
+ By default, the info bar uses wxSHOW_EFFECT_SLIDE_TO_BOTTOM effect for
+ showing itself and wxSHOW_EFFECT_SLIDE_TO_TOP for hiding if it is the
+ first element of the containing sizer and reverse effects if it's the
+ last one. If it is neither the first nor the last element, no effect is
+ used to avoid the use of an inappropriate one and this function must be
+ called if an effect is desired.
@param showEffect
- The effect to use when showing the bar. By default,
- wxSHOW_EFFECT_SLIDE_TO_BOTTOM which is appropriate for the bars
- placed at the top of the window.
+ The effect to use when showing the bar.
@param hideEffect
- The effect to use when hiding the bar. By default,
- wxSHOW_EFFECT_SLIDE_TO_TOP which is appropriate for the bars placed
- at the top of the window.
+ The effect to use when hiding the bar.
*/
void SetShowHideEffects(wxShowEffect showEffect, wxShowEffect hideEffect);