X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/697f4a966e71daf9cc88f44c703fba386ad0b0fd..9e9574fe45b176ee74bba8fad7574cf9906145d1:/interface/wx/choicdlg.h diff --git a/interface/wx/choicdlg.h b/interface/wx/choicdlg.h index 239951e4d9..491571798e 100644 --- a/interface/wx/choicdlg.h +++ b/interface/wx/choicdlg.h @@ -2,16 +2,42 @@ // Name: choicdlg.h // Purpose: interface of wx[Multi|Single]ChoiceDialog // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// +/** + Default width of the choice dialog. +*/ +#define wxCHOICE_WIDTH 150 + +/** + Default height of the choice dialog. +*/ +#define wxCHOICE_HEIGHT 200 + +/** + Default style of the choice dialog. + + @remarks wxRESIZE_BORDER is not used under WinCE. +*/ +#define wxCHOICEDLG_STYLE (wxDEFAULT_DIALOG_STYLE | wxOK | wxCANCEL | wxCENTRE | wxRESIZE_BORDER) + + /** @class wxMultiChoiceDialog This class represents a dialog that shows a list of strings, and allows the user to select one or more. + @beginStyleTable + @style{wxOK} + Show an OK button. + @style{wxCANCEL} + Show a Cancel button. + @style{wxCENTRE} + Centre the message. Not Windows. + @endStyleTable + @library{wxbase} @category{cmndlg} @@ -36,31 +62,14 @@ public: An array of strings, or a string list, containing the choices. @param style A dialog style (bitlist) containing flags chosen from standard - dialog style and the ones listed below. The default value is - equivalent to wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER | wxOK | - wxCANCEL | wxCENTRE. + dialog styles and the ones listed in the class documentation. The + default value is equivalent to wxDEFAULT_DIALOG_STYLE | + wxRESIZE_BORDER | wxOK | wxCANCEL | wxCENTRE. @param pos Dialog position. Not Windows. - @beginStyleTable - @style{wxOK} - Show an OK button. - @style{wxCANCEL} - Show a Cancel button. - @style{wxCENTRE} - Centre the message. Not Windows. - @endStyleTable - @remarks Use ShowModal() to show the dialog. - @beginWxPythonOnly - - For Python the two parameters @a n and @a choices are collapsed into a - multi parameter @a choices which is expected to be a Python list of - strings. - - @endWxPythonOnly - @beginWxPerlOnly Not supported by wxPerl. @endWxPerlOnly @@ -83,31 +92,14 @@ public: An array of strings, or a string list, containing the choices. @param style A dialog style (bitlist) containing flags chosen from standard - dialog style and the ones listed below. The default value is - equivalent to wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER | wxOK | - wxCANCEL | wxCENTRE. + dialog styles and the ones listed in the class documentation. The + default value is equivalent to wxDEFAULT_DIALOG_STYLE | + wxRESIZE_BORDER | wxOK | wxCANCEL | wxCENTRE. @param pos Dialog position. Not Windows. - @beginStyleTable - @style{wxOK} - Show an OK button. - @style{wxCANCEL} - Show a Cancel button. - @style{wxCENTRE} - Centre the message. Not Windows. - @endStyleTable - @remarks Use ShowModal() to show the dialog. - @beginWxPythonOnly - - For Python the two parameters @a n and @a choices are collapsed into a - multi parameter @a choices which is expected to be a Python list of - strings. - - @endWxPythonOnly - @beginWxPerlOnly Use an array reference for the @a choices parameter. @endWxPerlOnly @@ -123,7 +115,7 @@ public: /** Returns array with indexes of selected items. */ - wxArrayInt GetSelection() const; + wxArrayInt GetSelections() const; /** Sets selected items from the array of selected items' indexes. @@ -145,6 +137,15 @@ public: user to select one. Double-clicking on a list item is equivalent to single-clicking and then pressing OK. + @beginStyleTable + @style{wxOK} + Show an OK button. + @style{wxCANCEL} + Show a Cancel button. + @style{wxCENTRE} + Centre the message. Not Windows. + @endStyleTable + @library{wxbase} @category{cmndlg} @@ -170,34 +171,17 @@ public: An array of strings, or a string list, containing the choices. @param clientData An array of client data to be associated with the items. See - GetSelectionClientData(). + GetSelectionData(). @param style A dialog style (bitlist) containing flags chosen from standard - dialog styles and the ones listed below. The default value is - equivalent to wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER | wxOK | - wxCANCEL | wxCENTRE. + dialog styles and the ones listed in the class documentation. The + default value is equivalent to wxDEFAULT_DIALOG_STYLE | + wxRESIZE_BORDER | wxOK | wxCANCEL | wxCENTRE. @param pos Dialog position. Not Windows. - @beginStyleTable - @style{wxOK} - Show an OK button. - @style{wxCANCEL} - Show a Cancel button. - @style{wxCENTRE} - Centre the message. Not Windows. - @endStyleTable - @remarks Use ShowModal() to show the dialog. - @beginWxPythonOnly - - For Python the two parameters @a n and @a choices are collapsed into a - multi parameter @a choices which is expected to be a Python list of - strings. - - @endWxPythonOnly - @beginWxPerlOnly Not supported by wxPerl. @endWxPerlOnly @@ -222,34 +206,17 @@ public: An array of strings, or a string list, containing the choices. @param clientData An array of client data to be associated with the items. See - GetSelectionClientData(). + GetSelectionData(). @param style A dialog style (bitlist) containing flags chosen from standard - dialog styles and the ones listed below. The default value is - equivalent to wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER | wxOK | - wxCANCEL | wxCENTRE. + dialog styles and the ones listed in the class documentation. The + default value is equivalent to wxDEFAULT_DIALOG_STYLE | + wxRESIZE_BORDER | wxOK | wxCANCEL | wxCENTRE. @param pos Dialog position. Not Windows. - @beginStyleTable - @style{wxOK} - Show an OK button. - @style{wxCANCEL} - Show a Cancel button. - @style{wxCENTRE} - Centre the message. Not Windows. - @endStyleTable - @remarks Use ShowModal() to show the dialog. - @beginWxPythonOnly - - For Python the two parameters @a n and @a choices are collapsed into a - multi parameter @a choices which is expected to be a Python list of - strings. - - @endWxPythonOnly - @beginWxPerlOnly Use an array reference for the @a choices parameter. @endWxPerlOnly @@ -270,8 +237,10 @@ public: /** Returns the client data associated with the selection. + + @since 2.9.4 */ - char* GetSelectionClientData() const; + void* GetSelectionData() const; /** Returns the selected string. @@ -312,11 +281,11 @@ int wxGetSingleChoiceIndex(const wxString& message, const wxString& caption, const wxArrayString& aChoices, wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200, + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); int wxGetSingleChoiceIndex(const wxString& message, @@ -324,11 +293,11 @@ int wxGetSingleChoiceIndex(const wxString& message, int n, const wxString& choices[], wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200, + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); @@ -372,22 +341,22 @@ wxString wxGetSingleChoice(const wxString& message, const wxString& caption, const wxArrayString& aChoices, wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200 + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); wxString wxGetSingleChoice(const wxString& message, const wxString& caption, int n, const wxString& choices[], wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200 + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); @@ -425,11 +394,11 @@ wxString wxGetSingleChoiceData(const wxString& message, const wxArrayString& aChoices, const wxString& client_data[], wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200 + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); wxString wxGetSingleChoiceData(const wxString& message, @@ -438,11 +407,11 @@ wxString wxGetSingleChoiceData(const wxString& message, const wxString& choices[], const wxString& client_data[], wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200 + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT, int initialSelection = 0); void* wxGetSingleChoiceData(const wxString& message, @@ -492,11 +461,11 @@ int wxGetSelectedChoices(wxArrayInt& selections, const wxString& caption, const wxArrayString& aChoices, wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200); + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT); int wxGetSelectedChoices(wxArrayInt& selections, const wxString& message, @@ -504,11 +473,11 @@ int wxGetSelectedChoices(wxArrayInt& selections, int n, const wxString& choices[], wxWindow* parent = NULL, - int x = -1, - int y = -1, + int x = wxDefaultCoord, + int y = wxDefaultCoord, bool centre = true, - int width = 150, - int height = 200); + int width = wxCHOICE_WIDTH, + int height = wxCHOICE_HEIGHT); //@}