]>
Commit | Line | Data |
---|---|---|
69a05ef6 VZ |
1 | /////////////////////////////////////////////////////////////////////////////// |
2 | // Name: src/msw/textentry.cpp | |
3 | // Purpose: wxTextEntry implementation for wxMSW | |
4 | // Author: Vadim Zeitlin | |
5 | // Created: 2007-09-26 | |
69a05ef6 VZ |
6 | // Copyright: (c) 2007 Vadim Zeitlin <vadim@wxwindows.org> |
7 | // Licence: wxWindows licence | |
8 | /////////////////////////////////////////////////////////////////////////////// | |
9 | ||
10 | // ============================================================================ | |
11 | // declarations | |
12 | // ============================================================================ | |
13 | ||
14 | // ---------------------------------------------------------------------------- | |
15 | // headers | |
16 | // ---------------------------------------------------------------------------- | |
17 | ||
18 | // for compilers that support precompilation, includes "wx.h". | |
19 | #include "wx/wxprec.h" | |
20 | ||
21 | #ifdef __BORLANDC__ | |
22 | #pragma hdrstop | |
23 | #endif | |
24 | ||
25 | #ifndef WX_PRECOMP | |
96506d1d | 26 | #include "wx/arrstr.h" |
c0ae6c3b | 27 | #include "wx/string.h" |
69a05ef6 VZ |
28 | #endif // WX_PRECOMP |
29 | ||
96a4cdeb VZ |
30 | #if wxUSE_TEXTCTRL || wxUSE_COMBOBOX |
31 | ||
69a05ef6 | 32 | #include "wx/textentry.h" |
ea98f11c | 33 | #include "wx/textcompleter.h" |
59396417 | 34 | #include "wx/dynlib.h" |
69a05ef6 VZ |
35 | |
36 | #include "wx/msw/private.h" | |
37 | ||
63f7d502 VZ |
38 | #if wxUSE_UXTHEME |
39 | #include "wx/msw/uxtheme.h" | |
40 | #endif | |
41 | ||
69a05ef6 VZ |
42 | #define GetEditHwnd() ((HWND)(GetEditHWND())) |
43 | ||
0847dca6 | 44 | // ---------------------------------------------------------------------------- |
e71e4c93 | 45 | // Classes used by auto-completion implementation. |
0847dca6 VZ |
46 | // ---------------------------------------------------------------------------- |
47 | ||
fd873451 VZ |
48 | // standard VC6 SDK (WINVER == 0x0400) does not know about IAutoComplete |
49 | #if wxUSE_OLE && (WINVER >= 0x0500) | |
50 | #define HAS_AUTOCOMPLETE | |
51 | #endif | |
52 | ||
53 | #ifdef HAS_AUTOCOMPLETE | |
0847dca6 VZ |
54 | |
55 | #include "wx/msw/ole/oleutils.h" | |
56 | #include <shldisp.h> | |
57 | ||
715e4f7e | 58 | #if defined(__MINGW32__) || defined (__WATCOMC__) || defined(__CYGWIN__) |
96506d1d VZ |
59 | // needed for IID_IAutoComplete, IID_IAutoComplete2 and ACO_AUTOSUGGEST |
60 | #include <shlguid.h> | |
0f0c5856 VZ |
61 | |
62 | #ifndef ACO_AUTOAPPEND | |
63 | #define ACO_AUTOAPPEND 0x02 | |
64 | #endif | |
96506d1d VZ |
65 | #endif |
66 | ||
67 | #ifndef ACO_UPDOWNKEYDROPSLIST | |
68 | #define ACO_UPDOWNKEYDROPSLIST 0x20 | |
69 | #endif | |
70 | ||
71 | #ifndef SHACF_FILESYS_ONLY | |
72 | #define SHACF_FILESYS_ONLY 0x00000010 | |
73 | #endif | |
74 | ||
03dede4d VZ |
75 | #ifndef SHACF_FILESYS_DIRS |
76 | #define SHACF_FILESYS_DIRS 0x00000020 | |
77 | #endif | |
78 | ||
609a42de VZ |
79 | // This must be the last header included to only affect the DEFINE_GUID() |
80 | // occurrences below but not any GUIDs declared in the standard files included | |
81 | // above. | |
82 | #include <initguid.h> | |
83 | ||
e71e4c93 VZ |
84 | namespace |
85 | { | |
86 | ||
78f250a4 VZ |
87 | // Normally this interface and its IID are defined in shobjidl.h header file |
88 | // included in the platform SDK but MinGW and Cygwin don't have it so redefine | |
89 | // the interface ourselves and, as long as we do it all, do it for all | |
90 | // compilers to ensure we have the same behaviour for all of them and to avoid | |
91 | // the need to check for concrete compilers and maybe even their versions. | |
92 | class IAutoCompleteDropDown : public IUnknown | |
93 | { | |
94 | public: | |
95 | virtual HRESULT wxSTDCALL GetDropDownStatus(DWORD *, LPWSTR *) = 0; | |
96 | virtual HRESULT wxSTDCALL ResetEnumerator() = 0; | |
97 | }; | |
98 | ||
c6212697 | 99 | DEFINE_GUID(wxIID_IAutoCompleteDropDown, |
78f250a4 VZ |
100 | 0x3cd141f4, 0x3c6a, 0x11d2, 0xbc, 0xaa, 0x00, 0xc0, 0x4f, 0xd9, 0x29, 0xdb); |
101 | ||
c6212697 | 102 | DEFINE_GUID(wxCLSID_AutoComplete, |
78f250a4 VZ |
103 | 0x00bb2763, 0x6a77, 0x11d0, 0xa5, 0x35, 0x00, 0xc0, 0x4f, 0xd7, 0xd0, 0x62); |
104 | ||
e71e4c93 VZ |
105 | // Small helper class which can be used to ensure thread safety even when |
106 | // wxUSE_THREADS==0 (and hence wxCriticalSection does nothing). | |
107 | class CSLock | |
108 | { | |
109 | public: | |
110 | CSLock(CRITICAL_SECTION& cs) : m_cs(&cs) | |
111 | { | |
112 | ::EnterCriticalSection(m_cs); | |
113 | } | |
114 | ||
115 | ~CSLock() | |
116 | { | |
117 | ::LeaveCriticalSection(m_cs); | |
118 | } | |
119 | ||
120 | private: | |
121 | CRITICAL_SECTION * const m_cs; | |
122 | ||
123 | wxDECLARE_NO_COPY_CLASS(CSLock); | |
124 | }; | |
125 | ||
126 | } // anonymity namespace | |
127 | ||
128 | // Implementation of string enumerator used by wxTextAutoCompleteData. This | |
85047589 | 129 | // class simply forwards to wxTextCompleter associated with it. |
e71e4c93 VZ |
130 | // |
131 | // Notice that Next() method of this class is called by IAutoComplete | |
132 | // background thread and so we must care about thread safety here. | |
0847dca6 VZ |
133 | class wxIEnumString : public IEnumString |
134 | { | |
135 | public: | |
ea98f11c | 136 | wxIEnumString() |
0847dca6 | 137 | { |
e71e4c93 | 138 | Init(); |
0847dca6 VZ |
139 | } |
140 | ||
85047589 | 141 | void ChangeCompleter(wxTextCompleter *completer) |
68e6eb7d | 142 | { |
85047589 VZ |
143 | // Indicate to Next() that it should bail out as soon as possible. |
144 | { | |
145 | CSLock lock(m_csRestart); | |
68e6eb7d | 146 | |
85047589 VZ |
147 | m_restart = TRUE; |
148 | } | |
e71e4c93 | 149 | |
85047589 VZ |
150 | // Now try to enter this critical section to ensure that Next() doesn't |
151 | // use the old pointer any more before changing it (this is vital as | |
152 | // the old pointer will be destroyed after we return). | |
153 | CSLock lock(m_csCompleter); | |
154 | ||
155 | m_completer = completer; | |
e71e4c93 VZ |
156 | } |
157 | ||
85047589 | 158 | void UpdatePrefix(const wxString& prefix) |
e71e4c93 | 159 | { |
85047589 | 160 | CSLock lock(m_csRestart); |
e71e4c93 | 161 | |
85047589 VZ |
162 | // We simply store the prefix here and will really update during the |
163 | // next call to our Next() method as we want to call Start() from the | |
164 | // worker thread to prevent the main UI thread from blocking while the | |
165 | // completions are generated. | |
e71e4c93 | 166 | m_prefix = prefix; |
85047589 | 167 | m_restart = TRUE; |
e71e4c93 | 168 | } |
0847dca6 VZ |
169 | |
170 | virtual HRESULT STDMETHODCALLTYPE Next(ULONG celt, | |
171 | LPOLESTR *rgelt, | |
172 | ULONG *pceltFetched) | |
173 | { | |
174 | if ( !rgelt || (!pceltFetched && celt > 1) ) | |
175 | return E_POINTER; | |
176 | ||
177 | ULONG pceltFetchedDummy; | |
178 | if ( !pceltFetched ) | |
179 | pceltFetched = &pceltFetchedDummy; | |
180 | ||
181 | *pceltFetched = 0; | |
182 | ||
85047589 | 183 | CSLock lock(m_csCompleter); |
e71e4c93 | 184 | |
85047589 VZ |
185 | if ( !RestartIfNeeded() ) |
186 | return S_FALSE; | |
e71e4c93 | 187 | |
85047589 | 188 | while ( celt-- ) |
0847dca6 | 189 | { |
85047589 VZ |
190 | // Stop iterating if we need to update completions anyhow. |
191 | if ( m_restart ) | |
0847dca6 VZ |
192 | return S_FALSE; |
193 | ||
85047589 VZ |
194 | const wxString s = m_completer->GetNext(); |
195 | if ( s.empty() ) | |
196 | return S_FALSE; | |
197 | ||
198 | const wxWX2WCbuf wcbuf = s.wc_str(); | |
0847dca6 VZ |
199 | const size_t size = (wcslen(wcbuf) + 1)*sizeof(wchar_t); |
200 | void *olestr = CoTaskMemAlloc(size); | |
201 | if ( !olestr ) | |
202 | return E_OUTOFMEMORY; | |
203 | ||
204 | memcpy(olestr, wcbuf, size); | |
205 | ||
5c33522f | 206 | *rgelt++ = static_cast<LPOLESTR>(olestr); |
0847dca6 VZ |
207 | |
208 | ++(*pceltFetched); | |
209 | } | |
210 | ||
211 | return S_OK; | |
212 | } | |
213 | ||
214 | virtual HRESULT STDMETHODCALLTYPE Skip(ULONG celt) | |
215 | { | |
85047589 VZ |
216 | if ( !celt ) |
217 | return E_INVALIDARG; | |
e71e4c93 | 218 | |
85047589 VZ |
219 | CSLock lock(m_csCompleter); |
220 | ||
221 | if ( !RestartIfNeeded() ) | |
0847dca6 | 222 | return S_FALSE; |
85047589 VZ |
223 | |
224 | while ( celt-- ) | |
225 | { | |
226 | if ( m_restart ) | |
227 | return S_FALSE; | |
228 | ||
229 | if ( m_completer->GetNext().empty() ) | |
230 | return S_FALSE; | |
0847dca6 VZ |
231 | } |
232 | ||
233 | return S_OK; | |
234 | } | |
235 | ||
236 | virtual HRESULT STDMETHODCALLTYPE Reset() | |
237 | { | |
85047589 | 238 | CSLock lock(m_csRestart); |
e71e4c93 | 239 | |
85047589 | 240 | m_restart = TRUE; |
0847dca6 VZ |
241 | |
242 | return S_OK; | |
243 | } | |
244 | ||
245 | virtual HRESULT STDMETHODCALLTYPE Clone(IEnumString **ppEnum) | |
246 | { | |
247 | if ( !ppEnum ) | |
248 | return E_POINTER; | |
249 | ||
85047589 | 250 | CSLock lock(m_csCompleter); |
0847dca6 | 251 | |
85047589 | 252 | wxIEnumString * const e = new wxIEnumString; |
0847dca6 | 253 | e->AddRef(); |
85047589 VZ |
254 | |
255 | e->ChangeCompleter(m_completer); | |
256 | ||
0847dca6 VZ |
257 | *ppEnum = e; |
258 | ||
259 | return S_OK; | |
260 | } | |
261 | ||
e71e4c93 VZ |
262 | DECLARE_IUNKNOWN_METHODS; |
263 | ||
0847dca6 | 264 | private: |
3eeefdf9 VZ |
265 | // dtor doesn't have to be virtual as we're only ever deleted from our own |
266 | // Release() and are not meant to be derived form anyhow, but making it | |
267 | // virtual silences gcc warnings; making it private makes it impossible to | |
268 | // (mistakenly) delete us directly instead of calling Release() | |
e71e4c93 VZ |
269 | virtual ~wxIEnumString() |
270 | { | |
85047589 VZ |
271 | ::DeleteCriticalSection(&m_csRestart); |
272 | ::DeleteCriticalSection(&m_csCompleter); | |
e71e4c93 VZ |
273 | } |
274 | ||
275 | // Common part of all ctors. | |
276 | void Init() | |
277 | { | |
85047589 VZ |
278 | ::InitializeCriticalSection(&m_csCompleter); |
279 | ::InitializeCriticalSection(&m_csRestart); | |
e71e4c93 VZ |
280 | |
281 | m_completer = NULL; | |
85047589 | 282 | m_restart = FALSE; |
e71e4c93 VZ |
283 | } |
284 | ||
85047589 VZ |
285 | // Restart completions generation if needed. Should be only called from |
286 | // inside m_csCompleter. | |
287 | // | |
288 | // If false is returned, it means that there are no completions and that | |
289 | // wxTextCompleter::GetNext() shouldn't be called at all. | |
290 | bool RestartIfNeeded() | |
e71e4c93 | 291 | { |
85047589 VZ |
292 | bool rc = true; |
293 | for ( ;; ) | |
e71e4c93 | 294 | { |
85047589 VZ |
295 | wxString prefix; |
296 | LONG restart; | |
297 | { | |
298 | CSLock lock(m_csRestart); | |
3eeefdf9 | 299 | |
85047589 VZ |
300 | prefix = m_prefix; |
301 | restart = m_restart; | |
e71e4c93 | 302 | |
85047589 VZ |
303 | m_restart = FALSE; |
304 | } // Release m_csRestart before calling Start() to avoid blocking | |
305 | // the main thread in UpdatePrefix() during its execution. | |
e71e4c93 | 306 | |
85047589 VZ |
307 | if ( !restart ) |
308 | break; | |
e71e4c93 | 309 | |
85047589 | 310 | rc = m_completer->Start(prefix); |
e71e4c93 | 311 | } |
85047589 VZ |
312 | |
313 | return rc; | |
e71e4c93 VZ |
314 | } |
315 | ||
316 | ||
85047589 VZ |
317 | // Critical section protecting m_completer itself. It must be entered when |
318 | // using the pointer to ensure that we don't continue using a dangling one | |
319 | // after it is destroyed. | |
320 | CRITICAL_SECTION m_csCompleter; | |
e71e4c93 | 321 | |
85047589 VZ |
322 | // The completer we delegate to for the completions generation. It is never |
323 | // NULL after the initial ChangeCompleter() call. | |
324 | wxTextCompleter *m_completer; | |
0847dca6 | 325 | |
e71e4c93 | 326 | |
85047589 VZ |
327 | // Critical section m_prefix and m_restart. It should be only entered for |
328 | // short periods of time, i.e. we shouldn't call any wxTextCompleter | |
329 | // methods from inside, to prevent the main thread from blocking on it in | |
330 | // UpdatePrefix(). | |
331 | CRITICAL_SECTION m_csRestart; | |
332 | ||
333 | // If m_restart is true, we need to call wxTextCompleter::Start() with the | |
334 | // given prefix to restart generating the completions. | |
e71e4c93 VZ |
335 | wxString m_prefix; |
336 | ||
85047589 VZ |
337 | // Notice that we use LONG and not bool here to ensure that reading this |
338 | // value is atomic (32 bit reads are atomic operations under all Windows | |
339 | // versions but reading bool isn't necessarily). | |
340 | LONG m_restart; | |
341 | ||
ea98f11c | 342 | |
85047589 | 343 | wxDECLARE_NO_COPY_CLASS(wxIEnumString); |
0847dca6 VZ |
344 | }; |
345 | ||
346 | BEGIN_IID_TABLE(wxIEnumString) | |
347 | ADD_IID(Unknown) | |
348 | ADD_IID(EnumString) | |
349 | END_IID_TABLE; | |
350 | ||
351 | IMPLEMENT_IUNKNOWN_METHODS(wxIEnumString) | |
352 | ||
ea98f11c | 353 | |
85047589 VZ |
354 | // This class gathers the all auto-complete-related stuff we use. It is |
355 | // allocated on demand by wxTextEntry when AutoComplete() is called. | |
ea98f11c VZ |
356 | class wxTextAutoCompleteData wxBIND_OR_CONNECT_HACK_ONLY_BASE_CLASS |
357 | { | |
358 | public: | |
359 | // The constructor associates us with the given text entry. | |
360 | wxTextAutoCompleteData(wxTextEntry *entry) | |
361 | : m_entry(entry), | |
362 | m_win(entry->GetEditableWindow()) | |
363 | { | |
364 | m_autoComplete = NULL; | |
365 | m_autoCompleteDropDown = NULL; | |
366 | m_enumStrings = NULL; | |
85047589 VZ |
367 | |
368 | m_fixedCompleter = NULL; | |
ea98f11c VZ |
369 | m_customCompleter = NULL; |
370 | ||
b9a46ea5 | 371 | m_connectedCharEvent = false; |
ea98f11c VZ |
372 | |
373 | // Create an object exposing IAutoComplete interface which we'll later | |
374 | // use to get IAutoComplete2 as the latter can't be created directly, | |
375 | // apparently. | |
376 | HRESULT hr = CoCreateInstance | |
377 | ( | |
c6212697 | 378 | wxCLSID_AutoComplete, |
ea98f11c VZ |
379 | NULL, |
380 | CLSCTX_INPROC_SERVER, | |
381 | IID_IAutoComplete, | |
382 | reinterpret_cast<void **>(&m_autoComplete) | |
383 | ); | |
384 | if ( FAILED(hr) ) | |
385 | { | |
386 | wxLogApiError(wxT("CoCreateInstance(CLSID_AutoComplete)"), hr); | |
387 | return; | |
388 | } | |
389 | ||
390 | // Create a string enumerator and initialize the completer with it. | |
391 | m_enumStrings = new wxIEnumString; | |
392 | m_enumStrings->AddRef(); | |
393 | hr = m_autoComplete->Init(m_entry->GetEditHWND(), m_enumStrings, | |
394 | NULL, NULL); | |
395 | if ( FAILED(hr) ) | |
396 | { | |
397 | wxLogApiError(wxT("IAutoComplete::Init"), hr); | |
398 | ||
399 | m_enumStrings->Release(); | |
400 | m_enumStrings = NULL; | |
401 | ||
402 | return; | |
403 | } | |
404 | ||
405 | // As explained in DoRefresh(), we need to call IAutoCompleteDropDown:: | |
406 | // ResetEnumerator() if we want to be able to change the completions on | |
407 | // the fly. In principle we could live without it, i.e. return true | |
408 | // from IsOk() even if this QueryInterface() fails, but it doesn't look | |
409 | // like this is ever going to have in practice anyhow as the shell- | |
410 | // provided IAutoComplete always implements IAutoCompleteDropDown too. | |
411 | hr = m_autoComplete->QueryInterface | |
412 | ( | |
c6212697 | 413 | wxIID_IAutoCompleteDropDown, |
ea98f11c VZ |
414 | reinterpret_cast<void **>(&m_autoCompleteDropDown) |
415 | ); | |
416 | if ( FAILED(hr) ) | |
417 | { | |
418 | wxLogApiError(wxT("IAutoComplete::QI(IAutoCompleteDropDown)"), hr); | |
419 | return; | |
420 | } | |
421 | ||
422 | // Finally set the completion options using IAutoComplete2. | |
423 | IAutoComplete2 *pAutoComplete2 = NULL; | |
424 | hr = m_autoComplete->QueryInterface | |
425 | ( | |
426 | IID_IAutoComplete2, | |
427 | reinterpret_cast<void **>(&pAutoComplete2) | |
428 | ); | |
429 | if ( SUCCEEDED(hr) ) | |
430 | { | |
431 | pAutoComplete2->SetOptions(ACO_AUTOSUGGEST | | |
b9a46ea5 | 432 | ACO_AUTOAPPEND | |
ea98f11c VZ |
433 | ACO_UPDOWNKEYDROPSLIST); |
434 | pAutoComplete2->Release(); | |
435 | } | |
436 | } | |
437 | ||
438 | ~wxTextAutoCompleteData() | |
439 | { | |
440 | delete m_customCompleter; | |
85047589 | 441 | delete m_fixedCompleter; |
ea98f11c VZ |
442 | |
443 | if ( m_enumStrings ) | |
444 | m_enumStrings->Release(); | |
445 | if ( m_autoCompleteDropDown ) | |
446 | m_autoCompleteDropDown->Release(); | |
447 | if ( m_autoComplete ) | |
448 | m_autoComplete->Release(); | |
449 | } | |
450 | ||
451 | // Must be called after creating this object to verify if initializing it | |
452 | // succeeded. | |
453 | bool IsOk() const | |
454 | { | |
455 | return m_autoComplete && m_autoCompleteDropDown && m_enumStrings; | |
456 | } | |
457 | ||
458 | void ChangeStrings(const wxArrayString& strings) | |
459 | { | |
85047589 VZ |
460 | if ( !m_fixedCompleter ) |
461 | m_fixedCompleter = new wxTextCompleterFixed; | |
462 | ||
463 | m_fixedCompleter->SetCompletions(strings); | |
464 | ||
465 | m_enumStrings->ChangeCompleter(m_fixedCompleter); | |
ea98f11c VZ |
466 | |
467 | DoRefresh(); | |
468 | } | |
469 | ||
470 | // Takes ownership of the pointer if it is non-NULL. | |
471 | bool ChangeCustomCompleter(wxTextCompleter *completer) | |
472 | { | |
85047589 VZ |
473 | // Ensure that the old completer is not used any more before deleting |
474 | // it. | |
475 | m_enumStrings->ChangeCompleter(completer); | |
476 | ||
ea98f11c VZ |
477 | delete m_customCompleter; |
478 | m_customCompleter = completer; | |
479 | ||
480 | if ( m_customCompleter ) | |
481 | { | |
482 | // We postpone connecting to this event until we really need to do | |
483 | // it (however we don't disconnect from it when we don't need it | |
484 | // any more because we don't have wxUNBIND_OR_DISCONNECT_HACK...). | |
b9a46ea5 | 485 | if ( !m_connectedCharEvent ) |
ea98f11c | 486 | { |
b9a46ea5 VZ |
487 | m_connectedCharEvent = true; |
488 | ||
489 | // Use the special wxEVT_AFTER_CHAR and not the usual | |
490 | // wxEVT_CHAR here because we need to have the updated value of | |
491 | // the text control in this handler in order to provide | |
492 | // completions for the correct prefix and unfortunately we | |
493 | // don't have any way to let DefWindowProc() run from our | |
494 | // wxEVT_CHAR handler (as we must also let the other handlers | |
495 | // defined at wx level run first). | |
496 | // | |
ce7fe42e | 497 | // Notice that we can't use wxEVT_TEXT here |
b9a46ea5 VZ |
498 | // neither as, due to our use of ACO_AUTOAPPEND, we get |
499 | // EN_CHANGE notifications from the control every time | |
500 | // IAutoComplete auto-appends something to it. | |
501 | wxBIND_OR_CONNECT_HACK(m_win, wxEVT_AFTER_CHAR, | |
502 | wxKeyEventHandler, | |
503 | wxTextAutoCompleteData::OnAfterChar, | |
ea98f11c VZ |
504 | this); |
505 | } | |
506 | ||
507 | UpdateStringsFromCustomCompleter(); | |
508 | } | |
509 | ||
510 | return true; | |
511 | } | |
512 | ||
513 | void DisableCompletion() | |
514 | { | |
515 | // We currently simply reset the list of possible strings as this seems | |
516 | // to effectively disable auto-completion just fine. We could (and | |
517 | // probably should) use IAutoComplete::Enable(FALSE) for this too but | |
518 | // then we'd need to call Enable(TRUE) to turn it on back again later. | |
85047589 | 519 | ChangeStrings(wxArrayString()); |
ea98f11c VZ |
520 | } |
521 | ||
522 | private: | |
85047589 VZ |
523 | // Must be called after changing the values to be returned by wxIEnumString |
524 | // to really make the changes stick. | |
ea98f11c VZ |
525 | void DoRefresh() |
526 | { | |
527 | m_enumStrings->Reset(); | |
528 | ||
529 | // This is completely and utterly not documented and in fact the | |
530 | // current MSDN seems to try to discourage us from using it by saying | |
531 | // that "there is no reason to use this method unless the drop-down | |
532 | // list is currently visible" but actually we absolutely must call it | |
533 | // to force the auto-completer (and not just its drop-down!) to refresh | |
534 | // the list of completions which could have changed now. Without this | |
535 | // call the new choices returned by GetCompletions() that hadn't been | |
536 | // returned by it before are simply silently ignored. | |
537 | m_autoCompleteDropDown->ResetEnumerator(); | |
538 | } | |
539 | ||
540 | // Update the strings returned by our string enumerator to correspond to | |
541 | // the currently valid choices according to the custom completer. | |
542 | void UpdateStringsFromCustomCompleter() | |
543 | { | |
b9a46ea5 VZ |
544 | // As we use ACO_AUTOAPPEND, the selected part of the text is usually |
545 | // the one appended by us so don't consider it as part of the | |
546 | // user-entered prefix. | |
547 | long from, to; | |
548 | m_entry->GetSelection(&from, &to); | |
549 | ||
550 | if ( to == from ) | |
551 | from = m_entry->GetLastPosition(); // Take all if no selection. | |
552 | ||
553 | const wxString prefix = m_entry->GetRange(0, from); | |
554 | ||
85047589 | 555 | m_enumStrings->UpdatePrefix(prefix); |
ea98f11c VZ |
556 | |
557 | DoRefresh(); | |
558 | } | |
559 | ||
b9a46ea5 | 560 | void OnAfterChar(wxKeyEvent& event) |
ea98f11c | 561 | { |
b9a46ea5 VZ |
562 | // Notice that we must not refresh the completions when the user |
563 | // presses Backspace as this would result in adding back the just | |
564 | // erased character(s) because of ACO_AUTOAPPEND option we use. | |
565 | if ( m_customCompleter && event.GetKeyCode() != WXK_BACK ) | |
ea98f11c VZ |
566 | UpdateStringsFromCustomCompleter(); |
567 | ||
568 | event.Skip(); | |
569 | } | |
570 | ||
571 | ||
572 | // The text entry we're associated with. | |
573 | wxTextEntry * const m_entry; | |
574 | ||
575 | // The window of this text entry. | |
576 | wxWindow * const m_win; | |
577 | ||
578 | // The auto-completer object itself. | |
579 | IAutoComplete *m_autoComplete; | |
580 | ||
581 | // Its IAutoCompleteDropDown interface needed for ResetEnumerator() call. | |
582 | IAutoCompleteDropDown *m_autoCompleteDropDown; | |
583 | ||
584 | // Enumerator for strings currently used for auto-completion. | |
585 | wxIEnumString *m_enumStrings; | |
586 | ||
85047589 VZ |
587 | // Fixed string completer or NULL if none. |
588 | wxTextCompleterFixed *m_fixedCompleter; | |
589 | ||
ea98f11c VZ |
590 | // Custom completer or NULL if none. |
591 | wxTextCompleter *m_customCompleter; | |
592 | ||
593 | // Initially false, set to true after connecting OnTextChanged() handler. | |
b9a46ea5 | 594 | bool m_connectedCharEvent; |
ea98f11c VZ |
595 | |
596 | ||
597 | wxDECLARE_NO_COPY_CLASS(wxTextAutoCompleteData); | |
598 | }; | |
599 | ||
fd873451 | 600 | #endif // HAS_AUTOCOMPLETE |
0847dca6 | 601 | |
69a05ef6 VZ |
602 | // ============================================================================ |
603 | // wxTextEntry implementation | |
604 | // ============================================================================ | |
605 | ||
ea98f11c VZ |
606 | // ---------------------------------------------------------------------------- |
607 | // initialization and destruction | |
608 | // ---------------------------------------------------------------------------- | |
609 | ||
610 | wxTextEntry::wxTextEntry() | |
611 | { | |
612 | #ifdef HAS_AUTOCOMPLETE | |
613 | m_autoCompleteData = NULL; | |
614 | #endif // HAS_AUTOCOMPLETE | |
615 | } | |
616 | ||
617 | wxTextEntry::~wxTextEntry() | |
618 | { | |
619 | #ifdef HAS_AUTOCOMPLETE | |
620 | delete m_autoCompleteData; | |
621 | #endif // HAS_AUTOCOMPLETE | |
622 | } | |
623 | ||
0847dca6 VZ |
624 | // ---------------------------------------------------------------------------- |
625 | // operations on text | |
626 | // ---------------------------------------------------------------------------- | |
627 | ||
69a05ef6 VZ |
628 | void wxTextEntry::WriteText(const wxString& text) |
629 | { | |
017dc06b | 630 | ::SendMessage(GetEditHwnd(), EM_REPLACESEL, 0, wxMSW_CONV_LPARAM(text)); |
69a05ef6 VZ |
631 | } |
632 | ||
135b23b2 | 633 | wxString wxTextEntry::DoGetValue() const |
69a05ef6 VZ |
634 | { |
635 | return wxGetWindowText(GetEditHWND()); | |
636 | } | |
637 | ||
638 | void wxTextEntry::Remove(long from, long to) | |
639 | { | |
640 | DoSetSelection(from, to, SetSel_NoScroll); | |
641 | WriteText(wxString()); | |
642 | } | |
643 | ||
0847dca6 VZ |
644 | // ---------------------------------------------------------------------------- |
645 | // clipboard operations | |
646 | // ---------------------------------------------------------------------------- | |
647 | ||
69a05ef6 VZ |
648 | void wxTextEntry::Copy() |
649 | { | |
650 | ::SendMessage(GetEditHwnd(), WM_COPY, 0, 0); | |
651 | } | |
652 | ||
653 | void wxTextEntry::Cut() | |
654 | { | |
655 | ::SendMessage(GetEditHwnd(), WM_CUT, 0, 0); | |
656 | } | |
657 | ||
658 | void wxTextEntry::Paste() | |
659 | { | |
660 | ::SendMessage(GetEditHwnd(), WM_PASTE, 0, 0); | |
661 | } | |
662 | ||
0847dca6 VZ |
663 | // ---------------------------------------------------------------------------- |
664 | // undo/redo | |
665 | // ---------------------------------------------------------------------------- | |
666 | ||
69a05ef6 VZ |
667 | void wxTextEntry::Undo() |
668 | { | |
669 | ::SendMessage(GetEditHwnd(), EM_UNDO, 0, 0); | |
670 | } | |
671 | ||
672 | void wxTextEntry::Redo() | |
673 | { | |
3cb6eaec | 674 | // same as Undo, since Undo undoes the undo |
69a05ef6 VZ |
675 | Undo(); |
676 | return; | |
677 | } | |
678 | ||
679 | bool wxTextEntry::CanUndo() const | |
680 | { | |
681 | return ::SendMessage(GetEditHwnd(), EM_CANUNDO, 0, 0) != 0; | |
682 | } | |
683 | ||
684 | bool wxTextEntry::CanRedo() const | |
685 | { | |
686 | // see comment in Redo() | |
687 | return CanUndo(); | |
688 | } | |
689 | ||
0847dca6 VZ |
690 | // ---------------------------------------------------------------------------- |
691 | // insertion point and selection | |
692 | // ---------------------------------------------------------------------------- | |
693 | ||
69a05ef6 VZ |
694 | void wxTextEntry::SetInsertionPoint(long pos) |
695 | { | |
2851cf25 VZ |
696 | // calling DoSetSelection(-1, -1) would select everything which is not what |
697 | // we want here | |
698 | if ( pos == -1 ) | |
699 | pos = GetLastPosition(); | |
700 | ||
69a05ef6 VZ |
701 | // be careful to call DoSetSelection() which is overridden in wxTextCtrl |
702 | // and not just SetSelection() here | |
703 | DoSetSelection(pos, pos); | |
704 | } | |
705 | ||
706 | long wxTextEntry::GetInsertionPoint() const | |
707 | { | |
708 | long from; | |
709 | GetSelection(&from, NULL); | |
710 | return from; | |
711 | } | |
712 | ||
713 | long wxTextEntry::GetLastPosition() const | |
714 | { | |
715 | return ::SendMessage(GetEditHwnd(), EM_LINELENGTH, 0, 0); | |
716 | } | |
717 | ||
718 | void wxTextEntry::DoSetSelection(long from, long to, int WXUNUSED(flags)) | |
719 | { | |
720 | // if from and to are both -1, it means (in wxWidgets) that all text should | |
721 | // be selected, translate this into Windows convention | |
722 | if ( (from == -1) && (to == -1) ) | |
723 | { | |
724 | from = 0; | |
725 | } | |
726 | ||
727 | ::SendMessage(GetEditHwnd(), EM_SETSEL, from, to); | |
728 | } | |
729 | ||
730 | void wxTextEntry::GetSelection(long *from, long *to) const | |
731 | { | |
732 | DWORD dwStart, dwEnd; | |
733 | ::SendMessage(GetEditHwnd(), EM_GETSEL, (WPARAM)&dwStart, (LPARAM)&dwEnd); | |
734 | ||
735 | if ( from ) | |
736 | *from = dwStart; | |
737 | if ( to ) | |
738 | *to = dwEnd; | |
739 | } | |
740 | ||
0847dca6 VZ |
741 | // ---------------------------------------------------------------------------- |
742 | // auto-completion | |
743 | // ---------------------------------------------------------------------------- | |
744 | ||
6502dc68 | 745 | #if wxUSE_OLE |
6b30ffed VZ |
746 | |
747 | #ifdef HAS_AUTOCOMPLETE | |
748 | ||
4e3eedde VZ |
749 | #if wxUSE_DYNLIB_CLASS |
750 | ||
03dede4d | 751 | bool wxTextEntry::DoAutoCompleteFileNames(int flags) |
59396417 VZ |
752 | { |
753 | typedef HRESULT (WINAPI *SHAutoComplete_t)(HWND, DWORD); | |
754 | static SHAutoComplete_t s_pfnSHAutoComplete = (SHAutoComplete_t)-1; | |
755 | static wxDynamicLibrary s_dllShlwapi; | |
756 | if ( s_pfnSHAutoComplete == (SHAutoComplete_t)-1 ) | |
757 | { | |
9a83f860 | 758 | if ( !s_dllShlwapi.Load(wxT("shlwapi.dll"), wxDL_VERBATIM | wxDL_QUIET) ) |
59396417 VZ |
759 | { |
760 | s_pfnSHAutoComplete = NULL; | |
761 | } | |
762 | else | |
763 | { | |
764 | wxDL_INIT_FUNC(s_pfn, SHAutoComplete, s_dllShlwapi); | |
765 | } | |
766 | } | |
767 | ||
768 | if ( !s_pfnSHAutoComplete ) | |
769 | return false; | |
770 | ||
03dede4d VZ |
771 | DWORD dwFlags = 0; |
772 | if ( flags & wxFILE ) | |
773 | dwFlags |= SHACF_FILESYS_ONLY; | |
774 | else if ( flags & wxDIR ) | |
775 | dwFlags |= SHACF_FILESYS_DIRS; | |
776 | else | |
777 | { | |
778 | wxFAIL_MSG(wxS("No flags for file name auto completion?")); | |
779 | return false; | |
780 | } | |
781 | ||
782 | HRESULT hr = (*s_pfnSHAutoComplete)(GetEditHwnd(), dwFlags); | |
59396417 VZ |
783 | if ( FAILED(hr) ) |
784 | { | |
9a83f860 | 785 | wxLogApiError(wxT("SHAutoComplete()"), hr); |
59396417 VZ |
786 | |
787 | return false; | |
788 | } | |
ea98f11c VZ |
789 | |
790 | // Disable the other kinds of completion now that we use the built-in file | |
791 | // names completion. | |
792 | if ( m_autoCompleteData ) | |
793 | m_autoCompleteData->DisableCompletion(); | |
794 | ||
59396417 VZ |
795 | return true; |
796 | } | |
797 | ||
4e3eedde VZ |
798 | #endif // wxUSE_DYNLIB_CLASS |
799 | ||
ea98f11c | 800 | wxTextAutoCompleteData *wxTextEntry::GetOrCreateCompleter() |
0847dca6 | 801 | { |
ea98f11c | 802 | if ( !m_autoCompleteData ) |
68e6eb7d | 803 | { |
ea98f11c VZ |
804 | wxTextAutoCompleteData * const ac = new wxTextAutoCompleteData(this); |
805 | if ( ac->IsOk() ) | |
806 | m_autoCompleteData = ac; | |
807 | else | |
808 | delete ac; | |
68e6eb7d VZ |
809 | } |
810 | ||
ea98f11c VZ |
811 | return m_autoCompleteData; |
812 | } | |
813 | ||
814 | bool wxTextEntry::DoAutoCompleteStrings(const wxArrayString& choices) | |
815 | { | |
816 | wxTextAutoCompleteData * const ac = GetOrCreateCompleter(); | |
817 | if ( !ac ) | |
0847dca6 | 818 | return false; |
0847dca6 | 819 | |
ea98f11c VZ |
820 | ac->ChangeStrings(choices); |
821 | ||
822 | return true; | |
823 | } | |
824 | ||
825 | bool wxTextEntry::DoAutoCompleteCustom(wxTextCompleter *completer) | |
826 | { | |
827 | // First deal with the case when we just want to disable auto-completion. | |
828 | if ( !completer ) | |
0847dca6 | 829 | { |
ea98f11c VZ |
830 | if ( m_autoCompleteData ) |
831 | m_autoCompleteData->DisableCompletion(); | |
832 | //else: Nothing to do, we hadn't used auto-completion even before. | |
0847dca6 | 833 | } |
ea98f11c | 834 | else // Have a valid completer. |
0847dca6 | 835 | { |
ea98f11c VZ |
836 | wxTextAutoCompleteData * const ac = GetOrCreateCompleter(); |
837 | if ( !ac ) | |
838 | { | |
839 | // Delete the custom completer for consistency with the case when | |
840 | // we succeed to avoid memory leaks in user code. | |
841 | delete completer; | |
842 | return false; | |
843 | } | |
844 | ||
845 | // This gives ownership of the custom completer to m_autoCompleteData. | |
846 | if ( !ac->ChangeCustomCompleter(completer) ) | |
847 | return false; | |
0847dca6 VZ |
848 | } |
849 | ||
0847dca6 | 850 | return true; |
6b30ffed VZ |
851 | } |
852 | ||
fd873451 | 853 | #else // !HAS_AUTOCOMPLETE |
867b485e | 854 | |
6b30ffed VZ |
855 | // We still need to define stubs as we declared these overrides in the header. |
856 | ||
03dede4d | 857 | bool wxTextEntry::DoAutoCompleteFileNames(int flags) |
6b30ffed | 858 | { |
03dede4d | 859 | return wxTextEntryBase::DoAutoCompleteFileNames(flags); |
6b30ffed VZ |
860 | } |
861 | ||
862 | bool wxTextEntry::DoAutoCompleteStrings(const wxArrayString& choices) | |
863 | { | |
864 | return wxTextEntryBase::DoAutoCompleteStrings(choices); | |
0847dca6 | 865 | } |
6b30ffed | 866 | |
32bd17fc VZ |
867 | bool wxTextEntry::DoAutoCompleteCustom(wxTextCompleter *completer) |
868 | { | |
8d43e8c6 | 869 | return wxTextEntryBase::DoAutoCompleteCustom(completer); |
32bd17fc VZ |
870 | } |
871 | ||
6b30ffed VZ |
872 | #endif // HAS_AUTOCOMPLETE/!HAS_AUTOCOMPLETE |
873 | ||
6502dc68 | 874 | #endif // wxUSE_OLE |
0847dca6 | 875 | |
0847dca6 VZ |
876 | // ---------------------------------------------------------------------------- |
877 | // editable state | |
878 | // ---------------------------------------------------------------------------- | |
879 | ||
69a05ef6 VZ |
880 | bool wxTextEntry::IsEditable() const |
881 | { | |
5ad3f0c8 | 882 | return !(::GetWindowLong(GetEditHwnd(), GWL_STYLE) & ES_READONLY); |
69a05ef6 VZ |
883 | } |
884 | ||
885 | void wxTextEntry::SetEditable(bool editable) | |
886 | { | |
887 | ::SendMessage(GetEditHwnd(), EM_SETREADONLY, !editable, 0); | |
888 | } | |
889 | ||
0847dca6 VZ |
890 | // ---------------------------------------------------------------------------- |
891 | // max length | |
892 | // ---------------------------------------------------------------------------- | |
893 | ||
69a05ef6 VZ |
894 | void wxTextEntry::SetMaxLength(unsigned long len) |
895 | { | |
896 | if ( len >= 0xffff ) | |
897 | { | |
898 | // this will set it to a platform-dependent maximum (much more | |
899 | // than 64Kb under NT) | |
900 | len = 0; | |
901 | } | |
902 | ||
903 | ::SendMessage(GetEditHwnd(), EM_LIMITTEXT, len, 0); | |
904 | } | |
96a4cdeb | 905 | |
63f7d502 VZ |
906 | // ---------------------------------------------------------------------------- |
907 | // hints | |
908 | // ---------------------------------------------------------------------------- | |
909 | ||
910 | #if wxUSE_UXTHEME | |
911 | ||
912 | #ifndef EM_SETCUEBANNER | |
913 | #define EM_SETCUEBANNER 0x1501 | |
914 | #define EM_GETCUEBANNER 0x1502 | |
915 | #endif | |
916 | ||
917 | bool wxTextEntry::SetHint(const wxString& hint) | |
918 | { | |
919 | if ( wxUxThemeEngine::GetIfActive() ) | |
920 | { | |
921 | // notice that this message always works with Unicode strings | |
7591b0bb VZ |
922 | // |
923 | // we always use TRUE for wParam to show the hint even when the window | |
924 | // has focus, otherwise there would be no way to show the hint for the | |
925 | // initially focused window | |
63f7d502 | 926 | if ( ::SendMessage(GetEditHwnd(), EM_SETCUEBANNER, |
7591b0bb | 927 | TRUE, (LPARAM)(const wchar_t *)hint.wc_str()) ) |
63f7d502 VZ |
928 | return true; |
929 | } | |
930 | ||
931 | return wxTextEntryBase::SetHint(hint); | |
932 | } | |
933 | ||
934 | wxString wxTextEntry::GetHint() const | |
935 | { | |
936 | if ( wxUxThemeEngine::GetIfActive() ) | |
937 | { | |
938 | wchar_t buf[256]; | |
939 | if ( ::SendMessage(GetEditHwnd(), EM_GETCUEBANNER, | |
940 | (WPARAM)buf, WXSIZEOF(buf)) ) | |
d2f434e4 | 941 | return wxString(buf); |
63f7d502 VZ |
942 | } |
943 | ||
944 | return wxTextEntryBase::GetHint(); | |
945 | } | |
946 | ||
947 | ||
948 | #endif // wxUSE_UXTHEME | |
949 | ||
0847e36e JS |
950 | // ---------------------------------------------------------------------------- |
951 | // margins support | |
952 | // ---------------------------------------------------------------------------- | |
953 | ||
954 | bool wxTextEntry::DoSetMargins(const wxPoint& margins) | |
955 | { | |
956 | #if !defined(__WXWINCE__) | |
957 | bool res = true; | |
958 | ||
959 | if ( margins.x != -1 ) | |
960 | { | |
0b97da99 VZ |
961 | // Set both horizontal margins to the given value, we don't distinguish |
962 | // between left and right margin at wx API level and it seems to be | |
963 | // better to change both of them than only left one. | |
0847e36e | 964 | ::SendMessage(GetEditHwnd(), EM_SETMARGINS, |
0b97da99 VZ |
965 | EC_LEFTMARGIN | EC_RIGHTMARGIN, |
966 | MAKELONG(margins.x, margins.x)); | |
0847e36e JS |
967 | } |
968 | ||
969 | if ( margins.y != -1 ) | |
970 | { | |
971 | res = false; | |
972 | } | |
973 | ||
974 | return res; | |
975 | #else | |
976 | return false; | |
977 | #endif | |
978 | } | |
979 | ||
980 | wxPoint wxTextEntry::DoGetMargins() const | |
981 | { | |
982 | #if !defined(__WXWINCE__) | |
983 | LRESULT lResult = ::SendMessage(GetEditHwnd(), EM_GETMARGINS, | |
984 | 0, 0); | |
985 | int left = LOWORD(lResult); | |
986 | int top = -1; | |
987 | return wxPoint(left, top); | |
988 | #else | |
989 | return wxPoint(-1, -1); | |
990 | #endif | |
991 | } | |
992 | ||
96a4cdeb | 993 | #endif // wxUSE_TEXTCTRL || wxUSE_COMBOBOX |