update the text of a read-only combobox (and hence wxChoice) when selection is change...

[wxWidgets.git] / wxPython / src / _srchctrl.i

diff --git a/wxPython/src/_srchctrl.i b/wxPython/src/_srchctrl.i
index 13516b6a50df2b38d140852ba055d96ee1d38223..894b8a49a6352f836e659e9cc5573ff3bd4f24df 100644 (file)
--- a/wxPython/src/_srchctrl.i
+++ b/wxPython/src/_srchctrl.i
@@ -12,17 +12,100 @@
 
 // Not a %module
 
 
 // Not a %module
 

-%{
-#include <wx/srchctrl.h>
-%}
-

 //---------------------------------------------------------------------------
 %newgroup
 
 MAKE_CONST_WXSTRING(SearchCtrlNameStr);
 
 
 //---------------------------------------------------------------------------
 %newgroup
 
 MAKE_CONST_WXSTRING(SearchCtrlNameStr);
 
 

+%{
+#if !defined(wxUSE_SEARCHCTRL) || !wxUSE_SEARCHCTRL
+// define a dummy class for builds that don't have wxSearchCtrl
+
+enum {
+    wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN,
+    wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN
+};
+
+class wxSearchCtrl : public wxTextCtrl
+{
+public:
+    wxSearchCtrl() { wxPyRaiseNotImplemented(); }
+    wxSearchCtrl(wxWindow*, wxWindowID,
+                 const wxString&,
+                 const wxPoint&,
+                 const wxSize&,
+                 long style,
+                 const wxValidator&,
+                 const wxString& name)
+    { wxPyRaiseNotImplemented(); }
+
+    bool Create( wxWindow*, wxWindowID,
+                 const wxString&,
+                 const wxPoint&,
+                 const wxSize&,
+                 long style,
+                 const wxValidator&,
+                 const wxString& name) {}
+        
+    virtual void SetMenu( wxMenu* ) {}
+    virtual wxMenu* GetMenu() { return NULL; }
+    
+    // get/set search options
+    // ----------------------
+    virtual void ShowSearchButton( bool ) {}
+    virtual bool IsSearchButtonVisible() const { return false; }
+
+    virtual void ShowCancelButton( bool ) {}
+    virtual bool IsCancelButtonVisible() const { return false; }
+
+    virtual void SetDescriptiveText(const wxString& text);
+    virtual wxString GetDescriptiveText() const;
+};    
+#endif
+%}
+
+
+
+// Now define the class for SWIG
+

 MustHaveApp(wxSearchCtrl);
 MustHaveApp(wxSearchCtrl);

