wxPython/src/_cmndlgs.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _cmndlgs.i
   3 // Purpose:     SWIG interface for the "Common Dialog" classes
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     25-July-1998
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2003 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 // Not a %module
  14
  15
  16 //---------------------------------------------------------------------------
  17 %newgroup
  18
  19 MAKE_CONST_WXSTRING(FileSelectorPromptStr);
  20 MAKE_CONST_WXSTRING(DirSelectorPromptStr);
  21 MAKE_CONST_WXSTRING(DirDialogNameStr);
  22 MAKE_CONST_WXSTRING(FileSelectorDefaultWildcardStr);
  23 MAKE_CONST_WXSTRING(GetTextFromUserPromptStr);
  24 MAKE_CONST_WXSTRING(MessageBoxCaptionStr);
  25
  26 //---------------------------------------------------------------------------
  27
  28
  29 DocStr(wxColourData,
  30        "This class holds a variety of information related to colour dialogs.");
  31
  32 class wxColourData : public wxObject {
  33 public:
  34     DocCtorStr(
  35         wxColourData(),
  36         "Constructor, sets default values.");
  37
  38     ~wxColourData();
  39
  40
  41     DocDeclStr(
  42         bool , GetChooseFull(),
  43         "Under Windows, determines whether the Windows colour dialog will display\n"
  44         "the full dialog with custom colour selection controls. Has no meaning\n"
  45         "under other platforms.  The default value is true.");
  46
  47     DocDeclStr(
  48         wxColour , GetColour(),
  49         "Gets the colour (pre)selected by the dialog.");
  50
  51     DocDeclStr(
  52         wxColour , GetCustomColour(int i),
  53         "Gets the i'th custom colour associated with the colour dialog. i should\n"
  54         "be an integer between 0 and 15. The default custom colours are all white.");
  55
  56     DocDeclStr(
  57         void , SetChooseFull(int flag),
  58         "Under Windows, tells the Windows colour dialog to display the full dialog\n"
  59         "with custom colour selection controls. Under other platforms, has no effect.\n"
  60         "The default value is true.");
  61
  62     DocDeclStr(
  63         void , SetColour(const wxColour& colour),
  64         "Sets the default colour for the colour dialog.  The default colour is black.");
  65
  66     DocDeclStr(
  67         void , SetCustomColour(int i, const wxColour& colour),
  68         "Sets the i'th custom colour for the colour dialog. i should be an integer\n"
  69         "between 0 and 15. The default custom colours are all white.");
  70
  71 };
  72
  73
  74 DocStr(wxColourDialog,
  75        "This class represents the colour chooser dialog.");
  76
  77 class wxColourDialog : public wxDialog {
  78 public:
  79     %pythonAppend wxColourDialog   "self._setOORInfo(self)"
  80
  81    DocCtorStr(
  82        wxColourDialog(wxWindow* parent, wxColourData* data = NULL),
  83        "Constructor. Pass a parent window, and optionally a ColourData, which\n"
  84        "will be copied to the colour dialog's internal ColourData instance.");
  85
  86     DocDeclStr(
  87         wxColourData& , GetColourData(),
  88         "Returns a reference to the ColourData used by the dialog.");
  89 };
  90
  91
  92 //--------------------------------------------------------------------------------
  93
  94
  95 DocStr(wxDirDialog,
  96        "This class represents the directory chooser dialog.");
  97
  98 RefDoc(wxDirDialog, "
  99  Styles
 100     wxDD_NEW_DIR_BUTTON     Add \"Create new directory\" button and allow
 101                             directory names to be editable. On Windows the new
 102                             directory button is only available with recent
 103                             versions of the common dialogs.");
 104
 105 class wxDirDialog : public wxDialog {
 106 public:
 107     %pythonAppend wxDirDialog   "self._setOORInfo(self)"
 108
 109     DocCtorStr(
 110         wxDirDialog(wxWindow* parent,
 111                     const wxString& message = wxPyDirSelectorPromptStr,
 112                     const wxString& defaultPath = wxPyEmptyString,
 113                     long style = 0,
 114                     const wxPoint& pos = wxDefaultPosition,
 115                     const wxSize& size = wxDefaultSize,
 116                     const wxString& name = wxPyDirDialogNameStr),
 117         "Constructor.  Use ShowModal method to show the dialog.");
 118
 119
 120     DocDeclStr(
 121         wxString , GetPath(),
 122         "Returns the default or user-selected path.");
 123
 124     DocDeclStr(
 125         wxString , GetMessage(),
 126         "Returns the message that will be displayed on the dialog.");
 127
 128     DocDeclStr(
 129         long , GetStyle(),
 130         "Returns the dialog style.");
 131
 132     DocDeclStr(
 133         void , SetMessage(const wxString& message),
 134         "Sets the message that will be displayed on the dialog.");
 135
 136     DocDeclStr(
 137         void , SetPath(const wxString& path),
 138         "Sets the default path.");
 139
 140 };
 141
 142
 143 //---------------------------------------------------------------------------
 144
 145 DocStr(wxFileDialog,
 146        "This class represents the file chooser dialog.");
 147
 148 RefDoc(wxFileDialog, "
 149 In Windows, this is the common file selector dialog. In X, this is a file
 150 selector box with somewhat less functionality. The path and filename are
 151 distinct elements of a full file pathname. If path is \"\", the current
 152 directory will be used. If filename is \"\", no default filename will be
 153 supplied. The wildcard determines what files are displayed in the file
 154 selector, and file extension supplies a type extension for the required
 155 filename.
 156
 157 Both the X and Windows versions implement a wildcard filter. Typing a filename
 158 containing wildcards (*, ?) in the filename text item, and clicking on Ok,
 159 will result in only those files matching the pattern being displayed. The
 160 wildcard may be a specification for multiple types of file with a description
 161 for each, such as:
 162
 163    \"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif\"
 164
 165  Styles
 166     wx.OPEN              This is an open dialog.
 167
 168     wx.SAVE              This is a save dialog.
 169
 170     wx.HIDE_READONLY     For open dialog only: hide the checkbox allowing to
 171                          open the file in read-only mode.
 172
 173     wx.OVERWRITE_PROMPT  For save dialog only: prompt for a confirmation if a
 174                          file will be overwritten.
 175
 176     wx.MULTIPLE          For open dialog only: allows selecting multiple files.
 177
 178     wx.CHANGE_DIR        Change the current working directory to the directory
 179                          where the file(s) chosen by the user are.
 180 ");
 181
 182
 183
 184 class wxFileDialog : public wxDialog {
 185 public:
 186     %pythonAppend wxFileDialog   "self._setOORInfo(self)"
 187
 188     DocCtorStr(
 189         wxFileDialog(wxWindow* parent,
 190                      const wxString& message = wxPyFileSelectorPromptStr,
 191                      const wxString& defaultDir = wxPyEmptyString,
 192                      const wxString& defaultFile = wxPyEmptyString,
 193                      const wxString& wildcard = wxPyFileSelectorDefaultWildcardStr,
 194                      long style = 0,
 195                      const wxPoint& pos = wxDefaultPosition),
 196         "Constructor.  Use ShowModal method to show the dialog.");
 197
 198
 199     DocDeclStr(
 200         void , SetMessage(const wxString& message),
 201         "Sets the message that will be displayed on the dialog.");
 202
 203     DocDeclStr(
 204         void , SetPath(const wxString& path),
 205         "Sets the path (the combined directory and filename that will\n"
 206         "be returned when the dialog is dismissed).");
 207
 208     DocDeclStr(
 209         void , SetDirectory(const wxString& dir),
 210         "Sets the default directory.");
 211
 212     DocDeclStr(
 213         void , SetFilename(const wxString& name),
 214         "Sets the default filename.");
 215
 216     DocDeclStr(
 217         void , SetWildcard(const wxString& wildCard),
 218         "Sets the wildcard, which can contain multiple file types, for example:\n"
 219         "    \"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif\"");
 220
 221     DocDeclStr(
 222         void , SetStyle(long style),
 223         "Sets the dialog style.");
 224
 225     DocDeclStr(
 226         void , SetFilterIndex(int filterIndex),
 227         "Sets the default filter index, starting from zero.");
 228
 229
 230     DocDeclStr(
 231         wxString , GetMessage() const,
 232         "Returns the message that will be displayed on the dialog.");
 233
 234     DocDeclStr(
 235         wxString , GetPath() const,
 236         "Returns the full path (directory and filename) of the selected file.");
 237
 238     DocDeclStr(
 239         wxString , GetDirectory() const,
 240         "Returns the default directory.");
 241
 242     DocDeclStr(
 243         wxString , GetFilename() const,
 244         "Returns the default filename.");
 245
 246     DocDeclStr(
 247         wxString , GetWildcard() const,
 248         "Returns the file dialog wildcard.");
 249
 250     DocDeclStr(
 251         long , GetStyle() const,
 252         "Returns the dialog style.");
 253
 254     DocDeclStr(
 255         int , GetFilterIndex() const,
 256         "Returns the index into the list of filters supplied, optionally, in\n"
 257         "the wildcard parameter. Before the dialog is shown, this is the index\n"
 258         "which will be used when the dialog is first displayed. After the dialog\n"
 259         "is shown, this is the index selected by the user.");
 260
 261
 262     DocStr(GetFilenames,
 263         "Returns a list of filenames chosen in the dialog.  This function should\n"
 264         "only be used with the dialogs which have wx.MULTIPLE style, use\n"
 265         "GetFilename for the others.");
 266
 267     DocStr(GetPaths,
 268         "Fills the array paths with the full paths of the files chosen. This\n"
 269         "function should only be used with the dialogs which have wx.MULTIPLE style,\n"
 270         "use GetPath for the others.");
 271
 272     %extend {
 273         PyObject* GetFilenames() {
 274             wxArrayString arr;
 275             self->GetFilenames(arr);
 276             return wxArrayString2PyList_helper(arr);
 277         }
 278
 279         PyObject* GetPaths() {
 280             wxArrayString arr;
 281             self->GetPaths(arr);
 282             return wxArrayString2PyList_helper(arr);
 283         }
 284     }
 285
 286 // TODO
 287 //     // Utility functions
 288
 289 //     // Parses the wildCard, returning the number of filters.
 290 //     // Returns 0 if none or if there's a problem,
 291 //     // The arrays will contain an equal number of items found before the error.
 292 //     // wildCard is in the form:
 293 //     // "All files (*)|*|Image Files (*.jpeg *.png)|*.jpg;*.png"
 294 //     static int ParseWildcard(const wxString& wildCard,
 295 //                              wxArrayString& descriptions,
 296 //                              wxArrayString& filters);
 297
 298 //     // Append first extension to filePath from a ';' separated extensionList
 299 //     // if filePath = "path/foo.bar" just return it as is
 300 //     // if filePath = "foo[.]" and extensionList = "*.jpg;*.png" return "foo.jpg"
 301 //     // if the extension is "*.j?g" (has wildcards) or "jpg" then return filePath
 302 //     static wxString AppendExtension(const wxString &filePath,
 303 //                                     const wxString &extensionList);
 304
 305
 306 };
 307
 308
 309 //---------------------------------------------------------------------------
 310
 311 enum { wxCHOICEDLG_STYLE };
 312
 313
 314 DocStr(wxMultiChoiceDialog,
 315        "A simple dialog with a multi selection listbox.");
 316
 317 class wxMultiChoiceDialog : public wxDialog
 318 {
 319 public:
 320     %pythonAppend wxMultiChoiceDialog   "self._setOORInfo(self)"
 321
 322     DocCtorAStr(
 323         wxMultiChoiceDialog(wxWindow *parent,
 324                             const wxString& message,
 325                             const wxString& caption,
 326                             int choices=0, wxString* choices_array,
 327                             long style = wxCHOICEDLG_STYLE,
 328                             const wxPoint& pos = wxDefaultPosition),
 329         "__init__(Window parent, String message, String caption,\n"
 330         "    List choices=[], long style=CHOICEDLG_STYLE,\n"
 331         "    Point pos=DefaultPosition) -> MultiChoiceDialog",
 332         "Constructor.  Use ShowModal method to show the dialog.");
 333
 334
 335     DocDeclAStr(
 336         void, SetSelections(const wxArrayInt& selections),
 337         "SetSelections(List selections)",
 338         "Specify the items in the list that shoudl be selected, using a list of integers.");
 339
 340     DocAStr(GetSelections,
 341             "GetSelections() -> [selections]",
 342             "Returns a list of integers representing the items that are selected.");
 343     %extend {
 344         PyObject* GetSelections() {
 345             return wxArrayInt2PyList_helper(self->GetSelections());
 346         }
 347     }
 348 };
 349
 350
 351 //---------------------------------------------------------------------------
 352
 353 DocStr(wxSingleChoiceDialog,
 354        "A simple dialog with a single selection listbox.");
 355
 356 class wxSingleChoiceDialog : public wxDialog {
 357 public:
 358     %pythonAppend wxSingleChoiceDialog   "self._setOORInfo(self)"
 359
 360     DocAStr(wxSingleChoiceDialog,
 361             "__init__(Window parent, String message, String caption,\n"
 362             "    List choices=[], long style=CHOICEDLG_STYLE,\n"
 363             "    Point pos=DefaultPosition) -> SingleChoiceDialog",
 364             "Constructor.  Use ShowModal method to show the dialog.");
 365
 366     %extend {
 367         // TODO: ignoring clientData for now...  FIX THIS
 368         //       SWIG is messing up the &/*'s for some reason.
 369         wxSingleChoiceDialog(wxWindow* parent,
 370                              const wxString& message,
 371                              const wxString& caption,
 372                              int choices, wxString* choices_array,
 373                              //char** clientData = NULL,
 374                              long style = wxCHOICEDLG_STYLE,
 375                              const wxPoint& pos = wxDefaultPosition) {
 376             return new wxSingleChoiceDialog(parent, message, caption,
 377                                             choices, choices_array, NULL, style, pos);
 378         }
 379     }
 380
 381     DocDeclStr(
 382         int , GetSelection(),
 383         "Get the index of teh currently selected item.");
 384
 385     DocDeclStr(
 386         wxString , GetStringSelection(),
 387         "Returns the string value of the currently selected item");
 388
 389     DocDeclStr(
 390         void , SetSelection(int sel),
 391         "Set the current selected item to sel");
 392 };
 393
 394
 395 //---------------------------------------------------------------------------
 396
 397 DocStr(wxTextEntryDialog,
 398        "A dialog with text control, [ok] and [cancel] buttons");
 399
 400 class wxTextEntryDialog : public wxDialog {
 401 public:
 402     %pythonAppend wxTextEntryDialog   "self._setOORInfo(self)"
 403
 404     DocCtorStr(
 405         wxTextEntryDialog(wxWindow* parent,
 406                           const wxString& message,
 407                           const wxString& caption = wxPyGetTextFromUserPromptStr,
 408                           const wxString& defaultValue = wxPyEmptyString,
 409                           long style = wxOK | wxCANCEL | wxCENTRE,
 410                           const wxPoint& pos = wxDefaultPosition),
 411         "Constructor.  Use ShowModal method to show the dialog.");
 412
 413     DocDeclStr(
 414         wxString , GetValue(),
 415         "Returns the text that the user has entered if the user has pressed OK,\n"
 416         "or the original value if the user has pressed Cancel.");
 417
 418     DocDeclStr(
 419         void , SetValue(const wxString& value),
 420         "Sets the default text value.");
 421 };
 422
 423 //---------------------------------------------------------------------------
 424
 425
 426 DocStr(wxFontData,
 427        "This class holds a variety of information related to font dialogs.");
 428
 429
 430 class wxFontData : public wxObject {
 431 public:
 432     wxFontData();
 433     ~wxFontData();
 434
 435     DocDeclStr(
 436         void , EnableEffects(bool enable),
 437         "Enables or disables 'effects' under MS Windows only. This refers\n"
 438         "to the controls for manipulating colour, strikeout and underline\n"
 439         "properties.  The default value is true.");
 440
 441     DocDeclStr(
 442         bool , GetAllowSymbols(),
 443         "Under MS Windows, returns a flag determining whether symbol fonts can be\n"
 444         "selected. Has no effect on other platforms. The default value is true.");
 445
 446     DocDeclStr(
 447         wxColour , GetColour(),
 448         "Gets the colour associated with the font dialog. The default value is black.");
 449
 450     DocDeclStr(
 451         wxFont , GetChosenFont(),
 452         "Gets the font chosen by the user.");
 453
 454     DocDeclStr(
 455         bool , GetEnableEffects(),
 456         "Determines whether 'effects' are enabled under Windows.");
 457
 458     DocDeclStr(
 459         wxFont , GetInitialFont(),
 460         "Gets the font that will be initially used by the font dialog. This should have\n"
 461         "previously been set by the application.");
 462
 463     DocDeclStr(
 464         bool , GetShowHelp(),
 465         "Returns true if the Help button will be shown (Windows only).  The default\n"
 466         "value is false.");
 467
 468     DocDeclStr(
 469         void , SetAllowSymbols(bool allowSymbols),
 470         "Under MS Windows, determines whether symbol fonts can be selected. Has no\n"
 471         "effect on other platforms.  The default value is true.");
 472
 473     DocDeclStr(
 474         void , SetChosenFont(const wxFont& font),
 475         "Sets the font that will be returned to the user (for internal use only).");
 476
 477     DocDeclStr(
 478         void , SetColour(const wxColour& colour),
 479         "Sets the colour that will be used for the font foreground colour.  The default\n"
 480         "colour is black.");
 481
 482     DocDeclStr(
 483         void , SetInitialFont(const wxFont& font),
 484         "Sets the font that will be initially used by the font dialog.");
 485
 486     DocDeclStr(
 487         void , SetRange(int min, int max),
 488         "Sets the valid range for the font point size (Windows only).  The default is\n"
 489         "0, 0 (unrestricted range).");
 490
 491     DocDeclStr(
 492         void , SetShowHelp(bool showHelp),
 493         "Determines whether the Help button will be displayed in the font dialog\n"
 494         "(Windows only).  The default value is false.");
 495 };
 496
 497
 498
 499
 500 DocStr(wxFontDialog,
 501        "This class represents the font chooser dialog.");
 502
 503 class wxFontDialog : public wxDialog {
 504 public:
 505     %pythonAppend wxFontDialog   "self._setOORInfo(self)"
 506     %nokwargs wxFontDialog;
 507
 508     DocStr(wxFontDialog,
 509            "Constructor. Pass a parent window, and optionally the font data object to be\n"
 510            "used to initialize the dialog controls.");
 511     wxFontDialog(wxWindow* parent);
 512     wxFontDialog(wxWindow* parent, const wxFontData& data);
 513
 514
 515     DocDeclStr(
 516         wxFontData& , GetFontData(),
 517         "Returns a reference to the internal FontData used by the FontDialog.");
 518 };
 519
 520
 521 //---------------------------------------------------------------------------
 522
 523
 524 DocStr(wxMessageDialog,
 525        "This class provides a dialog that shows a single or multi-line message, with\n"
 526        "a choice of OK, Yes, No and Cancel buttons.");
 527
 528 RefDoc(wxMessageDialog, "
 529   Styles
 530     wx.OK:                Show an OK button.
 531
 532     wx.CANCEL:            Show a Cancel button.
 533
 534     wx.YES_NO:            Show Yes and No buttons.
 535
 536     wx.YES_DEFAULT:       Used with wxYES_NO, makes Yes button the default - which is the default behaviour.
 537
 538     wx.NO_DEFAULT:        Used with wxYES_NO, makes No button the default.
 539
 540     wx.ICON_EXCLAMATION:  Shows an exclamation mark icon.
 541
 542     wx.ICON_HAND:         Shows an error icon.
 543
 544     wx.ICON_ERROR:        Shows an error icon - the same as wxICON_HAND.
 545
 546     wx.ICON_QUESTION:     Shows a question mark icon.
 547
 548     wx.ICON_INFORMATION:  Shows an information (i) icon.
 549
 550     wx.STAY_ON_TOP:       The message box stays on top of all other window, even those of the other applications (Windows only).
 551 ");
 552
 553
 554 class wxMessageDialog : public wxDialog {
 555 public:
 556     %pythonAppend wxMessageDialog   "self._setOORInfo(self)"
 557
 558     wxMessageDialog(wxWindow* parent,
 559                     const wxString& message,
 560                     const wxString& caption = wxPyMessageBoxCaptionStr,
 561                     long style = wxOK | wxCANCEL | wxCENTRE,
 562                     const wxPoint& pos = wxDefaultPosition);
 563
 564 };
 565
 566 //---------------------------------------------------------------------------
 567
 568
 569 DocStr(wxProgressDialog,
 570        "A dialog that shows a short message and a progress bar. Optionally, it can\n"
 571        "display an ABORT button.");
 572
 573 RefDoc(wxProgressDialog, "
 574   Styles
 575
 576     wx.PD_APP_MODAL:            Make the progress dialog modal. If this flag is
 577                                 not given, it is only \"locally\" modal - that is
 578                                 the input to the parent window is disabled,
 579                                 but not to the other ones.
 580
 581     wx.PD_AUTO_HIDE:            Causes the progress dialog to disappear from screen
 582                                 as soon as the maximum value of the progress
 583                                 meter has been reached.
 584
 585     wx.PD_CAN_ABORT:            This flag tells the dialog that it should have
 586                                 a \"Cancel\" button which the user may press. If
 587                                 this happens, the next call to Update() will
 588                                 return false.
 589
 590     wx.PD_ELAPSED_TIME:         This flag tells the dialog that it should show
 591                                 elapsed time (since creating the dialog).
 592
 593     wx.PD_ESTIMATED_TIME:       This flag tells the dialog that it should show
 594                                 estimated time.
 595
 596     wx.PD_REMAINING_TIME:       This flag tells the dialog that it should show
 597                                 remaining time.
 598 ");
 599
 600
 601 class wxProgressDialog : public wxFrame {
 602 public:
 603     %pythonAppend wxProgressDialog   "self._setOORInfo(self)"
 604
 605     DocCtorStr(
 606         wxProgressDialog(const wxString& title,
 607                          const wxString& message,
 608                          int maximum = 100,
 609                          wxWindow* parent = NULL,
 610                          int style = wxPD_AUTO_HIDE | wxPD_APP_MODAL ),
 611         "Constructor. Creates the dialog, displays it and disables user input for other\n"
 612         "windows, or, if wxPD_APP_MODAL flag is not given, for its parent window only.");
 613
 614     DocDeclStr(
 615         bool , Update(int value, const wxString& newmsg = wxPyEmptyString),
 616         "Updates the dialog, setting the progress bar to the new value and, if given\n"
 617         "changes the message above it. Returns true unless the Cancel button has been\n"
 618         "pressed.\n\n"
 619         "If false is returned, the application can either immediately destroy the\n"
 620         "dialog or ask the user for the confirmation and if the abort is not confirmed\n"
 621         "the dialog may be resumed with Resume function.");
 622
 623     DocDeclStr(
 624         void , Resume(),
 625         "Can be used to continue with the dialog, after the user had chosen to abort.");
 626
 627 };
 628
 629 //---------------------------------------------------------------------------
 630
 631 enum wxFindReplaceFlags
 632 {
 633     // downward search/replace selected (otherwise - upwards)
 634     wxFR_DOWN       = 1,
 635
 636     // whole word search/replace selected
 637     wxFR_WHOLEWORD  = 2,
 638
 639     // case sensitive search/replace selected (otherwise - case insensitive)
 640     wxFR_MATCHCASE  = 4
 641 };
 642
 643
 644 enum wxFindReplaceDialogStyles
 645 {
 646     // replace dialog (otherwise find dialog)
 647     wxFR_REPLACEDIALOG = 1,
 648
 649     // don't allow changing the search direction
 650     wxFR_NOUPDOWN      = 2,
 651
 652     // don't allow case sensitive searching
 653     wxFR_NOMATCHCASE   = 4,
 654
 655     // don't allow whole word searching
 656     wxFR_NOWHOLEWORD   = 8
 657 };
 658
 659
 660
 661 %constant wxEventType wxEVT_COMMAND_FIND;
 662 %constant wxEventType wxEVT_COMMAND_FIND_NEXT;
 663 %constant wxEventType wxEVT_COMMAND_FIND_REPLACE;
 664 %constant wxEventType wxEVT_COMMAND_FIND_REPLACE_ALL;
 665 %constant wxEventType wxEVT_COMMAND_FIND_CLOSE;
 666
 667
 668 %pythoncode {
 669 EVT_FIND = wx.PyEventBinder( wxEVT_COMMAND_FIND, 1 )
 670 EVT_FIND_NEXT = wx.PyEventBinder( wxEVT_COMMAND_FIND_NEXT, 1 )
 671 EVT_FIND_REPLACE = wx.PyEventBinder( wxEVT_COMMAND_FIND_REPLACE, 1 )
 672 EVT_FIND_REPLACE_ALL = wx.PyEventBinder( wxEVT_COMMAND_FIND_REPLACE_ALL, 1 )
 673 EVT_FIND_CLOSE = wx.PyEventBinder( wxEVT_COMMAND_FIND_CLOSE, 1 )
 674
 675 %# For backwards compatibility.  Should they be removed?
 676 EVT_COMMAND_FIND             = EVT_FIND
 677 EVT_COMMAND_FIND_NEXT        = EVT_FIND_NEXT
 678 EVT_COMMAND_FIND_REPLACE     = EVT_FIND_REPLACE
 679 EVT_COMMAND_FIND_REPLACE_ALL = EVT_FIND_REPLACE_ALL
 680 EVT_COMMAND_FIND_CLOSE       = EVT_FIND_CLOSE
 681 }
 682
 683
 684 DocStr(wxFindDialogEvent,
 685        "Events for the FindReplaceDialog");
 686
 687 class wxFindDialogEvent : public wxCommandEvent
 688 {
 689 public:
 690     wxFindDialogEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
 691
 692     DocDeclStr(
 693         int , GetFlags(),
 694         "Get the currently selected flags: this is the combination of\n"
 695         "wx.FR_DOWN, wx.FR_WHOLEWORD and wx.FR_MATCHCASE flags.");
 696
 697     DocDeclStr(
 698         const wxString& , GetFindString(),
 699         "Return the string to find (never empty).");
 700
 701     DocDeclStr(
 702         const wxString& , GetReplaceString(),
 703         "Return the string to replace the search string with (only\n"
 704         "for replace and replace all events).");
 705
 706     DocDeclStr(
 707         wxFindReplaceDialog *, GetDialog(),
 708         "Return the pointer to the dialog which generated this event.");
 709
 710     DocDeclStr(
 711         void , SetFlags(int flags),
 712         "");
 713
 714     DocDeclStr(
 715         void , SetFindString(const wxString& str),
 716         "");
 717
 718     DocDeclStr(
 719         void , SetReplaceString(const wxString& str),
 720         "");
 721 };
 722
 723
 724
 725 DocStr(wxFindReplaceData,
 726 "FindReplaceData holds the data for FindReplaceDialog. It is used to initialize
 727 the dialog with the default values and will keep the last values from the
 728 dialog when it is closed. It is also updated each time a wxFindDialogEvent is
 729 generated so instead of using the wxFindDialogEvent methods you can also
 730 directly query this object.
 731
 732 Note that all SetXXX() methods may only be called before showing the dialog
 733 and calling them has no effect later.
 734
 735  Flags
 736     wxFR_DOWN:          downward search/replace selected (otherwise, upwards)
 737
 738     wxFR_WHOLEWORD:     whole word search/replace selected
 739
 740     wxFR_MATCHCASE:     case sensitive search/replace selected (otherwise,
 741                         case insensitive)
 742 ");
 743
 744
 745
 746
 747 class wxFindReplaceData : public wxObject
 748 {
 749 public:
 750     DocCtorStr(
 751         wxFindReplaceData(int flags=0),
 752         "Constuctor initializes the flags to default value (0).");
 753
 754     ~wxFindReplaceData();
 755
 756
 757     DocDeclStr(
 758         const wxString& , GetFindString(),
 759         "Get the string to find.");
 760
 761     DocDeclStr(
 762         const wxString& , GetReplaceString(),
 763         "Get the replacement string.");
 764
 765     DocDeclStr(
 766         int , GetFlags(),
 767         "Get the combination of flag values.");
 768
 769     DocDeclStr(
 770         void , SetFlags(int flags),
 771         "Set the flags to use to initialize the controls of the dialog.");
 772
 773     DocDeclStr(
 774         void , SetFindString(const wxString& str),
 775         "Set the string to find (used as initial value by the dialog).");
 776
 777     DocDeclStr(
 778         void , SetReplaceString(const wxString& str),
 779         "Set the replacement string (used as initial value by the dialog).");
 780
 781 };
 782
 783
 784
 785
 786 DocStr(wxFindReplaceDialog,
 787 "FindReplaceDialog is a standard modeless dialog which is used to allow the
 788 user to search for some text (and possibly replace it with something
 789 else). The actual searching is supposed to be done in the owner window which
 790 is the parent of this dialog. Note that it means that unlike for the other
 791 standard dialogs this one must have a parent window. Also note that there is
 792 no way to use this dialog in a modal way; it is always, by design and
 793 implementation, modeless.");
 794
 795 RefDoc(wxFindReplaceDialog, "
 796  Styles
 797     wx.FR_REPLACEDIALOG:        replace dialog (otherwise find dialog)
 798
 799     wx.FR_NOUPDOWN:             don't allow changing the search direction
 800
 801     wx.FR_NOMATCHCASE:          don't allow case sensitive searching
 802
 803     wx.FR_NOWHOLEWORD:          don't allow whole word searching
 804 ");
 805
 806 class wxFindReplaceDialog : public wxDialog {
 807 public:
 808     %pythonAppend wxFindReplaceDialog     "self._setOORInfo(self)"
 809     %pythonAppend wxFindReplaceDialog()   ""
 810
 811     DocCtorStr(
 812         wxFindReplaceDialog(wxWindow *parent,
 813                             wxFindReplaceData *data,
 814                             const wxString &title,
 815                             int style = 0),
 816         "Create a FindReplaceDialog.  The parent and data parameters must be\n"
 817         "non-None.  Use Show to display the dialog.");
 818
 819     DocCtorStrName(
 820         wxFindReplaceDialog(),
 821         "Precreate a FindReplaceDialog for 2-phase creation",
 822         PreFindReplaceDialog);
 823
 824
 825     DocDeclStr(
 826         bool , Create(wxWindow *parent,
 827                       wxFindReplaceData *data,
 828                       const wxString &title,
 829                       int style = 0),
 830         "Create the dialog, for 2-phase create.");
 831
 832
 833     DocDeclStr(
 834         const wxFindReplaceData *, GetData(),
 835         "Get the FindReplaceData object used by this dialog.");
 836
 837     DocDeclStr(
 838         void , SetData(wxFindReplaceData *data),
 839         "Set the FindReplaceData object used by this dialog.");
 840
 841 };
 842
 843 //---------------------------------------------------------------------------
 844 //---------------------------------------------------------------------------