Implement monitoring of file descriptors in wxMotif event loop.

[wxWidgets.git] / interface / wx / propgrid / manager.h

diff --git a/interface/wx/propgrid/manager.h b/interface/wx/propgrid/manager.h
index 7cea50f4fa5f96e3aad694d4525b35df9c89d71f..0391703b0f3ab7238dbdb4d3cafd394c1b525123 100644 (file)
--- a/interface/wx/propgrid/manager.h
+++ b/interface/wx/propgrid/manager.h
@@ -2,22 +2,23 @@
 // Name:        manager.h
 // Purpose:     interface of wxPropertyGridManager
 // Author:      wxWidgets team
 // Name:        manager.h
 // Purpose:     interface of wxPropertyGridManager
 // Author:      wxWidgets team

-// RCS-ID:      $Id:
-// Licence:     wxWindows license
+// RCS-ID:      $Id$
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /////////////////////////////////////////////////////////////////////////////
 

-/** @class wxPropertyGridPage
+/**
+    @class wxPropertyGridPage

 
     Holder of property grid page information. You can subclass this and
     give instance in wxPropertyGridManager::AddPage. It inherits from
     wxEvtHandler and can be used to process events specific to this
     page (id of events will still be same as manager's). If you don't
     want to use it to process all events of the page, you need to
 
     Holder of property grid page information. You can subclass this and
     give instance in wxPropertyGridManager::AddPage. It inherits from
     wxEvtHandler and can be used to process events specific to this
     page (id of events will still be same as manager's). If you don't
     want to use it to process all events of the page, you need to

-    return false in the derived wxPropertyGridPage::IsHandlingAllEvents.
+    return @false in the derived wxPropertyGridPage::IsHandlingAllEvents.

 
     Please note that wxPropertyGridPage lacks many non-const property
 
     Please note that wxPropertyGridPage lacks many non-const property

-    manipulation functions found in wxPropertyGridManager. Please use
-    parent manager (m_manager member variable) when needed.
+    manipulation functions found in wxPropertyGridManager.
+    Please use parent manager (m_manager member variable) when needed.

 
     Please note that most member functions are inherited and as such not
     documented on this page. This means you will probably also want to read
 
     Please note that most member functions are inherited and as such not
     documented on this page. This means you will probably also want to read


@@ -40,8 +41,8 @@ class WXDLLIMPEXP_PROPGRID wxPropertyGridPage : public wxEvtHandler,
                                                 public wxPropertyGridInterface
 {
     friend class wxPropertyGridManager;
                                                 public wxPropertyGridInterface
 {
     friend class wxPropertyGridManager;

-public:

 
 

+public:

     wxPropertyGridPage();
     virtual ~wxPropertyGridPage();
 
     wxPropertyGridPage();
     virtual ~wxPropertyGridPage();
 


@@ -84,10 +85,7 @@ public:
         Returns id of the tool bar item that represents this page on
         wxPropertyGridManager's wxToolBar.
     */
         Returns id of the tool bar item that represents this page on
         wxPropertyGridManager's wxToolBar.
     */

-    int GetToolId() const
-    {
-        return m_id;
-    }
+    int GetToolId() const;

 
     /**
         Do any member initialization in this method.
 
     /**
         Do any member initialization in this method.


@@ -95,13 +93,13 @@ public:
         @remarks - Called every time the page is added into a manager.
                 - You can add properties to the page here.
     */
         @remarks - Called every time the page is added into a manager.
                 - You can add properties to the page here.
     */

-    virtual void Init() {}
+    virtual void Init();

 
     /**
         Return false here to indicate unhandled events should be
         propagated to manager's parent, as normal.
     */
 
     /**
         Return false here to indicate unhandled events should be
         propagated to manager's parent, as normal.
     */

-    virtual bool IsHandlingAllEvents() const { return true; }
+    virtual bool IsHandlingAllEvents() const;

 
     /**
         Called every time page is about to be shown.
 
     /**
         Called every time page is about to be shown.


@@ -114,7 +112,9 @@ public:
     */
     virtual void RefreshProperty( wxPGProperty* p );
 
     */
     virtual void RefreshProperty( wxPGProperty* p );
 

