add support for persistent controls

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@58529 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/persist/bookctrl.h

@@ -0,0 +1,47 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        wx/persist/bookctrl.h
+// Purpose:     interface of wxPersistentBookCtrl
+// Author:      Vadim Zeitlin
+// RCS-ID:      $Id$
+// Copyright:   (c) 2009 Vadim Zeitlin <vadim@wxwidgets.org>
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+    Persistence adapter for wxBookCtrlBase.
+
+    This adapter handles the selected page of wxBookCtrlBase, i.e. it saves its
+    value when the associated book control is destroyed and restores it when it
+    is recreated.
+
+    @see wxPersistentTreeBookCtrl
+ */
+class wxPersistentBookCtrl : public wxPersistentWindow<wxBookCtrlBase>
+{
+public:
+    /**
+        Constructor.
+
+        @param book
+            The associated book control.
+     */
+    wxPersistentBookCtrl(wxBookCtrlBase *book);
+
+    /**
+        Save the currently selected page index.
+     */
+    virtual void Save() const;
+
+    /**
+        Restore the selected page index.
+
+        The book control must be initialized before calling this function, i.e.
+        all of its pages should be already added to it -- otherwise restoring
+        the selection has no effect.
+     */
+    virtual bool Restore();
+};
+
+/// Overload allowing persistence adapter creation for wxBookCtrlBase-derived
+/// objects.
+wxPersistentObject *wxCreatePersistentObject(wxBookCtrlBase *book);