// Purpose: interface of wxPanel
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
@remarks By default, a panel has the same colouring as a dialog.
+ @beginEventEmissionTable{wxNavigationKeyEvent}
+ @event{EVT_NAVIGATION_KEY(func)}
+ Process a navigation key event.
+ @endEventTable
+
@library{wxbase}
@category{miscwnd}
@param id
An identifier for the panel. @c wxID_ANY is taken to mean a default.
@param pos
- The panel position. The value @c wxDefaultPosition indicates a default position,
+ The panel position. The value ::wxDefaultPosition indicates a default position,
chosen by either the windowing system or wxWidgets, depending on platform.
@param size
- The panel size. The value @c wxDefaultSize indicates a default size, chosen by
+ The panel size. The value ::wxDefaultSize indicates a default size, chosen by
either the windowing system or wxWidgets, depending on platform.
@param style
The window style. See wxPanel.
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = wxTAB_TRAVERSAL,
- const wxString& name = "panel");
+ const wxString& name = wxPanelNameStr);
/**
Destructor. Deletes any child windows before deleting the physical window.
virtual void InitDialog();
/**
- The default handler for wxEVT_SYS_COLOUR_CHANGED.
+ See wxWindow::SetAutoLayout(): when auto layout is on, this function gets
+ called automatically when the window is resized.
+ */
+ virtual bool Layout();
+
+ /**
+ The default handler for @c wxEVT_SYS_COLOUR_CHANGED.
@param event
The colour change event.
*/
void OnSysColourChanged(wxSysColourChangedEvent& event);
+ /**
+ Set the background bitmap for this panel.
+
+ If @a bmp is a valid bitmap, this bitmap will be tiled over the panel
+ background and show through any of its transparent children. Passing an
+ invalid bitmap reverts to the default background appearance.
+
+ Notice that you must not prevent the base class EVT_ERASE_BACKGROUND
+ handler from running (i.e. not to handle this event yourself) for this
+ to work.
+
+ @since 2.9.2
+ */
+ void SetBackgroundBitmap(const wxBitmap& bmp);
+
/**
Overrides wxWindow::SetFocus().