-    /** Sets splitter position on page.
+    /**
+        Sets splitter position on page.
+

         @remarks
         Splitter position cannot exceed grid size, and therefore setting it
         during form creation may fail as initial grid size is often smaller than
         @remarks
         Splitter position cannot exceed grid size, and therefore setting it
         during form creation may fail as initial grid size is often smaller than


@@ -123,13 +123,13 @@ public:
     void SetSplitterPosition( int splitterPos, int col = 0 );
 };
 
     void SetSplitterPosition( int splitterPos, int col = 0 );
 };
 

-// -----------------------------------------------------------------------

 
 

-/** @class wxPropertyGridManager
+/**
+    @class wxPropertyGridManager

 
     wxPropertyGridManager is an efficient multi-page version of wxPropertyGrid,
 
     wxPropertyGridManager is an efficient multi-page version of wxPropertyGrid,

-    which can optionally have toolbar for mode and page selection, and a help text
-    box.
+    which can optionally have toolbar for mode and page selection, a help text
+    box, and a header.

 
     wxPropertyGridManager inherits from wxPropertyGridInterface, and as such
     it has most property manipulation functions. However, only some of them affect
 
     wxPropertyGridManager inherits from wxPropertyGridInterface, and as such
     it has most property manipulation functions. However, only some of them affect


@@ -147,13 +147,12 @@ public:
     acquire the internal grid (GetGrid()) or wxPropertyGridPage object (GetPage()).
 
     wxPropertyGridManager constructor has exact same format as wxPropertyGrid
     acquire the internal grid (GetGrid()) or wxPropertyGridPage object (GetPage()).
 
     wxPropertyGridManager constructor has exact same format as wxPropertyGrid

-    constructor, and basicly accepts same extra window style flags (albeit also
+    constructor, and basically accepts same extra window style flags (albeit also

     has some extra ones).
 
     Here's some example code for creating and populating a wxPropertyGridManager:
 
     @code
     has some extra ones).
 
     Here's some example code for creating and populating a wxPropertyGridManager:
 
     @code

-

         wxPropertyGridManager* pgMan = new wxPropertyGridManager(this, PGID,
             wxDefaultPosition, wxDefaultSize,
             // These and other similar styles are automatically
         wxPropertyGridManager* pgMan = new wxPropertyGridManager(this, PGID,
             wxDefaultPosition, wxDefaultSize,
             // These and other similar styles are automatically


@@ -171,23 +170,24 @@ public:
 
         wxPropertyGridPage* page;
 
 
         wxPropertyGridPage* page;
 

-        page = pgMan->AddPage(wxT("First Page"));
+        page = pgMan->AddPage("First Page");

 
 

-        page->Append( new wxPropertyCategory(wxT("Category A1")) );
+        page->Append( new wxPropertyCategory("Category A1") );

 
 

-        page->Append( new wxIntProperty(wxT("Number"),wxPG_LABEL,1) );
+        page->Append( new wxIntProperty("Number",wxPG_LABEL,1) );

 
 

-        page->Append( new wxColourProperty(wxT("Colour"),wxPG_LABEL,*wxWHITE) );
+        page->Append( new wxColourProperty("Colour",wxPG_LABEL,*wxWHITE) );

 
 

-        page = pgMan->AddPage(wxT("Second Page"));
+        page = pgMan->AddPage("Second Page");

 
 

-        page->Append( wxT("Text"),wxPG_LABEL,wxT("(no text)") );
+        page->Append( "Text",wxPG_LABEL,"(no text)" );

 
 

-        page->Append( new wxFontProperty(wxT("Font"),wxPG_LABEL) );
+        page->Append( new wxFontProperty("Font",wxPG_LABEL) );

 
 

+        // Display a header above the grid
+        pgMan->ShowHeader();

     @endcode
 
     @endcode
 

-

     @section propgridmanager_window_styles_ Window Styles
 
     See @ref propgrid_window_styles.
     @section propgridmanager_window_styles_ Window Styles
 
     See @ref propgrid_window_styles.


@@ -243,10 +243,7 @@ public:
 
         @return Returns @true if value was actually updated.
     */
 
         @return Returns @true if value was actually updated.
     */

-    bool CommitChangesFromEditor( wxUint32 flags = 0 )
-    {
-        return m_pPropGrid->CommitChangesFromEditor(flags);
-    }
+    bool CommitChangesFromEditor( wxUint32 flags = 0 );

 
     /**
         Two step creation. Whenever the control is created without any parameters,
 
     /**
         Two step creation. Whenever the control is created without any parameters,


@@ -259,7 +256,7 @@ public:
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxPGMAN_DEFAULT_STYLE,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxPGMAN_DEFAULT_STYLE,

-                 const wxChar* name = wxPropertyGridManagerNameStr );
+                 const wxString& name = wxPropertyGridManagerNameStr );

 
     /**
         Enables or disables (shows/hides) categories according to parameter enable.
 
     /**
         Enables or disables (shows/hides) categories according to parameter enable.


@@ -267,13 +264,7 @@ public:
         @remarks
             Calling his may not properly update toolbar buttons.
     */
         @remarks
             Calling his may not properly update toolbar buttons.
     */

