/////////////////////////////////////////////////////////////////////////////
-// Name: msw/notebook.h
+// Name: wx/msw/notebook.h
// Purpose: MSW/GTK compatible notebook (a.k.a. property sheet)
// Author: Robert Roebling
// Modified by: Vadim Zeitlin for Windows version
// RCS-ID: $Id$
-// Copyright: (c) Julian Smart and Markus Holzem
-// Licence: wxWindows license
+// Copyright: (c) Julian Smart
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef _NOTEBOOK_H
#define _NOTEBOOK_H
-#ifdef __GNUG__
- #pragma interface "notebook.h"
-#endif
-
#if wxUSE_NOTEBOOK
// ----------------------------------------------------------------------------
// wxNotebook
// ----------------------------------------------------------------------------
-class WXDLLEXPORT wxNotebook : public wxNotebookBase
+class WXDLLIMPEXP_CORE wxNotebook : public wxNotebookBase
{
public:
// ctors
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
- const wxString& name = "notebook");
+ const wxString& name = wxNotebookNameStr);
// Create() function
bool Create(wxWindow *parent,
wxWindowID id,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
- const wxString& name = "notebook");
+ const wxString& name = wxNotebookNameStr);
+ virtual ~wxNotebook();
// accessors
// ---------
// get number of pages in the dialog
- int GetPageCount() const;
+ virtual size_t GetPageCount() const;
// set the currently selected page, return the index of the previously
- // selected one (or -1 on error)
+ // selected one (or wxNOT_FOUND on error)
// NB: this function will _not_ generate wxEVT_NOTEBOOK_PAGE_xxx events
- int SetSelection(int nPage);
- // get the currently selected page
- int GetSelection() const { return m_nSelection; }
+ int SetSelection(size_t nPage);
+
+ // changes selected page without sending events
+ int ChangeSelection(size_t nPage);
// set/get the title of a page
- bool SetPageText(int nPage, const wxString& strText);
- wxString GetPageText(int nPage) const;
+ bool SetPageText(size_t nPage, const wxString& strText);
+ wxString GetPageText(size_t nPage) const;
// image list stuff: each page may have an image associated with it. All
// the images belong to an image list, so you have to
void SetImageList(wxImageList* imageList);
// sets/returns item's image index in the current image list
- int GetPageImage(int nPage) const;
- bool SetPageImage(int nPage, int nImage);
+ int GetPageImage(size_t nPage) const;
+ bool SetPageImage(size_t nPage, int nImage);
// currently it's always 1 because wxGTK doesn't support multi-row
// tab controls
// ----------
// remove all pages
bool DeleteAllPages();
- // adds a new page to the notebook (it will be deleted ny the notebook,
+
+ // inserts a new page to the notebook (it will be deleted ny the notebook,
// don't delete it yourself). If bSelect, this page becomes active.
- bool AddPage(wxNotebookPage *pPage,
- const wxString& strText,
- bool bSelect = FALSE,
- int imageId = -1);
- // the same as AddPage(), but adds it at the specified position
- bool InsertPage(int nPage,
+ bool InsertPage(size_t nPage,
wxNotebookPage *pPage,
const wxString& strText,
- bool bSelect = FALSE,
+ bool bSelect = false,
int imageId = -1);
// Windows-only at present. Also, you must use the wxNB_FIXEDWIDTH
// style.
void SetTabSize(const wxSize& sz);
+ // hit test
+ virtual int HitTest(const wxPoint& pt, long *flags = NULL) const;
+
+ // calculate the size of the notebook from the size of its page
+ virtual wxSize CalcSizeFromPage(const wxSize& sizePage) const;
+
// callbacks
// ---------
void OnSize(wxSizeEvent& event);
- void OnSelChange(wxNotebookEvent& event);
- void OnSetFocus(wxFocusEvent& event);
void OnNavigationKey(wxNavigationKeyEvent& event);
// base class virtuals
// -------------------
+
virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
virtual bool MSWOnScroll(int orientation, WXWORD nSBCode,
WXWORD pos, WXHWND control);
- virtual void SetConstraintSizes(bool recurse = TRUE);
+
+#if wxUSE_CONSTRAINTS
+ virtual void SetConstraintSizes(bool recurse = true);
virtual bool DoPhase(int nPhase);
+#endif // wxUSE_CONSTRAINTS
+
+ // Attempts to get colour for UX theme page background
+ wxColour GetThemeBackgroundColour() const;
+
+ // implementation only
+ // -------------------
+
+#if wxUSE_UXTHEME
+ virtual bool SetBackgroundColour(const wxColour& colour)
+ {
+ if ( !wxNotebookBase::SetBackgroundColour(colour) )
+ return false;
+
+ UpdateBgBrush();
+
+ return true;
+ }
+
+ // draw child background
+ virtual bool MSWPrintChild(WXHDC hDC, wxWindow *win);
+
+ virtual bool MSWHasInheritableBackground() const { return true; }
+#endif // wxUSE_UXTHEME
+
+ // translate wxWin styles to the Windows ones
+ virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle = NULL) const;
protected:
// common part of all ctors
void Init();
- // translate wxWin styles to the Windows ones
- virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle = NULL) const;
+ // hides the currently shown page and shows the given one (if not -1) and
+ // updates m_selection accordingly
+ void UpdateSelection(int selNew);
// remove one page from the notebook, without deleting
- virtual wxNotebookPage *DoRemovePage(int nPage);
+ virtual wxNotebookPage *DoRemovePage(size_t nPage);
+
+ // get the page rectangle for the current notebook size
+ //
+ // returns empty rectangle if an error occurs, do test for it
+ wxRect GetPageSize() const;
+
+ // set the size of the given page to fit in the notebook
+ void AdjustPageSize(wxNotebookPage *page);
+
+#if wxUSE_UXTHEME
+ // return the themed brush for painting our children
+ virtual WXHBRUSH MSWGetCustomBgBrush() { return m_hbrBackground; }
+
+ // gets the bitmap of notebook background and returns a brush from it
+ WXHBRUSH QueryBgBitmap();
+
+ // creates the brush to be used for drawing the tab control background
+ void UpdateBgBrush();
+
+ // common part of QueryBgBitmap() and MSWPrintChild()
+ //
+ // if child == NULL, draw background for the entire notebook itself
+ bool DoDrawBackground(WXHDC hDC, wxWindow *child = NULL);
+#endif // wxUSE_UXTHEME
+
+ // these function are only used for reducing flicker on notebook resize and
+ // we don't need to do this for WinCE
+#ifndef __WXWINCE__
+ void OnEraseBackground(wxEraseEvent& event);
+ void OnPaint(wxPaintEvent& event);
+
+ // true if we have already subclassed our updown control
+ bool m_hasSubclassedUpdown;
+#endif // __WXWINCE__
- // helper functions
- void ChangePage(int nOldSel, int nSel); // change pages
+#if wxUSE_UXTHEME
+ // background brush used to paint the tab control
+ WXHBRUSH m_hbrBackground;
+#endif // wxUSE_UXTHEME
- int m_nSelection; // the current selection (-1 if none)
- DECLARE_DYNAMIC_CLASS(wxNotebook)
+ DECLARE_DYNAMIC_CLASS_NO_COPY(wxNotebook)
DECLARE_EVENT_TABLE()
};