fsleyes_widgets.autotextctrl
¶
This module provides the AutoTextCtrl
class, an alternative to the
wx.TextCtrl
, which has auto-completion capability.
I wrote this class because wx.TextCtrl
auto-completion does not work under
OSX, and the wx.ComboBox
does not give me enough fine-grained control with
respect to managing focus.
-
class
fsleyes_widgets.autotextctrl.
AutoTextCtrl
(parent, style=0, modal=True)[source]¶ Bases:
wx._core.Panel
The
AutoTextCtrl
class is essentially awx.TextCtrl
which is able to dynamically show a list of options to the user, with aAutoCompletePopup
.Create an
AutoTextCtrl
. Supported style flags are:ATC_CASE_SENSITIVE
: restrict the auto-completion options to case sensitive matches.ATC_NO_PROPAGATE_ENTER
: Cause enter events on theAutoCompletePopup
to not be propagated upwards asEVT_ATC_TEXT_ENTER
events.
- Parameters
parent – The
wx
parent object.style – Style flags.
modal – If
True
(the default), theAutoCompletePopup
is shoown modally. This option is primarily for testing purposes.
-
property
textCtrl
¶ Returns a reference to the internal
wx.TextCtrl
.
-
property
popup
¶ Returns a reference to the
AutoCompletePopup
orNone
if it is not currently shown.
-
SetValue
(value)[source]¶ Sets the current value shown on this
AutoTextCtrl
.Note
Calling this method will result in an
wx.EVT_TEXT
event being generated - useChangeValue()
if you do not want this to occur.
-
GenEnterEvent
()[source]¶ Programmatically generates an
EVT_ATC_TEXT_ENTER
event.
-
fsleyes_widgets.autotextctrl.
ATC_CASE_SENSITIVE
= 1¶ Syle flag for use with the
AutoTextCtrl
class. If set, the auto-completion pattern matching will be case sensitive.
-
fsleyes_widgets.autotextctrl.
ATC_NO_PROPAGATE_ENTER
= 2¶ Syle flag for use with the
AutoTextCtrl
class. If set, enter events which occur on theAutoCompletePopup
list will not be propagated asEVT_ATC_TEXT_ENTER
events.
-
fsleyes_widgets.autotextctrl.
EVT_ATC_TEXT_ENTER
= <wx.core.PyEventBinder object>¶ Identifier for the
AutoTextCtrlEnterEvent
, which is generated when the user presses enter in anAutoTextCtrl
.
-
fsleyes_widgets.autotextctrl.
AutoTextCtrlEnterEvent
¶ alias of
wx.lib.newevent.NewEvent.<locals>._Event
-
class
fsleyes_widgets.autotextctrl.
AutoCompletePopup
(parent, atc, text, options, style=0)[source]¶ Bases:
wx._core.Dialog
The
AutoCompletePopup
class is used by theAutoTextCtrl
to display a list of completion options to the user.Create an
AutoCompletePopup
. Accepts the same style flags as theAutoTextCtrl
.- Parameters
parent – The
wx
parent object.atc – The
AutoTextCtrl
that is using this popup.text – Initial text value.
options – A list of all possible auto-completion options.
style – Style flags.
-
property
textCtrl
¶ Returns a reference to the
wx.TextCtrl
.
-
property
listBox
¶ Returns a reference to the
wx.ListBox
.
-
fsleyes_widgets.autotextctrl.
EVT_ATC_POPUP_DESTROY
= <wx.core.PyEventBinder object>¶ Identifier for the
ATCPopupDestroyEvent
.
-
fsleyes_widgets.autotextctrl.
ATCPopupDestroyEvent
¶ alias of
wx.lib.newevent.NewEvent.<locals>._Event