+DocStr(wxSearchCtrl,
+"A search control is a composite of a `wx.TextCtrl` with optional
+bitmap buttons and a drop-down menu.  Controls like this can typically
+be found on a toolbar of applications that support some form of search
+functionality.  On the Mac this control is implemented using the
+native HISearchField control, on the other platforms a generic control
+is used, although that may change in the future as more platforms
+introduce native search widgets.
+
+If you wish to use a drop-down menu with your wx.SearchCtrl then you
+will need to manage its content and handle the menu events yourself,
+but this is an easy thing to do.  Simply build the menu, pass it to
+`SetMenu`, and also bind a handler for a range of EVT_MENU events.
+This gives you the flexibility to use the drop-down menu however you
+wish, such as for a history of searches, or as a way to select
+different kinds of searches.  The ToolBar.py sample in the demo shows
+one way to do this.
+
+Since the control derives from `wx.TextCtrl` it is convenient to use
+the styles and events designed for `wx.TextCtrl`.  For example you can
+use the ``wx.TE_PROCESS_ENTER`` style and catch the
+``wx.EVT_TEXT_ENTER`` event to know when the user has pressed the
+Enter key in the control and wishes to start a search.
+", "
+
+Events
+-------
+    =========================    =========================================
+    EVT_SEARCHCTRL_SEARCH_BTN    Sent when the search icon is clicked
+    EVT_SEARCHCTRL_CANCEL_BTN    Sent when the cancel icon is clicked
+    EVT_TEXT                     Sent when the text changes
+    EVT_TEXT_ENTER               Sent when the RETURN/ENTER key is pressed 
+                                 in the search control and the control has
+                                 the wx.TE_PROCESS_ENTER style flag set.
+    =========================    =========================================
+");

 
 
 class wxSearchCtrl : public wxTextCtrl
 
 
 class wxSearchCtrl : public wxTextCtrl


@@ -32,12 +115,12 @@ public:
     %pythonAppend wxSearchCtrl()       "";
 
     wxSearchCtrl(wxWindow *parent, wxWindowID id=-1,
     %pythonAppend wxSearchCtrl()       "";
 
     wxSearchCtrl(wxWindow *parent, wxWindowID id=-1,

-               const wxString& value = wxEmptyString,
-               const wxPoint& pos = wxDefaultPosition,
-               const wxSize& size = wxDefaultSize,
-               long style = 0,
-               const wxValidator& validator = wxDefaultValidator,
-               const wxString& name = wxPySearchCtrlNameStr);
+                 const wxString& value = wxEmptyString,
+                 const wxPoint& pos = wxDefaultPosition,
+                 const wxSize& size = wxDefaultSize,
+                 long style = 0,
+                 const wxValidator& validator = wxDefaultValidator,
+                 const wxString& name = wxPySearchCtrlNameStr);

 
     DocCtorStrName(
         wxSearchCtrl(),
 
     DocCtorStrName(
         wxSearchCtrl(),


@@ -53,19 +136,63 @@ public:
                 const wxString& name = wxPySearchCtrlNameStr);
 
 
                 const wxString& name = wxPySearchCtrlNameStr);
 
 

-    // get/set search button menu
-    // --------------------------
-    virtual void SetMenu( wxMenu* menu );
-    virtual wxMenu* GetMenu();
+    DocDeclStr(
+        virtual void , SetMenu( wxMenu* menu ),
+        "Sets the search control's menu object. If there is already a menu
+associated with the search control it is deleted.", "");

     
     

-    // get/set search options
-    // ----------------------
-    virtual void SetSearchButtonVisible( bool show );
-    virtual bool GetSearchButtonVisible() const;
+    DocDeclStr(
+        virtual wxMenu* , GetMenu(),
+        "Returns a pointer to the search control's menu object or None if there
+is no menu attached.", "");

 
 

-    virtual void SetCancelButtonVisible( bool show );
-    virtual bool GetCancelButtonVisible() const;
+    
+    
+    DocDeclStr(
+        virtual void , ShowSearchButton( bool show ),
+        "Sets the search button visibility value on the search control. If
+there is a menu attached, the search button will be visible regardless
+of the search button visibility value.  This has no effect in Mac OS X
+v10.3", "");
+    
+    DocDeclStr(
+        virtual bool , IsSearchButtonVisible() const,
+        "Returns the search button visibility value. If there is a menu
+attached, the search button will be visible regardless of the search
+button visibility value.  This always returns false in Mac OS X v10.3", "");
+    
+    DocDeclStr(
+        virtual void , ShowCancelButton( bool show ),
+        "Shows or hides the cancel button.", "");
+    
+    DocDeclStr(
+        virtual bool , IsCancelButtonVisible() const,
+        "Indicates whether the cancel button is visible. ", "");
+    
+
+    DocDeclStr(
+        virtual void , SetDescriptiveText(const wxString& text),
+        "Set the text to be displayed when the user has not yet typed anything
+in the control.", "");
+    
+    DocDeclStr(
+        virtual wxString , GetDescriptiveText() const,
+        "Get the text to be displayed when the user has not yet typed anything
+in the control.", "");
+    
+    
+    DocStr(SetSearchBitmap,
+           "Sets the bitmap to use for the search button.  This currently does not
+work on the Mac.", "");
+    DocStr(SetSearchMenuBitmap,
+           "Sets the bitmap to use for the search button when there is a drop-down
+menu associated with the search control.  This currently does not work
+on the Mac.", "");
+    DocStr(SetCancelBitmap,
+           "Sets the bitmap to use for the cancel button.  This currently does not
+work on the Mac.", "");

 
 

+    

 #ifdef __WXMAC__
     %extend {
         void SetSearchBitmap( const wxBitmap& ) {}
 #ifdef __WXMAC__
     %extend {
         void SetSearchBitmap( const wxBitmap& ) {}


@@ -80,19 +207,20 @@ public:
     
     
     %property(Menu, GetMenu, SetMenu);
     
     
     %property(Menu, GetMenu, SetMenu);

-    %property(SearchButtonVisible, GetSearchButtonVisible, SetSearchButtonVisible);
-    %property(CancelButtonVisible, GetCancelButtonVisible, SetCancelButtonVisible);
+    %property(SearchButtonVisible, IsSearchButtonVisible, ShowSearchButton);
+    %property(CancelButtonVisible, IsCancelButtonVisible, ShowCancelButton);
+    %property(DescriptiveText, GetDescriptiveText, SetDescriptiveText);

 };
      
 
 
 
 };
      
 
 
 

-%constant wxEventType wxEVT_COMMAND_SEARCHCTRL_CANCEL;
-%constant wxEventType wxEVT_COMMAND_SEARCHCTRL_SEARCH;
+%constant wxEventType wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN;
+%constant wxEventType wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN;

 
 %pythoncode {
 
 %pythoncode {

-    EVT_SEARCHCTRL_CANCEL = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_CANCEL, 1)
-    EVT_SEARCHCTRL_SEARCH = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_SEARCH, 1)
+    EVT_SEARCHCTRL_CANCEL_BTN = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN, 1)
+    EVT_SEARCHCTRL_SEARCH_BTN = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN, 1)

 }
 
 //---------------------------------------------------------------------------
 }
 
 //---------------------------------------------------------------------------