typedef long wxTextPos;
class WXDLLIMPEXP_FWD_BASE wxArrayString;
+class WXDLLIMPEXP_FWD_CORE wxTextCompleter;
class WXDLLIMPEXP_FWD_CORE wxTextEntryHintData;
class WXDLLIMPEXP_FWD_CORE wxWindow;
+#include "wx/filefn.h" // for wxFILE and wxDIR only
#include "wx/gdicmn.h" // for wxPoint
// ----------------------------------------------------------------------------
// SetValue() generates a text change event, ChangeValue() doesn't
virtual void SetValue(const wxString& value)
{ DoSetValue(value, SetValue_SendEvent); }
- virtual void ChangeValue(const wxString& value)
- { DoSetValue(value, SetValue_NoEvent); }
+ virtual void ChangeValue(const wxString& value);
// writing text inserts it at the current position replacing any current
// selection, appending always inserts it at the end and doesn't remove any
virtual void SetSelection(long from, long to) = 0;
virtual void SelectAll() { SetSelection(-1, -1); }
+ virtual void SelectNone()
+ { const long pos = GetInsertionPoint(); SetSelection(pos, pos); }
virtual void GetSelection(long *from, long *to) const = 0;
bool HasSelection() const;
virtual wxString GetStringSelection() const;
// these functions allow to auto-complete the text already entered into the
// control using either the given fixed list of strings, the paths from the
- // file system or, in the future, an arbitrary user-defined completer
+ // file system or an arbitrary user-defined completer
//
// they all return true if completion was enabled or false on error (most
// commonly meaning that this functionality is not available under the
// current platform)
- virtual bool AutoComplete(const wxArrayString& WXUNUSED(choices))
- {
- return false;
- }
+ bool AutoComplete(const wxArrayString& choices)
+ { return DoAutoCompleteStrings(choices); }
+
+ bool AutoCompleteFileNames()
+ { return DoAutoCompleteFileNames(wxFILE); }
- virtual bool AutoCompleteFileNames() { return false; }
+ bool AutoCompleteDirectories()
+ { return DoAutoCompleteFileNames(wxDIR); }
+
+ // notice that we take ownership of the pointer and will delete it
+ //
+ // if the pointer is NULL auto-completion is disabled
+ bool AutoComplete(wxTextCompleter *completer)
+ { return DoAutoCompleteCustom(completer); }
// status
// NB: this is public for wxRichTextCtrl use only right now, do not call it
static bool SendTextUpdatedEvent(wxWindow *win);
+ // generate the wxEVT_COMMAND_TEXT_UPDATED event for this window
+ bool SendTextUpdatedEvent()
+ {
+ return SendTextUpdatedEvent(GetEditableWindow());
+ }
+
+
+ // generate the wxEVT_COMMAND_TEXT_UPDATED event for this window if the
+ // events are not currently disabled
+ void SendTextUpdatedEventIfAllowed()
+ {
+ if ( EventsAllowed() )
+ SendTextUpdatedEvent();
+ }
+
// this function is provided solely for the purpose of forwarding text
// change notifications state from one control to another, e.g. it can be
// used by a wxComboBox which derives from wxTextEntry if it delegates all
virtual bool DoSetMargins(const wxPoint& pt);
virtual wxPoint DoGetMargins() const;
+ // the derived classes should override these virtual methods to implement
+ // auto-completion, they do the same thing as their public counterparts but
+ // have different names to allow overriding just one of them without hiding
+ // the other one(s)
+ virtual bool DoAutoCompleteStrings(const wxArrayString& WXUNUSED(choices))
+ { return false; }
+ virtual bool DoAutoCompleteFileNames(int WXUNUSED(flags)) // wxFILE | wxDIR
+ { return false; }
+ virtual bool DoAutoCompleteCustom(wxTextCompleter *completer);
+
// class which should be used to temporarily disable text change events
//
friend class EventsSuppressor;
- // generate the wxEVT_COMMAND_TEXT_UPDATED event for this window
- bool SendTextUpdatedEvent()
- {
- return SendTextUpdatedEvent(GetEditableWindow());
- }
-
- // generate the wxEVT_COMMAND_TEXT_UPDATED event for this window if the
- // events are not currently disabled
- void SendTextUpdatedEventIfAllowed()
- {
- if ( EventsAllowed() )
- SendTextUpdatedEvent();
- }
-
-
private:
// suppress or resume the text changed events generation: don't use these
// functions directly, use EventsSuppressor class above instead
// hint-related stuff, only allocated if/when SetHint() is used
wxTextEntryHintData *m_hintData;
+
+ // It needs to call our Do{Get,Set}Value() to work with the real control
+ // contents.
+ friend class wxTextEntryHintData;
};
#ifdef __WXUNIVERSAL__