};
+wxColour wxGetColourFromUser(wxWindow *parent = (wxWindow *)NULL,
+ const wxColour& colInit = wxNullColour,
+ const wxString& caption = wxPyEmptyString);
+
+
//--------------------------------------------------------------------------------
class wxDirDialog : public wxDialog {
public:
%pythonAppend wxDirDialog "self._setOORInfo(self)"
-
+ %pythonAppend wxDirDialog() ""
+
DocCtorStr(
wxDirDialog(wxWindow* parent,
const wxString& message = wxPyDirSelectorPromptStr,
const wxString& name = wxPyDirDialogNameStr),
"Constructor. Use ShowModal method to show the dialog.", "");
+// %RenameCtor(PreDirDialog, wxDirDialog());
+
+// bool Create(wxWindow *parent,
+// const wxString& title = wxDirSelectorPromptStr,
+// const wxString& defaultPath = wxEmptyString,
+// long style = wxDD_DEFAULT_STYLE,
+// const wxPoint& pos = wxDefaultPosition,
+// const wxSize& sz = wxDefaultSize,
+// const wxString& name = wxPyDirDialogNameStr);
DocDeclStr(
wxString , GetPath(),
wxString , GetMessage(),
"Returns the message that will be displayed on the dialog.", "");
- DocDeclStr(
- long , GetStyle(),
- "Returns the dialog style.", "");
-
DocDeclStr(
void , SetMessage(const wxString& message),
"Sets the message that will be displayed on the dialog.", "");
dialog is shown, this is the index selected by the user.", "");
- DocStr(GetFilenames,
- "Returns a list of filenames chosen in the dialog. This function
+ %extend {
+ DocStr(GetFilenames,
+ "Returns a list of filenames chosen in the dialog. This function
should only be used with the dialogs which have wx.MULTIPLE style, use
GetFilename for the others.", "");
-
- DocStr(GetPaths,
- "Fills the array paths with the full paths of the files chosen. This
-function should only be used with the dialogs which have wx.MULTIPLE
-style, use GetPath for the others.", "");
-
- %extend {
PyObject* GetFilenames() {
wxArrayString arr;
self->GetFilenames(arr);
return wxArrayString2PyList_helper(arr);
}
+ DocStr(GetPaths,
+ "Fills the array paths with the full paths of the files chosen. This
+function should only be used with the dialogs which have wx.MULTIPLE
+style, use GetPath for the others.", "");
+
PyObject* GetPaths() {
wxArrayString arr;
self->GetPaths(arr);
int choices=0, wxString* choices_array=NULL,
long style = wxCHOICEDLG_STYLE,
const wxPoint& pos = wxDefaultPosition),
- "__init__(Window parent, String message, String caption,
- List choices=[], long style=CHOICEDLG_STYLE,
+ "__init__(self, Window parent, String message, String caption,
+ List choices=EmptyList, long style=CHOICEDLG_STYLE,
Point pos=DefaultPosition) -> MultiChoiceDialog",
- "Constructor. Use ShowModal method to show the dialog.", "");
+ "Constructor. Use the `ShowModal` method to show the dialog.
+
+ :param parent: The parent window.
+ :param message: Text to display above the list of selections.
+ :param caption: Text to use in the title bar of the dialog.
+ :param choices: A list of strings or unicode objects that the
+ user is allowed to choose from.
+ :param style: Styles to apply to the dialog. The default value is
+ equivallent to wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER|wx.OK|wx.CANCEL|wx.CENTER.
+ :param pos: Where to position the dialog (not used on Windows)
+
+", "");
DocDeclAStr(
void, SetSelections(const wxArrayInt& selections),
"SetSelections(List selections)",
"Specify the items in the list that should be selected, using a list of
-integers.", "");
+integers. The list should specify the indexes of the items that
+should be selected.", "");
DocAStr(GetSelections,
"GetSelections() -> [selections]",
- "Returns a list of integers representing the items that are selected.", "");
+ "Returns a list of integers representing the items that are selected.
+If an item is selected then its index will appear in the list.", "");
%extend {
PyObject* GetSelections() {
return wxArrayInt2PyList_helper(self->GetSelections());
DocAStr(wxSingleChoiceDialog,
"__init__(Window parent, String message, String caption,
- List choices=[], long style=CHOICEDLG_STYLE,
+ List choices=EmptyList, long style=CHOICEDLG_STYLE,
Point pos=DefaultPosition) -> SingleChoiceDialog",
"Constructor. Use ShowModal method to show the dialog.", "");
};
+wxFont wxGetFontFromUser(wxWindow *parent = NULL,
+ const wxFont& fontInit = wxNullFont,
+ const wxString& caption = wxPyEmptyString);
+
+
//---------------------------------------------------------------------------
wx.PD_CAN_ABORT This flag tells the dialog that it should have
a \"Cancel\" button which the user may press. If
this happens, the next call to Update() will
- return false.
+ return False in the first component of its return
+ value.
+
+ wx.PD_CAN_SKIP This flag tells the dialog that it should have a
+ \"Skip\" button which the user may press. If this
+ happens, the next call to Update() will return
+ True in the second component of its return value.
wx.PD_ELAPSED_TIME This flag tells the dialog that it should show
elapsed time (since creating the dialog).
wx.PD_REMAINING_TIME This flag tells the dialog that it should show
remaining time.
+
+ wx.PD_SMOOTH Uses the wx.GA_SMOOTH style on the embedded
+ wx.Gauge widget.
==================== =============================================
");
+// TODO: wxPD_CAN_SKIP
+
MustHaveApp(wxProgressDialog);
class wxProgressDialog : public wxFrame {
for other windows, or, if wx.PD_APP_MODAL flag is not given, for its
parent window only.", "");
- DocDeclStr(
- virtual bool , Update(int value, const wxString& newmsg = wxPyEmptyString),
+ // TODO: support getting the skipped value back in the return value, but
+ // only if style is set. This is so the API doesn't change for existing
+ // users...
+ DocDeclAStr(
+ virtual bool , Update(int value, const wxString& newmsg = wxPyEmptyString,
+ bool *OUTPUT),
+ "Update(self, int value, String newmsg) --> (continue, skip)",
"Updates the dialog, setting the progress bar to the new value and, if
given changes the message above it. The value given should be less
than or equal to the maximum value given to the constructor and the
-dialog is closed if it is equal to the maximum. Returns true unless
-the Cancel button has been pressed.
-
-If false is returned, the application can either immediately destroy
-the dialog or ask the user for the confirmation and if the abort is
-not confirmed the dialog may be resumed with Resume function.", "");
+dialog is closed if it is equal to the maximum. Returns a tuple of
+boolean values, ``(continue, skip)`` where ``continue`` is ``True``
+unless the Cancel button has been pressed, and ``skip`` is ``False``
+unless the Skip button (if any) has been pressed.
+
+If the ``continue`` return value is ``false``, the application can either
+immediately destroy the dialog or ask the user for confirmation, and if the
+abort is not confirmed the dialog may be resumed with `Resume` function.
+", "");
DocDeclStr(
void , Resume(),
projects / wxWidgets.git / blobdiff