# and not twice as the \headerfile command requires:
ALIASES += wxheader{1}="\headerfile \1 wx/\1"
-# the following alias avoids to repeat lots of times the same statement:
-ALIASES += wxsince{1}="\since This feature is available in wxWidgets version \1 or higher."
-
# some formatting aliases
ALIASES += true="<span class='literal'>true</span>"
ALIASES += false="<span class='literal'>false</span>"
e.g. for the file names or configuration file keys.
By default, returns the same string as GetAppName().
- @wxsince{2.9.0}
+ @since 2.9.0
*/
wxString GetAppDisplayName() const;
By default, returns the same string as GetVendorName().
- @wxsince{2.9.0}
+ @since 2.9.0
*/
const wxString& GetVendorDisplayName() const;
/**
Sets the bitmap to be shown when the mouse is over the button.
- @wxsince{2.7.0}
+ @since 2.7.0
The hover bitmap is currently only supported in wxMSW.
currently selected item in it. When it is not shown, its result is the
same as for the other function.
- @wxsince{2.6.2} (before this version,
- wxControlWithItems::GetSelection() itself behaved like
- this).
+ @since 2.6.2.
+ In older versions, wxControlWithItems::GetSelection() itself
+ behaved like this.
*/
int GetCurrentSelection() const;
wxC2S_CSS_SYNTAX (which is the only one supporting alpha) is not
specified in flags.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
wxString GetAsString(long flags);
Returns @true if the conversion was successful, @false otherwise.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
void Set(unsigned char red, unsigned char green,
unsigned char blue,
@returns @true if help was shown, or @false if no help was available
for this window.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
virtual bool ShowHelpAtPoint(wxWindowBase* window, const wxPoint point,
wxHelpEvent::Origin origin);
Returns the object having the same date component as this one but time
of 00:00:00.
- @wxsince{2.8.2}
+ @since 2.8.2
@see ResetTime()
*/
See wxMemoryDC for typical usage.
- @wxsince{2.9.0}
+ @since 2.9.0
@see Blit(), wxMemoryDC, wxBitmap, wxMask
*/
makes it possible to reuse the same code to draw a figure and its mirror --
i.e. reflection related to the diagonal line x == y.
- @wxsince{2.5.0}
+ @since 2.5.0
@library{wxcore}
@category{dc}
library, @false otherwise. Unlike GetSymbol(),
this function doesn't log an error message if the symbol is not found.
- @wxsince{2.5.4}
+ @since 2.5.4
*/
bool HasSymbol(const wxString& name) const;
other platforms (you can still distinguish simple clicks from double-clicks as
they generate different kinds of events however).
- @wxsince{2.9.0}
+ @since 2.9.0
*/
int GetClickCount() const;
and @a free parameters may be @NULL if the corresponding information is not
needed.
- @wxsince{2.3.2}
+ @since 2.3.2
@note The generic Unix implementation depends on the system having the
@c statfs() or @c statvfs() function.
specify added file's MIME type. This version should be used whenever you know
the MIME type, because it makes accessing the files faster.
- @wxsince{2.8.5}
+ @since 2.8.5
@see AddFile()
*/
wxLanguageInfo structure. See AddLanguage() for
the wxLanguageInfo description.
- @wxsince{2.7.1}.
+ @since 2.7.1.
*/
static bool IsAvailable(int lang);
Returns the item located at @e point, or @c wxNOT_FOUND if there
is no item located at @e point.
- @wxsince{2.7.0}. It is currently implemented
- for wxMSW, wxMac and wxGTK2
- ports.
+ It is currently implemented for wxMSW, wxMac and wxGTK2 ports.
@param point
Point of item (in client coordinates) to obtain
@returns Item located at point, or wxNOT_FOUND if unimplemented or the
item does not exist.
+
+ @since 2.7.0
*/
int HitTest(const wxPoint point) const;
@a code can be one of @c wxLIST_RECT_BOUNDS,
@c wxLIST_RECT_ICON or @c wxLIST_RECT_LABEL.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
bool GetSubItemRect(long item, long subItem, wxRect& rect,
int code = wxLIST_RECT_BOUNDS) const;
guaranteed to be large enough to be able to contain all integer types and
pointers.
- @wxsince{2.8.4}
+ @since 2.8.4
*/
bool SetItemPtrData(long item, wxUIntPtr data);
/**
Assignment operator from unsigned long long. The sign bit will be copied too.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
wxLongLong& operator operator=(const wxULongLong& ll);
};
boundaries so it might not be the case if words are too long). If @e width
is negative, no wrapping is done.
- @wxsince{2.6.2}
+ @since 2.6.2
*/
void Wrap(int width);
};
- Windows: @c C:\\Documents @c and @c Settings\\username\\Documents
- Mac: @c ~/Documents
- @wxsince{2.7.0}
+ @since 2.7.0
*/
wxString GetDocumentsDir() const;
different for message catalog category under Unix where it returns the standard
@c prefix/share/locale/lang/LC_MESSAGES directory.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
wxString GetLocalizedResourcesDir(const wxString& lang,
ResourceCat category = ResourceCat_None) const;
- Windows: the directory where the executable file is located
- Mac: @c appname.app/Contents/Resources bundle subdirectory
- @wxsince{2.7.0}
+ @since 2.7.0
@see GetLocalizedResourcesDir()
*/
it is best to use wxFileName::CreateTempFileName for correct behaviour when
multiple processes are attempting to create temporary files.
- @wxsince{2.7.2}
+ @since 2.7.2
*/
wxString GetTempDir() const;
Note this does not mean that a given string will be correctly converted.
A malformed string may still make conversion functions return @c wxCONV_FAILED.
- @wxsince{2.8.2}
+ @since 2.8.2
*/
bool IsOk() const;
(this is always the case for socket streams for example), returns
@c wxInvalidOffset.
- @wxsince{2.5.4}
+ @since 2.5.4
*/
wxFileOffset GetLength() const;
without @a len parameter takes NUL-terminated data.
This is a convenience method useful when storing binary data in wxString.
- @wxsince{2.8.4}
+ @since 2.8.4
@see wxString::To8BitData
*/
a wxCharBuffer (Unicode builds only).
This is a convenience method useful when storing binary data in wxString.
- @wxsince{2.8.4}
+ @since 2.8.4
@see wxString::From8BitData
*/
Notice that currently this function is only implemented in wxGTK2 and wxMSW
ports and does nothing under the other platforms.
- @wxsince{2.9.0}
+ @since 2.9.0
@returns @true if the auto-completion was enabled or @false if the
operation failed, typically because auto-completion is
Notice that currently this function is only implemented in wxGTK2 port and does
nothing under the other platforms.
- @wxsince{2.9.0}
+ @since 2.9.0
@returns @true if the auto-completion was enabled or @false if the
operation failed, typically because auto-completion is
This is the only difference with SetValue().
See @ref overview_progevent "this topic" for more information.
- @wxsince{2.7.1}
+ @since 2.7.1
@param value
The new value to set. It may contain newline characters if the text control
@c GetValue().empty() but can be much more efficient for the multiline
controls containing big amounts of text.
- @wxsince{2.7.1}
+ @since 2.7.1
*/
bool IsEmpty() const;
there had been no calls to this function yet or if it returned the trailing
empty token in @c wxTOKEN_RET_EMPTY_ALL mode.
- @wxsince{2.7.0}
+ @since 2.7.0
*/
wxChar GetLastDelimiter();
and can be invoked by Ctrl-Alt-middle clicking on any wxWindow which
doesn't otherwise handle this event.
- @wxsince{2.9.0}
+ @since 2.9.0
@header{wx/utils.h}
*/
Call this function to force one or both scrollbars to be always shown, even if
the window is big enough to show its entire contents without scrolling.
- @wxsince{2.9.0}
+ @since 2.9.0
@param hflag
Whether the horizontal scroll bar should always be visible.
Returns the next window after this one among the parent children or @NULL if
this window is the last child.
- @wxsince{2.8.8}
+ @since 2.8.8
@see GetPrevSibling()
*/
@NULL if
this window is the first child.
- @wxsince{2.8.8}
+ @since 2.8.8
@see GetNextSibling()
*/
ShowWithEffect(), please see their
description there.
- @wxsince{2.9.0}
+ @since 2.9.0
*/
virtual bool HideWithEffect(wxShowEffect effect,
unsigned timeout = 0,
Currently this function is only implemented in wxMSW and does the same thing as
Show() in the other ports.
- @wxsince{2.9.0}
+ @since 2.9.0
@see HideWithEffect()
*/