-    bool EnableCategories( bool enable )
-    {
-        long fl = m_windowStyle | wxPG_HIDE_CATEGORIES;
-        if ( enable ) fl = m_windowStyle & ~(wxPG_HIDE_CATEGORIES);
-        SetWindowStyleFlag(fl);
-        return true;
-    }
+    bool EnableCategories( bool enable );

 
     /**
         Selects page, scrolls and/or expands items to ensure that the
 
     /**
         Selects page, scrolls and/or expands items to ensure that the


@@ -317,18 +308,12 @@ public:
     /**
         Returns page object for given page index.
     */
     /**
         Returns page object for given page index.
     */

-    wxPropertyGridPage* GetPage( unsigned int ind ) const
-    {
-        return (wxPropertyGridPage*)m_arrPages.Item(ind);
-    }
+    wxPropertyGridPage* GetPage( unsigned int ind ) const;

 
     /**
         Returns page object for given page name.
     */
 
     /**
         Returns page object for given page name.
     */

-    wxPropertyGridPage* GetPage( const wxString& name ) const
-    {
-        return GetPage(GetPageByName(name));
-    }
+    wxPropertyGridPage* GetPage( const wxString& name ) const;

 
     /**
         Returns index for a page name. If no match is found, wxNOT_FOUND is
 
     /**
         Returns index for a page name. If no match is found, wxNOT_FOUND is


@@ -341,7 +326,9 @@ public:
     */
     size_t GetPageCount() const;
 
     */
     size_t GetPageCount() const;
 

-    /** Returns name of given page. */
+    /**
+        Returns name of given page.
+    */

     const wxString& GetPageName( int index ) const;
 
     /**
     const wxString& GetPageName( int index ) const;
 
     /**


@@ -351,24 +338,22 @@ public:
     wxPGProperty* GetPageRoot( int index ) const;
 
     /** Returns index to currently selected page. */
     wxPGProperty* GetPageRoot( int index ) const;
 
     /** Returns index to currently selected page. */

-    int GetSelectedPage() const { return m_selPage; }
+    int GetSelectedPage() const;

 
 

-    /** Shortcut for GetGrid()->GetSelection(). */
-    wxPGProperty* GetSelectedProperty() const
-    {
-        return m_pPropGrid->GetSelection();
-    }
+    /** Alias for GetSelection(). */
+    wxPGProperty* GetSelectedProperty() const;

 
 

-    /** Synonyme for GetSelectedPage. */
-    int GetSelection() const { return m_selPage; }
+    /** Shortcut for GetGrid()->GetSelection(). */
+    wxPGProperty* GetSelection() const;

 
     /**
         Returns a pointer to the toolbar currently associated with the
         wxPropertyGridManager (if any).
     */
 
     /**
         Returns a pointer to the toolbar currently associated with the
         wxPropertyGridManager (if any).
     */

-    wxToolBar* GetToolBar() const { return m_pToolbar; }
+    wxToolBar* GetToolBar() const;

 
 

-    /** Creates new property page. Note that the first page is not created
+    /**
+        Creates new property page. Note that the first page is not created

         automatically.
 
         @param index
         automatically.
 
         @param index


@@ -397,8 +382,7 @@ public:
     bool IsAnyModified() const;
 
     /**
     bool IsAnyModified() const;
 
     /**

-        Returns @true if updating is frozen (ie. Freeze() called but not yet
-        Thaw() ).
+        Returns @true if updating is frozen (ie. Freeze() called but not yet Thaw() ).

     */
     bool IsFrozen() const;
 
     */
     bool IsFrozen() const;
 


@@ -407,13 +391,21 @@ public:
     */
     bool IsPageModified( size_t index ) const;
 
     */
     bool IsPageModified( size_t index ) const;
 

-    /** Removes a page.
+    /**
+        Returns true if property is selected. Since selection is page
+        based, this function checks every page in the manager.
+    */
+    virtual bool IsPropertySelected( wxPGPropArg id ) const;
+
+    /**
+        Removes a page.

 
         @return Returns @false if it was not possible to remove page in question.
     */
     virtual bool RemovePage( int page );
 
 
         @return Returns @false if it was not possible to remove page in question.
     */
     virtual bool RemovePage( int page );
 

-    /** Select and displays a given page.
+    /**
+        Select and displays a given page.

 
         @param index
             Index of page being seleced. Can be -1 to select nothing.
 
         @param index
             Index of page being seleced. Can be -1 to select nothing.


@@ -428,22 +420,42 @@ public:
     /** Select and displays a given page. */
     void SelectPage( wxPropertyGridPage* page );
 
     /** Select and displays a given page. */
     void SelectPage( wxPropertyGridPage* page );
 

