wxPython/src/_combobox.i

/////////////////////////////////////////////////////////////////////////////
// Name:        _combobox.i
// Purpose:     SWIG interface defs for wxComboBox
//
// Author:      Robin Dunn
//
// Created:     10-June-1998
// RCS-ID:      $Id$
// Copyright:   (c) 2003 by Total Control Software
// Licence:     wxWindows license
/////////////////////////////////////////////////////////////////////////////

// Not a %module


//---------------------------------------------------------------------------

MAKE_CONST_WXSTRING(ComboBoxNameStr);

//---------------------------------------------------------------------------
%newgroup;


DocStr(wxComboBox,
"A combobox is like a combination of an edit control and a
listbox. It can be displayed as static list with editable or
read-only text field; or a drop-down list with text field.

A combobox permits a single selection only. Combobox items are
numbered from zero.", "

Styles
------
    ================    ===============================================
    wx.CB_SIMPLE        Creates a combobox with a permanently
                        displayed list.  Windows only.

    wx.CB_DROPDOWN      Creates a combobox with a drop-down list.

    wx.CB_READONLY      Same as wxCB_DROPDOWN but only the strings
                        specified as the combobox choices can be
                        selected, it is impossible to select
                        (even from a program) a string which is
                        not in the choices list.

    wx.CB_SORT          Sorts the entries in the list alphabetically.
    ================    ===============================================

Events
-------
    ================    ===============================================
    EVT_COMBOBOX        Sent when an item on the list is selected.
                        Note that calling `GetValue` in this handler
                        will return the newly selected value.
    EVT_TEXT            Sent when the combobox text changes.
    EVT_TEXT_ENTER      Sent when the RETURN/ENTER key is pressed in
                        the combobox.
    ================    ===============================================
");


MustHaveApp(wxComboBox);

#ifdef __WXMSW__
class wxComboBox : public wxChoice
#else
class wxComboBox : public wxControl, public wxItemContainer
#endif
{
public:
    %pythonAppend wxComboBox         "self._setOORInfo(self)"
    %pythonAppend wxComboBox()       ""

    DocCtorAStr(
        wxComboBox(wxWindow* parent, wxWindowID id=-1,
                   const wxString& value = wxPyEmptyString,
                   const wxPoint& pos = wxDefaultPosition,
                   const wxSize& size = wxDefaultSize,
                   const wxArrayString& choices = wxPyEmptyStringArray,
                   long style = 0,
                   const wxValidator& validator = wxDefaultValidator,
                   const wxString& name = wxPyComboBoxNameStr),
        "__init__(Window parent, int id, String value=EmptyString,
    Point pos=DefaultPosition, Size size=DefaultSize,
    List choices=[], long style=0, Validator validator=DefaultValidator,
    String name=ComboBoxNameStr) -> ComboBox",
        "Constructor, creates and shows a ComboBox control.", "");

    DocCtorStrName(
        wxComboBox(),
        "Precreate a ComboBox control for 2-phase creation.", "",
        PreComboBox);


    DocDeclAStr(
        bool, Create(wxWindow *parent, wxWindowID id=-1,
                     const wxString& value = wxPyEmptyString,
                     const wxPoint& pos = wxDefaultPosition,
                     const wxSize& size = wxDefaultSize,
                     const wxArrayString& choices = wxPyEmptyStringArray,
                     long style = 0,
                     const wxValidator& validator = wxDefaultValidator,
                     const wxString& name = wxPyChoiceNameStr),
        "Create(Window parent, int id, String value=EmptyString,
    Point pos=DefaultPosition, Size size=DefaultSize,
    List choices=[], long style=0, Validator validator=DefaultValidator,
    String name=ChoiceNameStr) -> bool",
        "Actually create the GUI wxComboBox control for 2-phase creation", "");


    DocDeclStr(
        virtual wxString , GetValue() const,
        "Returns the current value in the combobox text field.", "");

    DocDeclStr(
        virtual void , SetValue(const wxString& value),
        "", "");


    DocDeclStr(
        virtual void , Copy(),
        "Copies the selected text to the clipboard.", "");

    DocDeclStr(
        virtual void , Cut(),
        "Copies the selected text to the clipboard and removes the selection.", "");

    DocDeclStr(
        virtual void , Paste(),
        "Pastes text from the clipboard to the text field.", "");


    DocDeclStr(
        virtual void , SetInsertionPoint(long pos),
        "Sets the insertion point in the combobox text field.", "");

    DocDeclStr(
        virtual long , GetInsertionPoint() const,
        "Returns the insertion point for the combobox's text field.", "");

    DocDeclStr(
        virtual long , GetLastPosition() const,
        "Returns the last position in the combobox text field.", "");

    DocDeclStr(
        virtual void , Replace(long from, long to, const wxString& value),
        "Replaces the text between two positions with the given text, in the
combobox text field.", "");

    DocDeclStr(
        void , SetSelection(int n),
        "Sets the item at index 'n' to be the selected item.", "");

    DocDeclStrName(
        virtual void , SetSelection(long from, long to),
        "Selects the text between the two positions in the combobox text field.", "",
        SetMark);

#ifdef __WXMSW__
    DocDeclAStrName(
        virtual void , GetSelection(long* OUTPUT, long* OUTPUT),
        "GetMark(self) -> (from, to)",
        "Gets the positions of the begining and ending of the selection mark in
the combobox text field.", "",
        GetMark);
#endif

    DocDeclStr(
        bool , SetStringSelection(const wxString& string),
        "Select the item with the specifed string", "");

    DocDeclStr(
        void , SetString(int n, const wxString& string),
        "Set the label for the n'th item (zero based) in the list.", "");

    DocDeclStr(
        virtual void , SetEditable(bool editable),
        "", "");


    DocDeclStr(
        virtual void , SetInsertionPointEnd(),
        "Sets the insertion point at the end of the combobox text field.", "");

    DocDeclStr(
        virtual void , Remove(long from, long to),
        "Removes the text between the two positions in the combobox text field.", "");


    DocDeclStr(
        bool , IsEditable() const,
        "Returns True if the combo is ediatable (not read-only.)", "");


    DocDeclStr(
        void , Undo(),
        "Redoes the last undo in the text field. Windows only.", "");

    DocDeclStr(
        void , Redo(),
        "Undoes the last edit in the text field. Windows only.", "");

    DocDeclStr(
        void , SelectAll(),
        "Select all the text in the combo's text field.", "");


    DocDeclStr(
        bool , CanCopy() const,
        "Returns True if the combobox is editable and there is a text selection
to copy to the clipboard.  Only available on Windows.", "");

    DocDeclStr(
        bool , CanCut() const,
        "Returns True if the combobox is editable and there is a text selection
to copy to the clipboard.  Only available on Windows.", "");

    DocDeclStr(
        bool , CanPaste() const,
        "Returns True if the combobox is editable and there is text on the
clipboard that can be pasted into the text field. Only available on
Windows.", "");

    DocDeclStr(
        bool , CanUndo() const,
        "Returns True if the combobox is editable and the last edit can be
undone.  Only available on Windows.", "");

    DocDeclStr(
        bool , CanRedo() const,
        "Returns True if the combobox is editable and the last undo can be
redone.  Only available on Windows.", "");


    static wxVisualAttributes
    GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
};

//---------------------------------------------------------------------------
Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: _combobox.i
	3	// Purpose: SWIG interface defs for wxComboBox
	4	//
	5	// Author: Robin Dunn
	6	//
	7	// Created: 10-June-1998
	8	// RCS-ID: $Id$
	9	// Copyright: (c) 2003 by Total Control Software
	10	// Licence: wxWindows license
	11	/////////////////////////////////////////////////////////////////////////////
	12
	13	// Not a %module
	14
	15
	16	//---------------------------------------------------------------------------
	17
	18	MAKE_CONST_WXSTRING(ComboBoxNameStr);
	19
	20	//---------------------------------------------------------------------------
	21	%newgroup;
	22
	23
	24	DocStr(wxComboBox,
	25	"A combobox is like a combination of an edit control and a
	26	listbox. It can be displayed as static list with editable or
	27	read-only text field; or a drop-down list with text field.
	28
	29	A combobox permits a single selection only. Combobox items are
	30	numbered from zero.", "
	31
	32	Styles
	33	------
	34	================ ===============================================
	35	wx.CB_SIMPLE Creates a combobox with a permanently
	36	displayed list. Windows only.
	37
	38	wx.CB_DROPDOWN Creates a combobox with a drop-down list.
	39
	40	wx.CB_READONLY Same as wxCB_DROPDOWN but only the strings
	41	specified as the combobox choices can be
	42	selected, it is impossible to select
	43	(even from a program) a string which is
	44	not in the choices list.
	45
	46	wx.CB_SORT Sorts the entries in the list alphabetically.
	47	================ ===============================================
	48
	49	Events
	50	-------
	51	================ ===============================================
	52	EVT_COMBOBOX Sent when an item on the list is selected.
	53	Note that calling `GetValue` in this handler
	54	will return the newly selected value.
	55	EVT_TEXT Sent when the combobox text changes.
	56	EVT_TEXT_ENTER Sent when the RETURN/ENTER key is pressed in
	57	the combobox.
	58	================ ===============================================
	59	");
	60
	61
	62
	63	MustHaveApp(wxComboBox);
	64
	65	#ifdef __WXMSW__
	66	class wxComboBox : public wxChoice
	67	#else
	68	class wxComboBox : public wxControl, public wxItemContainer
	69	#endif
	70	{
	71	public:
	72	%pythonAppend wxComboBox "self._setOORInfo(self)"
	73	%pythonAppend wxComboBox() ""
	74
	75	DocCtorAStr(
	76	wxComboBox(wxWindow* parent, wxWindowID id=-1,
	77	const wxString& value = wxPyEmptyString,
	78	const wxPoint& pos = wxDefaultPosition,
	79	const wxSize& size = wxDefaultSize,
	80	const wxArrayString& choices = wxPyEmptyStringArray,
	81	long style = 0,
	82	const wxValidator& validator = wxDefaultValidator,
	83	const wxString& name = wxPyComboBoxNameStr),
	84	"__init__(Window parent, int id, String value=EmptyString,
	85	Point pos=DefaultPosition, Size size=DefaultSize,
	86	List choices=[], long style=0, Validator validator=DefaultValidator,
	87	String name=ComboBoxNameStr) -> ComboBox",
	88	"Constructor, creates and shows a ComboBox control.", "");
	89
	90	DocCtorStrName(
	91	wxComboBox(),
	92	"Precreate a ComboBox control for 2-phase creation.", "",
	93	PreComboBox);
	94
	95
	96	DocDeclAStr(
	97	bool, Create(wxWindow *parent, wxWindowID id=-1,
	98	const wxString& value = wxPyEmptyString,
	99	const wxPoint& pos = wxDefaultPosition,
	100	const wxSize& size = wxDefaultSize,
	101	const wxArrayString& choices = wxPyEmptyStringArray,
	102	long style = 0,
	103	const wxValidator& validator = wxDefaultValidator,
	104	const wxString& name = wxPyChoiceNameStr),
	105	"Create(Window parent, int id, String value=EmptyString,
	106	Point pos=DefaultPosition, Size size=DefaultSize,
	107	List choices=[], long style=0, Validator validator=DefaultValidator,
	108	String name=ChoiceNameStr) -> bool",
	109	"Actually create the GUI wxComboBox control for 2-phase creation", "");
	110
	111
	112	DocDeclStr(
	113	virtual wxString , GetValue() const,
	114	"Returns the current value in the combobox text field.", "");
	115
	116	DocDeclStr(
	117	virtual void , SetValue(const wxString& value),
	118	"", "");
	119
	120
	121	DocDeclStr(
	122	virtual void , Copy(),
	123	"Copies the selected text to the clipboard.", "");
	124
	125	DocDeclStr(
	126	virtual void , Cut(),
	127	"Copies the selected text to the clipboard and removes the selection.", "");
	128
	129	DocDeclStr(
	130	virtual void , Paste(),
	131	"Pastes text from the clipboard to the text field.", "");
	132
	133
	134	DocDeclStr(
	135	virtual void , SetInsertionPoint(long pos),
	136	"Sets the insertion point in the combobox text field.", "");
	137
	138	DocDeclStr(
	139	virtual long , GetInsertionPoint() const,
	140	"Returns the insertion point for the combobox's text field.", "");
	141
	142	DocDeclStr(
	143	virtual long , GetLastPosition() const,
	144	"Returns the last position in the combobox text field.", "");
	145
	146	DocDeclStr(
	147	virtual void , Replace(long from, long to, const wxString& value),
	148	"Replaces the text between two positions with the given text, in the
	149	combobox text field.", "");
	150
	151	DocDeclStr(
	152	void , SetSelection(int n),
	153	"Sets the item at index 'n' to be the selected item.", "");
	154
	155	DocDeclStrName(
	156	virtual void , SetSelection(long from, long to),
	157	"Selects the text between the two positions in the combobox text field.", "",
	158	SetMark);
	159
	160	#ifdef __WXMSW__
	161	DocDeclAStrName(
	162	virtual void , GetSelection(long* OUTPUT, long* OUTPUT),
	163	"GetMark(self) -> (from, to)",
	164	"Gets the positions of the begining and ending of the selection mark in
	165	the combobox text field.", "",
	166	GetMark);
	167	#endif
	168
	169	DocDeclStr(
	170	bool , SetStringSelection(const wxString& string),
	171	"Select the item with the specifed string", "");
	172
	173	DocDeclStr(
	174	void , SetString(int n, const wxString& string),
	175	"Set the label for the n'th item (zero based) in the list.", "");
	176
	177	DocDeclStr(
	178	virtual void , SetEditable(bool editable),
	179	"", "");
	180
	181
	182	DocDeclStr(
	183	virtual void , SetInsertionPointEnd(),
	184	"Sets the insertion point at the end of the combobox text field.", "");
	185
	186	DocDeclStr(
	187	virtual void , Remove(long from, long to),
	188	"Removes the text between the two positions in the combobox text field.", "");
	189
	190
	191
	192	DocDeclStr(
	193	bool , IsEditable() const,
	194	"Returns True if the combo is ediatable (not read-only.)", "");
	195
	196
	197	DocDeclStr(
	198	void , Undo(),
	199	"Redoes the last undo in the text field. Windows only.", "");
	200
	201	DocDeclStr(
	202	void , Redo(),
	203	"Undoes the last edit in the text field. Windows only.", "");
	204
	205	DocDeclStr(
	206	void , SelectAll(),
	207	"Select all the text in the combo's text field.", "");
	208
	209
	210	DocDeclStr(
	211	bool , CanCopy() const,
	212	"Returns True if the combobox is editable and there is a text selection
	213	to copy to the clipboard. Only available on Windows.", "");
	214
	215	DocDeclStr(
	216	bool , CanCut() const,
	217	"Returns True if the combobox is editable and there is a text selection
	218	to copy to the clipboard. Only available on Windows.", "");
	219
	220	DocDeclStr(
	221	bool , CanPaste() const,
	222	"Returns True if the combobox is editable and there is text on the
	223	clipboard that can be pasted into the text field. Only available on
	224	Windows.", "");
	225
	226	DocDeclStr(
	227	bool , CanUndo() const,
	228	"Returns True if the combobox is editable and the last edit can be
	229	undone. Only available on Windows.", "");
	230
	231	DocDeclStr(
	232	bool , CanRedo() const,
	233	"Returns True if the combobox is editable and the last undo can be
	234	redone. Only available on Windows.", "");
	235
	236
	237
	238	static wxVisualAttributes
	239	GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
	240	};
	241
	242	//---------------------------------------------------------------------------