3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
465 lines
20 KiB
C++
465 lines
20 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/generic/choicdgg.h
|
|
// Purpose: Generic choice dialogs
|
|
// Author: Julian Smart
|
|
// Modified by: 03.11.00: VZ to add wxArrayString and multiple sel functions
|
|
// Created: 01/02/97
|
|
// Copyright: (c) wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_GENERIC_CHOICDGG_H_
|
|
#define _WX_GENERIC_CHOICDGG_H_
|
|
|
|
#include "wx/dynarray.h"
|
|
#include "wx/dialog.h"
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxListBoxBase;
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// some (ugly...) constants
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#define wxCHOICE_HEIGHT 150
|
|
#define wxCHOICE_WIDTH 200
|
|
|
|
#ifdef __WXWINCE__
|
|
#define wxCHOICEDLG_STYLE \
|
|
(wxDEFAULT_DIALOG_STYLE | wxOK | wxCANCEL | wxCENTRE)
|
|
#else
|
|
#define wxCHOICEDLG_STYLE \
|
|
(wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER | wxOK | wxCANCEL | wxCENTRE)
|
|
#endif
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxAnyChoiceDialog: a base class for dialogs containing a listbox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxAnyChoiceDialog : public wxDialog
|
|
{
|
|
public:
|
|
wxAnyChoiceDialog() { }
|
|
|
|
wxAnyChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
long styleDlg = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
long styleLbox = wxLB_ALWAYS_SB)
|
|
{
|
|
(void)Create(parent, message, caption, n, choices,
|
|
styleDlg, pos, styleLbox);
|
|
}
|
|
wxAnyChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
long styleDlg = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
long styleLbox = wxLB_ALWAYS_SB)
|
|
{
|
|
(void)Create(parent, message, caption, choices,
|
|
styleDlg, pos, styleLbox);
|
|
}
|
|
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
long styleDlg = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
long styleLbox = wxLB_ALWAYS_SB);
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
long styleDlg = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
long styleLbox = wxLB_ALWAYS_SB);
|
|
|
|
protected:
|
|
wxListBoxBase *m_listbox;
|
|
|
|
virtual wxListBoxBase *CreateList(int n,
|
|
const wxString *choices,
|
|
long styleLbox);
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxAnyChoiceDialog);
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxSingleChoiceDialog: a dialog with single selection listbox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxSingleChoiceDialog : public wxAnyChoiceDialog
|
|
{
|
|
public:
|
|
wxSingleChoiceDialog()
|
|
{
|
|
m_selection = -1;
|
|
}
|
|
|
|
wxSingleChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
void **clientData = NULL,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
{
|
|
Create(parent, message, caption, n, choices, clientData, style, pos);
|
|
}
|
|
|
|
wxSingleChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
void **clientData = NULL,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
{
|
|
Create(parent, message, caption, choices, clientData, style, pos);
|
|
}
|
|
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
void **clientData = NULL,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition);
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
void **clientData = NULL,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition);
|
|
|
|
void SetSelection(int sel);
|
|
int GetSelection() const { return m_selection; }
|
|
wxString GetStringSelection() const { return m_stringSelection; }
|
|
void* GetSelectionData() const { return m_clientData; }
|
|
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
// Deprecated overloads taking "char**" client data.
|
|
wxDEPRECATED_CONSTRUCTOR
|
|
(
|
|
wxSingleChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
char **clientData,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
)
|
|
{
|
|
Create(parent, message, caption, n, choices,
|
|
(void**)clientData, style, pos);
|
|
}
|
|
|
|
wxDEPRECATED_CONSTRUCTOR
|
|
(
|
|
wxSingleChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
char **clientData,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
)
|
|
{
|
|
Create(parent, message, caption, choices,
|
|
(void**)clientData, style, pos);
|
|
}
|
|
|
|
wxDEPRECATED_INLINE
|
|
(
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
char **clientData,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition),
|
|
return Create(parent, message, caption, n, choices,
|
|
(void**)clientData, style, pos);
|
|
)
|
|
|
|
wxDEPRECATED_INLINE
|
|
(
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
char **clientData,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition),
|
|
return Create(parent, message, caption, choices,
|
|
(void**)clientData, style, pos);
|
|
)
|
|
|
|
// NB: no need to make it return wxChar, it's untyped
|
|
wxDEPRECATED_ACCESSOR
|
|
(
|
|
char* GetSelectionClientData() const,
|
|
(char*)GetSelectionData()
|
|
)
|
|
#endif // WXWIN_COMPATIBILITY_2_8
|
|
|
|
// implementation from now on
|
|
void OnOK(wxCommandEvent& event);
|
|
#ifndef __SMARTPHONE__
|
|
void OnListBoxDClick(wxCommandEvent& event);
|
|
#endif
|
|
#ifdef __WXWINCE__
|
|
void OnJoystickButtonDown(wxJoystickEvent& event);
|
|
#endif
|
|
|
|
protected:
|
|
int m_selection;
|
|
wxString m_stringSelection;
|
|
|
|
void DoChoice();
|
|
|
|
private:
|
|
DECLARE_DYNAMIC_CLASS_NO_COPY(wxSingleChoiceDialog)
|
|
DECLARE_EVENT_TABLE()
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxMultiChoiceDialog: a dialog with multi selection listbox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxMultiChoiceDialog : public wxAnyChoiceDialog
|
|
{
|
|
public:
|
|
wxMultiChoiceDialog() { }
|
|
|
|
wxMultiChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
{
|
|
(void)Create(parent, message, caption, n, choices, style, pos);
|
|
}
|
|
wxMultiChoiceDialog(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition)
|
|
{
|
|
(void)Create(parent, message, caption, choices, style, pos);
|
|
}
|
|
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n,
|
|
const wxString *choices,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition);
|
|
bool Create(wxWindow *parent,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
long style = wxCHOICEDLG_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition);
|
|
|
|
void SetSelections(const wxArrayInt& selections);
|
|
wxArrayInt GetSelections() const { return m_selections; }
|
|
|
|
// implementation from now on
|
|
virtual bool TransferDataFromWindow();
|
|
|
|
protected:
|
|
#if wxUSE_CHECKLISTBOX
|
|
virtual wxListBoxBase *CreateList(int n,
|
|
const wxString *choices,
|
|
long styleLbox);
|
|
#endif // wxUSE_CHECKLISTBOX
|
|
|
|
wxArrayInt m_selections;
|
|
|
|
private:
|
|
DECLARE_DYNAMIC_CLASS_NO_COPY(wxMultiChoiceDialog)
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wrapper functions which can be used to get selection(s) from the user
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// get the user selection as a string
|
|
WXDLLIMPEXP_CORE wxString wxGetSingleChoice(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE wxString wxGetSingleChoice(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE wxString wxGetSingleChoice(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
WXDLLIMPEXP_CORE wxString wxGetSingleChoice(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
// Same as above but gets position in list of strings, instead of string,
|
|
// or -1 if no selection
|
|
WXDLLIMPEXP_CORE int wxGetSingleChoiceIndex(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE int wxGetSingleChoiceIndex(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE int wxGetSingleChoiceIndex(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
WXDLLIMPEXP_CORE int wxGetSingleChoiceIndex(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
// Return client data instead or NULL if canceled
|
|
WXDLLIMPEXP_CORE void* wxGetSingleChoiceData(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
void **client_data,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE void* wxGetSingleChoiceData(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
void **client_data,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT,
|
|
int initialSelection = 0);
|
|
|
|
WXDLLIMPEXP_CORE void* wxGetSingleChoiceData(const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
void **client_data,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
|
|
WXDLLIMPEXP_CORE void* wxGetSingleChoiceData(const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
void **client_data,
|
|
int initialSelection,
|
|
wxWindow *parent = NULL);
|
|
|
|
// fill the array with the indices of the chosen items, it will be empty
|
|
// if no items were selected or Cancel was pressed - return the number of
|
|
// selections or -1 if cancelled
|
|
WXDLLIMPEXP_CORE int wxGetSelectedChoices(wxArrayInt& selections,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT);
|
|
|
|
WXDLLIMPEXP_CORE int wxGetSelectedChoices(wxArrayInt& selections,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT);
|
|
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
// fill the array with the indices of the chosen items, it will be empty
|
|
// if no items were selected or Cancel was pressed - return the number of
|
|
// selections
|
|
wxDEPRECATED( WXDLLIMPEXP_CORE size_t wxGetMultipleChoices(wxArrayInt& selections,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
int n, const wxString *choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT) );
|
|
|
|
wxDEPRECATED( WXDLLIMPEXP_CORE size_t wxGetMultipleChoices(wxArrayInt& selections,
|
|
const wxString& message,
|
|
const wxString& caption,
|
|
const wxArrayString& choices,
|
|
wxWindow *parent = NULL,
|
|
int x = wxDefaultCoord,
|
|
int y = wxDefaultCoord,
|
|
bool centre = true,
|
|
int width = wxCHOICE_WIDTH,
|
|
int height = wxCHOICE_HEIGHT));
|
|
#endif // WXWIN_COMPATIBILITY_2_8
|
|
|
|
#endif // _WX_GENERIC_CHOICDGG_H_
|