Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Minor clarifications to wxTextEntry::SetHint() docs.

Browse Source 
Update platforms support docs.  Mention event handlers interaction in
the generic implementation.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@75336 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Václav Slavík
2013-12-02 17:46:30 +00:00
parent 065deffd86
commit 3258c423b4
1 changed files with 13 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
interface/wx/textentry.h
View File

@@ -459,15 +459,19 @@ public:
Notice that hints are known as <em>cue banners</em> under MSW or Notice that hints are known as <em>cue banners</em> under MSW or
<em>placeholder strings</em> under OS X. <em>placeholder strings</em> under OS X.
@remarks For the platforms without native hints support (and currently @remarks Currently implemented natively on Windows (Vista and later
only the MSW port does have it and even there it is only used under only), OS X and GTK+ (3.2 and later).
Windows Vista and later only), the implementation has several known
limitations. Notably, the hint display will not be properly updated For the platforms without native hints support, the implementation
if you change wxTextEntry contents programmatically when the hint has several known limitations. Notably, the hint display will not
is displayed using methods other than SetValue() or ChangeValue() be properly updated if you change wxTextEntry contents
or others which use them internally (e.g. Clear()). In other words, programmatically when the hint is displayed using methods other
currently you should avoid calling methods such as WriteText() or than SetValue() or ChangeValue() or others which use them
Replace() when using hints and the text control is empty. internally (e.g. Clear()). In other words, currently you should
avoid calling methods such as WriteText() or Replace() when using
hints and the text control is empty. If you bind to the control's
focus and wxEVT_TEXT events, you must call wxEvent::Skip() on them
so that the generic implementation works correctly.
@remarks Hints can only be used for single line text controls, @remarks Hints can only be used for single line text controls,
native multi-line text controls don't support hints under any native multi-line text controls don't support hints under any