"This class holds a variety of information related to the colour
chooser dialog, used to transfer settings and results to and from the
`wx.ColourDialog`.", "");
-
+
class wxColourData : public wxObject {
public:
DocCtorStr(
wxColourData(),
"Constructor, sets default values.", "");
-
+
~wxColourData();
-
+
DocDeclStr(
bool , GetChooseFull(),
"Under Windows, determines whether the Windows colour dialog will
display the full dialog with custom colour selection controls. Has no
meaning under other platforms. The default value is true.", "");
-
+
DocDeclStr(
wxColour , GetColour(),
"Gets the colour (pre)selected by the dialog.", "");
-
+
DocDeclStr(
wxColour , GetCustomColour(int i),
"Gets the i'th custom colour associated with the colour dialog. i
should be an integer between 0 and 15. The default custom colours are
all invalid colours.", "");
-
+
DocDeclStr(
void , SetChooseFull(int flag),
"Under Windows, tells the Windows colour dialog to display the full
dialog with custom colour selection controls. Under other platforms,
has no effect. The default value is true.", "");
-
+
DocDeclStr(
void , SetColour(const wxColour& colour),
"Sets the default colour for the colour dialog. The default colour is
black.", "");
-
+
DocDeclStr(
void , SetCustomColour(int i, const wxColour& colour),
"Sets the i'th custom colour for the colour dialog. i should be an
integer between 0 and 15. The default custom colours are all invalid colours.", "");
-
+
+
+ %property(ChooseFull, GetChooseFull, SetChooseFull, doc="See `GetChooseFull` and `SetChooseFull`");
+ %property(Colour, GetColour, SetColour, doc="See `GetColour` and `SetColour`");
+ %property(CustomColour, GetCustomColour, SetCustomColour, doc="See `GetCustomColour` and `SetCustomColour`");
+
};
DocDeclStr(
wxColourData& , GetColourData(),
"Returns a reference to the `wx.ColourData` used by the dialog.", "");
+
+ %property(ColourData, GetColourData, doc="See `GetColourData`");
};
//--------------------------------------------------------------------------------
+enum {
+ wxDD_NEW_DIR_BUTTON,
+ wxDD_DEFAULT_STYLE,
+ wxDD_CHANGE_DIR,
+};
DocStr(wxDirDialog,
"wx.DirDialog allows the user to select a directory by browising the
Window Styles
--------------
==================== ==========================================
+ wx.DD_DEFAULT_STYLE Equivalent to a combination of
+ wx.DEFAULT_DIALOG_STYLE, wx.DD_NEW_DIR_BUTTON
+ and wx.RESIZE_BORDER.
+
wx.DD_NEW_DIR_BUTTON Add 'Create new directory' button and allow
directory names to be editable. On Windows
the new directory button is only available
with recent versions of the common dialogs.
+
+ wx.DD_CHANGE_DIR Change the current working directory to the
+ directory chosen by the user.
==================== ==========================================
");
public:
%pythonAppend wxDirDialog "self._setOORInfo(self)"
%pythonAppend wxDirDialog() ""
-
+
DocCtorStr(
wxDirDialog(wxWindow* parent,
const wxString& message = wxPyDirSelectorPromptStr,
const wxString& defaultPath = wxPyEmptyString,
- long style = 0,
+ long style = wxDD_DEFAULT_STYLE,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
const wxString& name = wxPyDirDialogNameStr),
DocDeclStr(
wxString , GetPath(),
"Returns the default or user-selected path.", "");
-
+
DocDeclStr(
wxString , GetMessage(),
"Returns the message that will be displayed on the dialog.", "");
-
+
DocDeclStr(
void , SetMessage(const wxString& message),
"Sets the message that will be displayed on the dialog.", "");
-
+
DocDeclStr(
void , SetPath(const wxString& path),
"Sets the default path.", "");
-
+
+ %property(Message, GetMessage, SetMessage, doc="See `GetMessage` and `SetMessage`");
+ %property(Path, GetPath, SetPath, doc="See `GetPath` and `SetPath`");
};
//---------------------------------------------------------------------------
+%{
+// for compatibility only
+#define wxHIDE_READONLY 0
+%}
+
+enum {
+ // These will dissappear in 2.8
+ wxOPEN,
+ wxSAVE,
+ wxOVERWRITE_PROMPT,
+ wxFILE_MUST_EXIST,
+ wxMULTIPLE,
+ wxCHANGE_DIR,
+ wxHIDE_READONLY,
+
+ wxFD_OPEN,
+ wxFD_SAVE,
+ wxFD_OVERWRITE_PROMPT,
+ wxFD_FILE_MUST_EXIST,
+ wxFD_MULTIPLE,
+ wxFD_CHANGE_DIR,
+ wxFD_PREVIEW,
+ wxFD_DEFAULT_STYLE,
+};
+
DocStr(wxFileDialog,
"wx.FileDialog allows the user to select one or more files from the
filesystem.", "
Window Styles
--------------
- =================== ==========================================
- wx.OPEN This is an open dialog.
+ ====================== ==========================================
+ wx.FD_OPEN This is an open dialog.
- wx.SAVE This is a save dialog.
+ wx.FD_SAVE This is a save dialog.
- wx.HIDE_READONLY For open dialog only: hide the checkbox
- allowing to open the file in read-only mode.
+ wx.FD_OVERWRITE_PROMPT For save dialog only: prompt for a confirmation
+ if a file will be overwritten.
- wx.OVERWRITE_PROMPT For save dialog only: prompt for a confirmation
- if a file will be overwritten.
+ wx.FD_MULTIPLE For open dialog only: allows selecting multiple
+ files.
- wx.MULTIPLE For open dialog only: allows selecting multiple
- files.
-
- wx.CHANGE_DIR Change the current working directory to the
- directory where the file(s) chosen by the user
- are.
- =================== ==========================================
+ wx.FD_CHANGE_DIR Change the current working directory to the
+ directory where the file(s) chosen by the user
+ are.
+ ====================== ==========================================
");
const wxString& defaultDir = wxPyEmptyString,
const wxString& defaultFile = wxPyEmptyString,
const wxString& wildcard = wxPyFileSelectorDefaultWildcardStr,
- long style = 0,
+ long style = wxFD_DEFAULT_STYLE,
const wxPoint& pos = wxDefaultPosition),
"Constructor. Use ShowModal method to show the dialog.", "");
DocDeclStr(
void , SetMessage(const wxString& message),
"Sets the message that will be displayed on the dialog.", "");
-
+
DocDeclStr(
void , SetPath(const wxString& path),
"Sets the path (the combined directory and filename that will be
returned when the dialog is dismissed).", "");
-
+
DocDeclStr(
void , SetDirectory(const wxString& dir),
"Sets the default directory.", "");
-
+
DocDeclStr(
void , SetFilename(const wxString& name),
"Sets the default filename.", "");
-
+
DocDeclStr(
void , SetWildcard(const wxString& wildCard),
"Sets the wildcard, which can contain multiple file types, for
\"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif\"
", "");
-
- DocDeclStr(
- void , SetStyle(long style),
- "Sets the dialog style.", "");
-
+
DocDeclStr(
void , SetFilterIndex(int filterIndex),
"Sets the default filter index, starting from zero.", "");
-
+
DocDeclStr(
wxString , GetMessage() const,
"Returns the message that will be displayed on the dialog.", "");
-
+
DocDeclStr(
wxString , GetPath() const,
"Returns the full path (directory and filename) of the selected file.", "");
-
+
DocDeclStr(
wxString , GetDirectory() const,
"Returns the default directory.", "");
-
+
DocDeclStr(
wxString , GetFilename() const,
"Returns the default filename.", "");
-
+
DocDeclStr(
wxString , GetWildcard() const,
"Returns the file dialog wildcard.", "");
-
- DocDeclStr(
- long , GetStyle() const,
- "Returns the dialog style.", "");
-
+
DocDeclStr(
int , GetFilterIndex() const,
"Returns the index into the list of filters supplied, optionally, in
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.", "");
-
+style, use GetPath for the others.", "");
+
PyObject* GetPaths() {
wxArrayString arr;
self->GetPaths(arr);
// const wxString &extensionList);
+ %property(Directory, GetDirectory, SetDirectory, doc="See `GetDirectory` and `SetDirectory`");
+ %property(Filename, GetFilename, SetFilename, doc="See `GetFilename` and `SetFilename`");
+ %property(Filenames, GetFilenames, doc="See `GetFilenames`");
+ %property(FilterIndex, GetFilterIndex, SetFilterIndex, doc="See `GetFilterIndex` and `SetFilterIndex`");
+ %property(Message, GetMessage, SetMessage, doc="See `GetMessage` and `SetMessage`");
+ %property(Path, GetPath, SetPath, doc="See `GetPath` and `SetPath`");
+ %property(Paths, GetPaths, doc="See `GetPaths`");
+ %property(Wildcard, GetWildcard, SetWildcard, doc="See `GetWildcard` and `SetWildcard`");
+
};
", "");
-
+
DocDeclAStr(
void, SetSelections(const wxArrayInt& selections),
"SetSelections(List selections)",
return wxArrayInt2PyList_helper(self->GetSelections());
}
}
+
+ %property(Selections, GetSelections, SetSelections, doc="See `GetSelections` and `SetSelections`");
};
DocDeclStr(
int , GetSelection(),
- "Get the index of teh currently selected item.", "");
-
+ "Get the index of the currently selected item.", "");
+
DocDeclStr(
wxString , GetStringSelection(),
"Returns the string value of the currently selected item", "");
-
+
DocDeclStr(
void , SetSelection(int sel),
"Set the current selected item to sel", "");
+
+ %property(Selection, GetSelection, SetSelection, doc="See `GetSelection` and `SetSelection`");
+ %property(StringSelection, GetStringSelection, doc="See `GetStringSelection`");
};
wxString , GetValue(),
"Returns the text that the user has entered if the user has pressed OK,
or the original value if the user has pressed Cancel.", "");
-
+
DocDeclStr(
void , SetValue(const wxString& value),
"Sets the default text value.", "");
+
+ %property(Value, GetValue, SetValue, doc="See `GetValue` and `SetValue`");
};
//---------------------------------------------------------------------------
//---------------------------------------------------------------------------
+DocStr( wxNumberEntryDialog,
+"A dialog with spin control, ok and cancel buttons.", "")
+
+MustHaveApp(wxNumberEntryDialog);
+
+class wxNumberEntryDialog : public wxDialog
+{
+public:
+ %pythonAppend wxNumberEntryDialog "self._setOORInfo(self)"
+
+ DocCtorStr(
+ wxNumberEntryDialog(wxWindow *parent,
+ const wxString& message,
+ const wxString& prompt,
+ const wxString& caption,
+ long value, long min, long max,
+ const wxPoint& pos = wxDefaultPosition),
+ "Constructor. Use ShowModal method to show the dialog.", "");
+
+ long GetValue();
+
+ %property(Value, GetValue, doc="See `GetValue`");
+
+};
+
+//---------------------------------------------------------------------------
+
DocStr(wxFontData,
"This class holds a variety of information related to font dialogs and
"Enables or disables 'effects' under MS Windows only. This refers to
the controls for manipulating colour, strikeout and underline
properties. The default value is true.", "");
-
+
DocDeclStr(
bool , GetAllowSymbols(),
"Under MS Windows, returns a flag determining whether symbol fonts can
be selected. Has no effect on other platforms. The default value is
true.", "");
-
+
DocDeclStr(
wxColour , GetColour(),
"Gets the colour associated with the font dialog. The default value is
black.", "");
-
+
DocDeclStr(
wxFont , GetChosenFont(),
"Gets the font chosen by the user.", "");
-
+
DocDeclStr(
bool , GetEnableEffects(),
"Determines whether 'effects' are enabled under Windows.", "");
-
+
DocDeclStr(
wxFont , GetInitialFont(),
"Gets the font that will be initially used by the font dialog. This
should have previously been set by the application.", "");
-
+
DocDeclStr(
bool , GetShowHelp(),
"Returns true if the Help button will be shown (Windows only). The
default value is false.", "");
-
+
DocDeclStr(
void , SetAllowSymbols(bool allowSymbols),
"Under MS Windows, determines whether symbol fonts can be selected. Has
no effect on other platforms. The default value is true.", "");
-
+
DocDeclStr(
void , SetChosenFont(const wxFont& font),
"Sets the font that will be returned to the user (normally for internal
use only).", "");
-
+
DocDeclStr(
void , SetColour(const wxColour& colour),
"Sets the colour that will be used for the font foreground colour. The
default colour is black.", "");
-
+
DocDeclStr(
void , SetInitialFont(const wxFont& font),
"Sets the font that will be initially used by the font dialog.", "");
-
+
DocDeclStr(
void , SetRange(int min, int max),
"Sets the valid range for the font point size (Windows only). The
default is 0, 0 (unrestricted range).", "");
-
+
DocDeclStr(
void , SetShowHelp(bool showHelp),
"Determines whether the Help button will be displayed in the font
dialog (Windows only). The default value is false.", "");
+
+ %property(AllowSymbols, GetAllowSymbols, SetAllowSymbols, doc="See `GetAllowSymbols` and `SetAllowSymbols`");
+ %property(ChosenFont, GetChosenFont, SetChosenFont, doc="See `GetChosenFont` and `SetChosenFont`");
+ %property(Colour, GetColour, SetColour, doc="See `GetColour` and `SetColour`");
+ %property(EnableEffects, GetEnableEffects, doc="See `GetEnableEffects`");
+ %property(InitialFont, GetInitialFont, SetInitialFont, doc="See `GetInitialFont` and `SetInitialFont`");
+ %property(ShowHelp, GetShowHelp, SetShowHelp, doc="See `GetShowHelp` and `SetShowHelp`");
+
};
results with via the `wx.FontData` returned by `GetFontData`.", "");
wxFontDialog(wxWindow* parent, const wxFontData& data);
-
+
DocDeclStr(
wxFontData& , GetFontData(),
"Returns a reference to the internal `wx.FontData` used by the
-wx.FontDialog.", "");
+wx.FontDialog.", "");
+
+ %property(FontData, GetFontData, doc="See `GetFontData`");
};
class wxMessageDialog : public wxDialog {
public:
%pythonAppend wxMessageDialog "self._setOORInfo(self)"
-
+
DocCtorStr(
wxMessageDialog(wxWindow* parent,
const wxString& message,
//---------------------------------------------------------------------------
+enum {
+ wxPD_AUTO_HIDE,
+ wxPD_APP_MODAL,
+ wxPD_CAN_ABORT,
+ wxPD_ELAPSED_TIME,
+ wxPD_ESTIMATED_TIME,
+ wxPD_REMAINING_TIME,
+ wxPD_SMOOTH,
+ wxPD_CAN_SKIP
+};
+
DocStr(wxProgressDialog,
"A dialog that shows a short message and a progress bar. Optionally, it
// 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,
+ 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
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
+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.
", "");
+
+
+ DocDeclAStr(
+ virtual bool , UpdatePulse(const wxString& newmsg = wxPyEmptyString,
+ bool *OUTPUT),
+ "UpdatePulse(self, String newmsg) --> (continue, skip)",
+ "Just like `Update` but switches the dialog to use a gauge in
+interminante mode and calls `wx.Gauge.Pulse` to show the user a bit of
+progress.", "");
+
DocDeclStr(
void , Resume(),
"Can be used to continue with the dialog, after the user had chosen to
abort.", "");
-
+
};
//---------------------------------------------------------------------------
EVT_FIND_CLOSE = wx.PyEventBinder( wxEVT_COMMAND_FIND_CLOSE, 1 )
%# For backwards compatibility. Should they be removed?
-EVT_COMMAND_FIND = EVT_FIND
+EVT_COMMAND_FIND = EVT_FIND
EVT_COMMAND_FIND_NEXT = EVT_FIND_NEXT
EVT_COMMAND_FIND_REPLACE = EVT_FIND_REPLACE
EVT_COMMAND_FIND_REPLACE_ALL = EVT_FIND_REPLACE_ALL
-EVT_COMMAND_FIND_CLOSE = EVT_FIND_CLOSE
+EVT_COMMAND_FIND_CLOSE = EVT_FIND_CLOSE
}
{
public:
wxFindDialogEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
-
+
DocDeclStr(
int , GetFlags(),
"Get the currently selected flags: this is the combination of
wx.FR_DOWN, wx.FR_WHOLEWORD and wx.FR_MATCHCASE flags.", "");
-
+
DocDeclStr(
const wxString& , GetFindString(),
"Return the string to find (never empty).", "");
-
+
DocDeclStr(
const wxString& , GetReplaceString(),
"Return the string to replace the search string with (only for replace
and replace all events).", "");
-
+
DocDeclStr(
wxFindReplaceDialog *, GetDialog(),
"Return the pointer to the dialog which generated this event.", "");
-
+
DocDeclStr(
void , SetFlags(int flags),
"", "");
-
+
DocDeclStr(
void , SetFindString(const wxString& str),
"", "");
-
+
DocDeclStr(
void , SetReplaceString(const wxString& str),
"", "");
+
+ %property(Dialog, GetDialog, doc="See `GetDialog`");
+ %property(FindString, GetFindString, SetFindString, doc="See `GetFindString` and `SetFindString`");
+ %property(Flags, GetFlags, SetFlags, doc="See `GetFlags` and `SetFlags`");
+ %property(ReplaceString, GetReplaceString, SetReplaceString, doc="See `GetReplaceString` and `SetReplaceString`");
};
-DocStr(wxFindReplaceData,
+DocStr(wxFindReplaceData,
"wx.FindReplaceData holds the data for wx.FindReplaceDialog. It is used
to initialize the dialog with the default values and will keep the
last values from the dialog when it is closed. It is also updated each
Flags
-----
- ================ ===============================================
+ ================ ===============================================
wx.FR_DOWN Downward search/replace selected (otherwise,
upwards)
wx.FR_MATCHCASE Case sensitive search/replace selected
(otherwise, case insensitive)
- ================ ===============================================
+ ================ ===============================================
");
DocCtorStr(
wxFindReplaceData(int flags=0),
"Constuctor initializes the flags to default value (0).", "");
-
+
~wxFindReplaceData();
-
+
DocDeclStr(
const wxString& , GetFindString(),
"Get the string to find.", "");
-
+
DocDeclStr(
const wxString& , GetReplaceString(),
"Get the replacement string.", "");
-
+
DocDeclStr(
int , GetFlags(),
"Get the combination of flag values.", "");
-
+
DocDeclStr(
void , SetFlags(int flags),
"Set the flags to use to initialize the controls of the dialog.", "");
-
+
DocDeclStr(
void , SetFindString(const wxString& str),
"Set the string to find (used as initial value by the dialog).", "");
-
+
DocDeclStr(
void , SetReplaceString(const wxString& str),
"Set the replacement string (used as initial value by the dialog).", "");
-
+
+ %property(FindString, GetFindString, SetFindString, doc="See `GetFindString` and `SetFindString`");
+ %property(Flags, GetFlags, SetFlags, doc="See `GetFlags` and `SetFlags`");
+ %property(ReplaceString, GetReplaceString, SetReplaceString, doc="See `GetReplaceString` and `SetReplaceString`");
};
"Precreate a FindReplaceDialog for 2-phase creation", "",
PreFindReplaceDialog);
-
+
DocDeclStr(
bool , Create(wxWindow *parent, wxFindReplaceData *data,
const wxString &title, int style = 0),
"Create the dialog, for 2-phase create.", "");
-
+
DocDeclStr(
const wxFindReplaceData *, GetData(),
"Get the FindReplaceData object used by this dialog.", "");
-
+
DocDeclStr(
void , SetData(wxFindReplaceData *data),
"Set the FindReplaceData object used by this dialog.", "");
-
+
+ %property(Data, GetData, SetData, doc="See `GetData` and `SetData`");
};
//---------------------------------------------------------------------------
projects / wxWidgets.git / blobdiff