-    /** Select a property. */
+    /**
+        Select a property.
+
+        @see wxPropertyGrid::SelectProperty(),
+             wxPropertyGridInterface::ClearSelection()
+    */

     bool SelectProperty( wxPGPropArg id, bool focus = false );
 
     /**
         Sets number of columns on given page (default is current page).
     bool SelectProperty( wxPGPropArg id, bool focus = false );
 
     /**
         Sets number of columns on given page (default is current page).

+
+        @remarks If you use header, then you should always use this
+                 member function to set the column count, instead of
+                 ones present in wxPropertyGrid or wxPropertyGridPage.

     */
     void SetColumnCount( int colCount, int page = -1 );
 
     */
     void SetColumnCount( int colCount, int page = -1 );
 

-    /** Sets label and text in description box.
+    /**
+        Sets a column title. Default title for column 0 is "Property",
+        and "Value" for column 1.
+
+        @remarks If header is not shown yet, then calling this
+                 member function will make it visible.
+    */
+    void SetColumnTitle( int idx, const wxString& title );
+
+    /**
+        Sets label and text in description box.

     */
     void SetDescription( const wxString& label, const wxString& content );
 
     /** Sets y coordinate of the description box splitter. */
     void SetDescBoxHeight( int ht, bool refresh = true );
 
     */
     void SetDescription( const wxString& label, const wxString& content );
 
     /** Sets y coordinate of the description box splitter. */
     void SetDescBoxHeight( int ht, bool refresh = true );
 

-    /** Moves splitter as left as possible, while still allowing all
+    /**
+        Moves splitter as left as possible, while still allowing all

         labels to be shown in full.
 
         @param subProps
         labels to be shown in full.
 
         @param subProps


@@ -455,27 +467,42 @@ public:
     */
     void SetSplitterLeft( bool subProps = false, bool allPages = true );
 
     */
     void SetSplitterLeft( bool subProps = false, bool allPages = true );
 

-    /** Sets splitter position on individual page. */
-    void SetPageSplitterPosition( int page, int pos, int column = 0 )
-    {
-        GetPage(page)->DoSetSplitterPosition( pos, column );
-    }
+    /** Moves splitter as left as possible on an individual page, while still allowing all
+        labels to be shown in full.
+    */
+    void SetPageSplitterLeft(int page, bool subProps = false);
+
+    /**
+        Sets splitter position on individual page.
+
+        @remarks If you use header, then you should always use this
+                 member function to set the splitter position, instead of
+                 ones present in wxPropertyGrid or wxPropertyGridPage.
+    */
+    void SetPageSplitterPosition( int page, int pos, int column = 0 );

 
     /**
         Sets splitter position for all pages.
 
 
     /**
         Sets splitter position for all pages.
 

-        @remarks Splitter position cannot exceed grid size, and therefore setting
-                it during form creation may fail as initial grid size is often
-                smaller than desired splitter position, especially when sizers
-                are being used.
+        @remarks Splitter position cannot exceed grid size, and therefore
+                 setting it during form creation may fail as initial grid
+                 size is often smaller than desired splitter position,
+                 especially when sizers are being used.
+
+                 If you use header, then you should always use this
+                 member function to set the splitter position, instead of
+                 ones present in wxPropertyGrid or wxPropertyGridPage.

     */
     void SetSplitterPosition( int pos, int column = 0 );
 
     */
     void SetSplitterPosition( int pos, int column = 0 );
 

-    /** Synonyme for SelectPage(name). */
-    void SetStringSelection( const wxChar* name )
-    {
-        SelectPage( GetPageByName(name) );
-    }
+    /**
+        Show or hide the property grid header control. It is hidden
+        by the default.
+
+        @remarks Grid may look better if you use wxPG_NO_INTERNAL_BORDER
+                 window style when showing a header.
+    */
+    void ShowHeader(bool show = true);

 
 protected:
 
 
 protected:
 


@@ -484,10 +511,11 @@ protected:
     //
 
     /**
     //
 
     /**

-        Creates property grid for the manager. Override to use subclassed
-        wxPropertyGrid.
+        Creates property grid for the manager. Reimplement in derived class to
+        use subclassed wxPropertyGrid. However, if you do this then you
+        must also use the two-step construction (ie. default constructor and
+        Create() instead of constructor with arguments) when creating the
+        manager.

     */
     virtual wxPropertyGrid* CreatePropertyGrid() const;
 };
     */
     virtual wxPropertyGrid* CreatePropertyGrid() const;
 };

-
-// -----------------------------------------------------------------------