|
From: Kevin A. <ka...@us...> - 2004-08-17 22:57:47
|
Update of /cvsroot/pythoncard/PythonCard/docs/html/dialogs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv20523/dialogs Modified Files: alertdialog.html colordialog.html directorydialog.html filedialog.html finddialog.html fontdialog.html messagedialog.html multiplechoicedialog.html scrolledmessagedialog.html singlechoicedialog.html textentrydialog.html Log Message: updated docs for release 0.8 dialog.py Index: alertdialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/alertdialog.html,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** alertdialog.html 3 Aug 2002 18:25:28 -0000 1.1 --- alertdialog.html 17 Aug 2004 19:09:34 -0000 1.2 *************** *** 79,84 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 79,84 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 98,102 **** the following results when the user clicks its only button:<b><br> <br> ! </b>accepted: 1<br> returned: Ok<br> <br> --- 98,102 ---- the following results when the user clicks its only button:<b><br> <br> ! </b>accepted: True<br> returned: Ok<br> <br> Index: textentrydialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/textentrydialog.html,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** textentrydialog.html 15 Aug 2004 17:55:35 -0000 1.2 --- textentrydialog.html 17 Aug 2004 19:09:43 -0000 1.3 *************** *** 53,57 **** </tr> <tr> ! <td valign="top">default<br> </td> <td valign="top">quoted string to be displayed in the text field in --- 53,57 ---- </tr> <tr> ! <td valign="top">defaultText<br> </td> <td valign="top">quoted string to be displayed in the text field in *************** *** 106,115 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> <tr> ! <td valign="top">returned<br> </td> <td valign="top">String containing the label of the --- 106,115 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> <tr> ! <td valign="top">returnedString<br> </td> <td valign="top">String containing the label of the *************** *** 134,139 **** the "OK" button:<b><br> <br> ! </b>accepted: 1<br> ! returned: Ok<br> text: Python<br> <br> --- 134,139 ---- the "OK" button:<b><br> <br> ! </b>accepted: True<br> ! returnedString: Ok<br> text: Python<br> <br> Index: scrolledmessagedialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/scrolledmessagedialog.html,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** scrolledmessagedialog.html 3 Aug 2002 18:25:28 -0000 1.1 --- scrolledmessagedialog.html 17 Aug 2004 19:09:43 -0000 1.2 *************** *** 93,98 **** an OK button, and returns no value in the result variable. It returns "accepted" but since there is no real difference between the user clicking the OK button ! (in which case accepted has a value of 1) or the window's close button (in ! which case accepted has a value of 0), it is of little value.<br> <br> <b>Example:<br> --- 93,98 ---- an OK button, and returns no value in the result variable. It returns "accepted" but since there is no real difference between the user clicking the OK button ! (in which case accepted has a value of True) or the window's close button (in ! which case accepted has a value of False), it is of little value.<br> <br> <b>Example:<br> *************** *** 103,107 **** <br> result:<br> ! accepted: 1<br> <br> <br> --- 103,107 ---- <br> result:<br> ! accepted: True<br> <br> <br> Index: colordialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/colordialog.html,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** colordialog.html 3 Aug 2002 18:25:28 -0000 1.1 --- colordialog.html 17 Aug 2004 19:09:43 -0000 1.2 *************** *** 46,51 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 46,51 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 66,70 **** results:<br> <b><br> ! </b>accepted: 1<br> Color: (64, 128, 128)<br> <br> --- 66,70 ---- results:<br> <b><br> ! </b>accepted: True<br> Color: (64, 128, 128)<br> <br> Index: multiplechoicedialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/multiplechoicedialog.html,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** multiplechoicedialog.html 15 Aug 2004 17:55:35 -0000 1.2 --- multiplechoicedialog.html 17 Aug 2004 19:09:43 -0000 1.3 *************** *** 52,56 **** </tr> <tr> ! <td valign="top">choices<br> </td> <td valign="top">list of strings containing the choices to be presented --- 52,56 ---- </tr> <tr> ! <td valign="top">lst<br> </td> <td valign="top">list of strings containing the choices to be presented *************** *** 86,91 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 86,91 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 106,111 **** results:<b><br> <br> ! </b>accepted: 1<br> ! Selection: ('one', 'three')<br> <br> <br> --- 106,111 ---- results:<b><br> <br> ! </b>accepted: True<br> ! selection: ('one', 'three')<br> <br> <br> Index: filedialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/filedialog.html,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** filedialog.html 8 Apr 2004 21:07:35 -0000 1.4 --- filedialog.html 17 Aug 2004 19:09:43 -0000 1.5 *************** *** 107,116 **** <p>The optional style argument in dialog.fileDialog is generally not used when ! opening a File dialog to save a document because its default settings -- FILE_OPEN ! | FILE_MULTIPLE -- is the generally accepted norm for such dialogs. In creating dialogs for <i>saving</i> files, on the other hand, it is often useful to define a variable (here called "aStyle") which defines more fully how the save process will be managed. For example:</p> ! <p>aStyle = dialog.FILE_SAVE | dialog.FILE_HIDE_READONLY | dialog.FILE_OVERWRITE_PROMPT</p> <p>will create a file save dialog (rather than the default file open), in which read-only files are not shown and an attempt to overwrite an existing file is --- 107,116 ---- <p>The optional style argument in dialog.fileDialog is generally not used when ! opening a File dialog to save a document because its default settings -- wx.OPEN ! | wx.MULTIPLE -- is the generally accepted norm for such dialogs. In creating dialogs for <i>saving</i> files, on the other hand, it is often useful to define a variable (here called "aStyle") which defines more fully how the save process will be managed. For example:</p> ! <p>aStyle = wx.SAVE | wx.HIDE_READONLY | wx.OVERWRITE_PROMPT</p> <p>will create a file save dialog (rather than the default file open), in which read-only files are not shown and an attempt to overwrite an existing file is *************** *** 133,138 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 133,138 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 153,157 **** results:<br> <br> ! accepted: 1<br> paths: ['C:\\pycode\\PythonCard\\setup.py']<br> <br> --- 153,157 ---- results:<br> <br> ! accepted: True<br> paths: ['C:\\pycode\\PythonCard\\setup.py']<br> <br> Index: fontdialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/fontdialog.html,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** fontdialog.html 3 Aug 2002 18:25:28 -0000 1.1 --- fontdialog.html 17 Aug 2004 19:09:43 -0000 1.2 *************** *** 37,47 **** </tr> <tr> ! <td valign="top">OPTIONAL font name<br> </td> <td valign="top">Python dictionary containing a complete font description to be used as the default starting point for the dialog. See description ! of return value of "font" in table below for details. <b>Kevin - This appears ! not to be implemented? If it is, it doesn't seem to work as I've described ! it here.</b><br> </td> </tr> --- 37,45 ---- </tr> <tr> ! <td valign="top">OPTIONAL aFont<br> </td> <td valign="top">Python dictionary containing a complete font description to be used as the default starting point for the dialog. See description ! of return value of "font" in table below for details.<br> </td> </tr> *************** *** 74,79 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 72,77 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 102,108 **** results:<br> <br> ! </b>accepted: 1<br> ! Color: (0, 0, 0)<br> ! Font: {'style': 'bold', 'faceName': 'Arial', 'family': 'sansSerif', 'size': 12}<br> <br> --- 100,106 ---- results:<br> <br> ! </b>accepted: True<br> ! color: (0, 0, 0)<br> ! font: {'style': 'bold', 'faceName': 'Arial', 'family': 'sansSerif', 'size': 12}<br> <br> Index: singlechoicedialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/singlechoicedialog.html,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** singlechoicedialog.html 15 Aug 2004 17:55:35 -0000 1.2 --- singlechoicedialog.html 17 Aug 2004 19:09:43 -0000 1.3 *************** *** 52,56 **** </tr> <tr> ! <td valign="top">options<br> </td> <td valign="top">list of values representing contents of dialog --- 52,56 ---- </tr> <tr> ! <td valign="top">lst<br> </td> <td valign="top">list of values representing contents of dialog *************** *** 87,92 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 87,92 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 107,112 **** results:<b><br> <br> ! </b>accepted: 1<br> ! Selection: three<br> <br> <br> --- 107,112 ---- results:<b><br> <br> ! </b>accepted: True<br> ! selection: three<br> <br> <br> Index: messagedialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/messagedialog.html,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** messagedialog.html 3 Aug 2002 18:25:28 -0000 1.1 --- messagedialog.html 17 Aug 2004 19:09:43 -0000 1.2 *************** *** 39,42 **** --- 39,48 ---- </tr> <tr> + <td valign="top">message<br> + </td> + <td valign="top">quoted string displayed as the message in the dialog<br> + </td> + </tr> + <tr> <td valign="top">title<br> </td> *************** *** 45,54 **** </td> </tr> - <tr> - <td valign="top">message<br> - </td> - <td valign="top">quoted string displayed as the message in the dialog<br> - </td> - </tr> <tr> <td valign="top">OPTIONAL icon<br> --- 51,54 ---- *************** *** 67,70 **** --- 67,71 ---- dialog. By default, PythonCard displays the "OK" and "Cancel" buttons shown in the figure above. See below for details.<br> + <br><b>Note that as of PythonCard 0.8 the fourth and fifth args have been combined, so you should use | (binary or) to join them (e.g. wx.ICON_EXCLAMATION | wx.OK).</b> </td> </tr> *************** *** 93,97 **** </tr> <tr> ! <td valign="top">ICON_EXCLAMATION<br> </td> <td valign="top">Exclamation point<br> --- 94,98 ---- </tr> <tr> ! <td valign="top">wx.ICON_EXCLAMATION<br> </td> <td valign="top">Exclamation point<br> *************** *** 99,103 **** </tr> <tr> ! <td valign="top">ICON_HAND <br> </td> <td valign="top">Hand, or error, icon<br> --- 100,104 ---- </tr> <tr> ! <td valign="top">wx.ICON_HAND <br> </td> <td valign="top">Hand, or error, icon<br> *************** *** 105,109 **** </tr> <tr> ! <td valign="top">ICON_ERROR<br> </td> <td valign="top">Same as ICON_HAND<br> --- 106,110 ---- </tr> <tr> ! <td valign="top">wx.ICON_ERROR<br> </td> <td valign="top">Same as ICON_HAND<br> *************** *** 111,115 **** </tr> <tr> ! <td valign="top">ICON_QUESTION<br> </td> <td valign="top">Question mark<br> --- 112,116 ---- </tr> <tr> ! <td valign="top">wx.ICON_QUESTION<br> </td> <td valign="top">Question mark<br> *************** *** 117,121 **** </tr> <tr> ! <td valign="top">ICON_INFORMATION <br> </td> <td valign="top">Small "i" icon, the default icon<br> --- 118,122 ---- </tr> <tr> ! <td valign="top">wx.ICON_INFORMATION <br> </td> <td valign="top">Small "i" icon, the default icon<br> *************** *** 144,148 **** </tr> <tr> ! <td valign="top">BUTTON_OK<br> </td> <td valign="top">OK Button<br> --- 145,149 ---- </tr> <tr> ! <td valign="top">wx.OK<br> </td> <td valign="top">OK Button<br> *************** *** 150,154 **** </tr> <tr> ! <td valign="top">BUTTON_CANCEL<br> </td> <td valign="top">Cancel Button<br> --- 151,155 ---- </tr> <tr> ! <td valign="top">wx.CANCEL<br> </td> <td valign="top">Cancel Button<br> *************** *** 156,160 **** </tr> <tr> ! <td valign="top">BUTTON_YES_NO<br> </td> <td valign="top">Two buttons, one labeled "Yes" and the other labeled --- 157,161 ---- </tr> <tr> ! <td valign="top">wx.YES_NO<br> </td> <td valign="top">Two buttons, one labeled "Yes" and the other labeled *************** *** 163,167 **** </tr> <tr> ! <td valign="top">BUTTON_YES_DEFAULT<br> </td> <td valign="top">If you supply BUTTON_YES_NO as the button constant, --- 164,168 ---- </tr> <tr> ! <td valign="top">wx.YES_DEFAULT<br> </td> <td valign="top">If you supply BUTTON_YES_NO as the button constant, *************** *** 172,178 **** </tr> <tr> ! <td valign="top">BUTTON_NO_DEFAULT<br> </td> ! <td valign="top">If you supply BUTTON_YES_NO as the button constant, you can optionally include this constant to cause the "No" button to be the default button.<br> --- 173,179 ---- </tr> <tr> ! <td valign="top">wx.NO_DEFAULT<br> </td> ! <td valign="top">If you supply wx.YES_NO as the button constant, you can optionally include this constant to cause the "No" button to be the default button.<br> *************** *** 201,210 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> <tr> ! <td valign="top">selection<br> </td> <td valign="top">string containing 'Ok' or 'Cancel' reflecting --- 202,211 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> <tr> ! <td valign="top">returnedString<br> </td> <td valign="top">string containing 'Ok' or 'Cancel' reflecting *************** *** 221,226 **** following results:<b><br> <br> ! </b>accepted: 1<br> ! returned: Ok<br> <br> <br> --- 222,227 ---- following results:<b><br> <br> ! </b>accepted: True<br> ! returnedString: Ok<br> <br> <br> Index: finddialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/finddialog.html,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** finddialog.html 4 Aug 2002 06:59:52 -0000 1.2 --- finddialog.html 17 Aug 2004 19:09:43 -0000 1.3 *************** *** 63,67 **** <p>Boolean value indicating whether to confine the search to strings that contain the search text as a whole word rather than a substring. ! 1 = search for whole words only; 0 = find all occurrences of the search text</p> </td> --- 63,67 ---- <p>Boolean value indicating whether to confine the search to strings that contain the search text as a whole word rather than a substring. ! True = search for whole words only; False = find all occurrences of the search text</p> </td> *************** *** 74,79 **** <p>Boolean value indicating whether to confine the search to strings that contain the search text exactly as provided including upper ! and lower case letter sensitivity.. 1 = search for exact capitalization ! match; 0 = find all occurrences of the search text</p> </td> </tr> --- 74,79 ---- <p>Boolean value indicating whether to confine the search to strings that contain the search text exactly as provided including upper ! and lower case letter sensitivity.. True = search for exact capitalization ! match; False = find all occurrences of the search text</p> </td> </tr> *************** *** 96,101 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 96,101 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 110,115 **** <td valign="top">wholeWordsOnly<br> </td> ! <td valign="top">1 = user checked "Whole Words Only" checkbox<br> ! 0 = user did not check the checkbox<br> </td> </tr> --- 110,115 ---- <td valign="top">wholeWordsOnly<br> </td> ! <td valign="top">True = user checked "Whole Words Only" checkbox<br> ! False = user did not check the checkbox<br> </td> </tr> *************** *** 117,122 **** <td valign="top">caseSensitive<br> </td> ! <td valign="top">1 = user checked "Case Sensitive" checkbox<br> ! 0 = user did not check the checkbox<br> </td> </tr> --- 117,122 ---- <td valign="top">caseSensitive<br> </td> ! <td valign="top">True = user checked "Case Sensitive" checkbox<br> ! False = user did not check the checkbox<br> </td> </tr> *************** *** 130,137 **** results:<br> <b><br> ! </b>accepted: 1<br> ! Text: PythonCard<br> ! Whole word only: 1<br> ! Case sensitive: 0<br> <br> <br> --- 130,137 ---- results:<br> <b><br> ! </b>accepted: True<br> ! searchText: PythonCard<br> ! wholeWordsOnly: True<br> ! caseSensitive: False<br> <br> <br> Index: directorydialog.html =================================================================== RCS file: /cvsroot/pythoncard/PythonCard/docs/html/dialogs/directorydialog.html,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** directorydialog.html 15 Aug 2002 06:33:08 -0000 1.2 --- directorydialog.html 17 Aug 2004 19:09:43 -0000 1.3 *************** *** 75,81 **** Since the directory parameter is empty, the directory dialog opens at the top level of the directory structure as shown in the figure. To cause the directory ! dialog to open on a directory called, e.g., C:\PYTHON, you would write: ! <p><code>result = dialog.directoryDialog(self, 'Choose a directory', 'c:\python')<br> </code><br> --- 75,81 ---- Since the directory parameter is empty, the directory dialog opens at the top level of the directory structure as shown in the figure. To cause the directory ! dialog to open on a directory called, e.g., C:\PYTHON23, you would write: ! <p><code>result = dialog.directoryDialog(self, 'Choose a directory', 'C:\\Python23')<br> </code><br> *************** *** 99,104 **** <td valign="top">accepted<br> </td> ! <td valign="top">1 = user clicked OK<br> ! 0 = user clicked Cancel<br> </td> </tr> --- 99,104 ---- <td valign="top">accepted<br> </td> ! <td valign="top">True = user clicked OK<br> ! False = user clicked Cancel<br> </td> </tr> *************** *** 120,125 **** directory called "pycode."<b><br> <br> ! </b>accepted: 1<br> ! path: C:\pycode<br> <br> <br> --- 120,125 ---- directory called "pycode."<b><br> <br> ! </b>accepted: True<br> ! path: C:\\pycode<br> <br> <br> |