Fix some spelling/grammar errors in documentation
Mostly replace ungrammatical "allows to do" with correct "allows doing". Closes https://github.com/wxWidgets/wxWidgets/pull/1183
This commit is contained in:
committed by
Vadim Zeitlin
parent
84fc5c1714
commit
c68e5d0617
@@ -12,7 +12,7 @@
|
|||||||
|
|
||||||
Notice that since wxWidgets 2.9.1 bitmap display is supported by the base
|
Notice that since wxWidgets 2.9.1 bitmap display is supported by the base
|
||||||
wxButton class itself and the only tiny advantage of using this class is
|
wxButton class itself and the only tiny advantage of using this class is
|
||||||
that it allows to specify the bitmap in its constructor, unlike wxButton.
|
that it allows specifying the bitmap in its constructor, unlike wxButton.
|
||||||
Please see the base class documentation for more information about images
|
Please see the base class documentation for more information about images
|
||||||
support in wxButton.
|
support in wxButton.
|
||||||
|
|
||||||
|
@@ -88,7 +88,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
General constructor.
|
General constructor.
|
||||||
|
|
||||||
This constructor allows to specify all supported attributes by calling
|
This constructor allows specifying all supported attributes by calling
|
||||||
the appropriate methods on wxBusyInfoFlags object passed to it as
|
the appropriate methods on wxBusyInfoFlags object passed to it as
|
||||||
parameter. All of them are optional but usually at least the message
|
parameter. All of them are optional but usually at least the message
|
||||||
should be specified.
|
should be specified.
|
||||||
|
@@ -180,7 +180,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Returns the default size for the buttons. It is advised to make all the dialog
|
Returns the default size for the buttons. It is advised to make all the dialog
|
||||||
buttons of the same size and this function allows to retrieve the (platform and
|
buttons of the same size and this function allows retrieving the (platform and
|
||||||
current font dependent size) which should be the best suited for this.
|
current font dependent size) which should be the best suited for this.
|
||||||
*/
|
*/
|
||||||
static wxSize GetDefaultSize();
|
static wxSize GetDefaultSize();
|
||||||
|
@@ -244,7 +244,7 @@ enum wxCalendarHitTestResult
|
|||||||
|
|
||||||
An item without custom attributes is drawn with the default colours and
|
An item without custom attributes is drawn with the default colours and
|
||||||
font and without border, but setting custom attributes with SetAttr()
|
font and without border, but setting custom attributes with SetAttr()
|
||||||
allows to modify its appearance. Just create a custom attribute object and
|
allows modifying its appearance. Just create a custom attribute object and
|
||||||
set it for the day you want to be displayed specially (note that the
|
set it for the day you want to be displayed specially (note that the
|
||||||
control will take ownership of the pointer, i.e. it will delete it itself).
|
control will take ownership of the pointer, i.e. it will delete it itself).
|
||||||
A day may be marked as being a holiday, even if it is not recognized as
|
A day may be marked as being a holiday, even if it is not recognized as
|
||||||
|
@@ -165,7 +165,7 @@ public:
|
|||||||
until this function is called again with @false.
|
until this function is called again with @false.
|
||||||
|
|
||||||
On the other platforms, there is no PRIMARY selection and so all
|
On the other platforms, there is no PRIMARY selection and so all
|
||||||
clipboard operations will fail. This allows to implement the standard
|
clipboard operations will fail. This allows implementing the standard
|
||||||
X11 handling of the clipboard which consists in copying data to the
|
X11 handling of the clipboard which consists in copying data to the
|
||||||
CLIPBOARD selection only when the user explicitly requests it (i.e. by
|
CLIPBOARD selection only when the user explicitly requests it (i.e. by
|
||||||
selecting the "Copy" menu command) but putting the currently selected
|
selecting the "Copy" menu command) but putting the currently selected
|
||||||
|
@@ -35,7 +35,7 @@ wxEventType wxEVT_COLOURPICKER_CHANGED;
|
|||||||
Shows the colour in HTML form (AABBCC) as colour button label
|
Shows the colour in HTML form (AABBCC) as colour button label
|
||||||
(instead of no label at all).
|
(instead of no label at all).
|
||||||
@style{wxCLRP_SHOW_ALPHA}
|
@style{wxCLRP_SHOW_ALPHA}
|
||||||
Allows to select opacity in the colour-chooser (effective under
|
Allows selecting opacity in the colour-chooser (effective under
|
||||||
wxGTK and wxOSX).
|
wxGTK and wxOSX).
|
||||||
@endStyleTable
|
@endStyleTable
|
||||||
|
|
||||||
|
@@ -596,8 +596,8 @@ public:
|
|||||||
/**
|
/**
|
||||||
Enable or disable support for the long options.
|
Enable or disable support for the long options.
|
||||||
|
|
||||||
As long options are not (yet) POSIX-compliant, this option allows to
|
As long options are not (yet) POSIX-compliant, this option allows
|
||||||
disable them.
|
disabling them.
|
||||||
|
|
||||||
@see @ref cmdlineparser_customization and AreLongOptionsEnabled()
|
@see @ref cmdlineparser_customization and AreLongOptionsEnabled()
|
||||||
*/
|
*/
|
||||||
|
@@ -87,7 +87,7 @@ wxEventType wxEVT_COLLAPSIBLEPANE_CHANGED;
|
|||||||
The default style. It includes wxTAB_TRAVERSAL and wxBORDER_NONE.
|
The default style. It includes wxTAB_TRAVERSAL and wxBORDER_NONE.
|
||||||
@style{wxCP_NO_TLW_RESIZE}
|
@style{wxCP_NO_TLW_RESIZE}
|
||||||
By default wxCollapsiblePane resizes the top level window containing it
|
By default wxCollapsiblePane resizes the top level window containing it
|
||||||
when its own size changes. This allows to easily implement dialogs
|
when its own size changes. This allows easily implementing dialogs
|
||||||
containing an optionally shown part, for example, and so is the default
|
containing an optionally shown part, for example, and so is the default
|
||||||
behaviour but can be inconvenient in some specific cases -- use this
|
behaviour but can be inconvenient in some specific cases -- use this
|
||||||
flag to disable this automatic parent resizing then.
|
flag to disable this automatic parent resizing then.
|
||||||
|
@@ -1634,7 +1634,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Set custom colours and/or font to use for the header.
|
Set custom colours and/or font to use for the header.
|
||||||
|
|
||||||
This method allows to customize the display of the control header (it
|
This method allows customizing the display of the control header (it
|
||||||
does nothing if @c wxDV_NO_HEADER style is used).
|
does nothing if @c wxDV_NO_HEADER style is used).
|
||||||
|
|
||||||
Currently it is only implemented in the generic version and just
|
Currently it is only implemented in the generic version and just
|
||||||
|
@@ -164,7 +164,7 @@ public:
|
|||||||
};
|
};
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Date calculations often depend on the country and wxDateTime allows to set
|
Date calculations often depend on the country and wxDateTime allows setting
|
||||||
the country whose conventions should be used using SetCountry(). It takes
|
the country whose conventions should be used using SetCountry(). It takes
|
||||||
one of the following values as parameter.
|
one of the following values as parameter.
|
||||||
*/
|
*/
|
||||||
@@ -795,7 +795,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Returns the difference between this object and @a dt as a wxDateSpan.
|
Returns the difference between this object and @a dt as a wxDateSpan.
|
||||||
|
|
||||||
This method allows to find the number of entire years, months, weeks and
|
This method allows finding the number of entire years, months, weeks and
|
||||||
days between @a dt and this date.
|
days between @a dt and this date.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
|
@@ -146,7 +146,7 @@ struct wxFontMetrics
|
|||||||
stated. Logical units are arbitrary units mapped to device units using
|
stated. Logical units are arbitrary units mapped to device units using
|
||||||
the current mapping mode (see wxDC::SetMapMode).
|
the current mapping mode (see wxDC::SetMapMode).
|
||||||
|
|
||||||
This mechanism allows to reuse the same code which prints on e.g. a window
|
This mechanism allows reusing the same code which prints on e.g. a window
|
||||||
on the screen to print on e.g. a paper.
|
on the screen to print on e.g. a paper.
|
||||||
|
|
||||||
|
|
||||||
@@ -853,7 +853,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Returns the various font characteristics.
|
Returns the various font characteristics.
|
||||||
|
|
||||||
This method allows to retrieve some of the font characteristics not
|
This method allows retrieving some of the font characteristics not
|
||||||
returned by GetTextExtent(), notably internal leading and average
|
returned by GetTextExtent(), notably internal leading and average
|
||||||
character width.
|
character width.
|
||||||
|
|
||||||
@@ -1213,7 +1213,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Copy from a source DC to this DC possibly changing the scale.
|
Copy from a source DC to this DC possibly changing the scale.
|
||||||
|
|
||||||
Unlike Blit(), this method allows to specify different source and
|
Unlike Blit(), this method allows specifying different source and
|
||||||
destination region sizes, meaning that it can stretch or shrink it
|
destination region sizes, meaning that it can stretch or shrink it
|
||||||
while copying. The same can be achieved by changing the scale of the
|
while copying. The same can be achieved by changing the scale of the
|
||||||
source or target DC but calling this method is simpler and can also be
|
source or target DC but calling this method is simpler and can also be
|
||||||
|
@@ -74,7 +74,7 @@ public:
|
|||||||
way (e.g. automatically uploaded to a remote server) but if the user is
|
way (e.g. automatically uploaded to a remote server) but if the user is
|
||||||
asked to manually upload or send the report, it may be more convenient
|
asked to manually upload or send the report, it may be more convenient
|
||||||
to generate it in e.g. the users home directory and this function
|
to generate it in e.g. the users home directory and this function
|
||||||
allows to do this.
|
allows doing this.
|
||||||
|
|
||||||
Notice that it should be called before wxDebugReport::Process() or it
|
Notice that it should be called before wxDebugReport::Process() or it
|
||||||
has no effect.
|
has no effect.
|
||||||
@@ -90,8 +90,8 @@ public:
|
|||||||
/**
|
/**
|
||||||
Set the base name of the generated debug report file.
|
Set the base name of the generated debug report file.
|
||||||
|
|
||||||
This function is similar to SetCompressedFileDirectory() but allows to
|
This function is similar to SetCompressedFileDirectory() but allows
|
||||||
change the base name of the file. Notice that the file extension will
|
changing the base name of the file. Notice that the file extension will
|
||||||
always be @c .zip.
|
always be @c .zip.
|
||||||
|
|
||||||
By default, a unique name constructed from wxApp::GetAppName(), the
|
By default, a unique name constructed from wxApp::GetAppName(), the
|
||||||
|
@@ -292,7 +292,7 @@ enum wxBorder
|
|||||||
|
|
||||||
/* wxCommandEvents and the objects of the derived classes are forwarded to the */
|
/* wxCommandEvents and the objects of the derived classes are forwarded to the */
|
||||||
/* parent window and so on recursively by default. Using this flag for the */
|
/* parent window and so on recursively by default. Using this flag for the */
|
||||||
/* given window allows to block this propagation at this window, i.e. prevent */
|
/* given window allows blocking this propagation at this window, i.e. preventing */
|
||||||
/* the events from being propagated further upwards. The dialogs have this */
|
/* the events from being propagated further upwards. The dialogs have this */
|
||||||
/* flag on by default. */
|
/* flag on by default. */
|
||||||
#define wxWS_EX_BLOCK_EVENTS 0x00000002
|
#define wxWS_EX_BLOCK_EVENTS 0x00000002
|
||||||
|
@@ -590,7 +590,7 @@ public:
|
|||||||
EndModal().
|
EndModal().
|
||||||
|
|
||||||
Notice that it is possible to call ShowModal() for a dialog which had
|
Notice that it is possible to call ShowModal() for a dialog which had
|
||||||
been previously shown with Show(), this allows to make an existing
|
been previously shown with Show(), this allows making an existing
|
||||||
modeless dialog modal. However ShowModal() can't be called twice
|
modeless dialog modal. However ShowModal() can't be called twice
|
||||||
without intervening EndModal() calls.
|
without intervening EndModal() calls.
|
||||||
|
|
||||||
|
@@ -162,7 +162,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Sometimes the built-in logic for determining the online status may
|
Sometimes the built-in logic for determining the online status may
|
||||||
fail, so, in general, the user should be allowed to override it. This
|
fail, so, in general, the user should be allowed to override it. This
|
||||||
function allows to forcefully set the online status - whatever our
|
function allows forcefully setting the online status - whatever our
|
||||||
internal algorithm may think about it.
|
internal algorithm may think about it.
|
||||||
|
|
||||||
@see IsOnline()
|
@see IsOnline()
|
||||||
|
@@ -137,7 +137,7 @@ enum wxDirFlags
|
|||||||
@class wxDir
|
@class wxDir
|
||||||
|
|
||||||
wxDir is a portable equivalent of Unix open/read/closedir functions which
|
wxDir is a portable equivalent of Unix open/read/closedir functions which
|
||||||
allow enumerating of the files in a directory. wxDir allows to enumerate
|
allow enumerating of the files in a directory. wxDir allows enumerating
|
||||||
files as well as directories.
|
files as well as directories.
|
||||||
|
|
||||||
wxDir also provides a flexible way to enumerate files recursively using
|
wxDir also provides a flexible way to enumerate files recursively using
|
||||||
|
@@ -279,7 +279,7 @@ protected:
|
|||||||
/**
|
/**
|
||||||
@class wxEventBlocker
|
@class wxEventBlocker
|
||||||
|
|
||||||
This class is a special event handler which allows to discard
|
This class is a special event handler which allows discarding
|
||||||
any event (or a set of event types) directed to a specific window.
|
any event (or a set of event types) directed to a specific window.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
@@ -713,7 +713,7 @@ public:
|
|||||||
usage, it has no advantages compared to Bind().
|
usage, it has no advantages compared to Bind().
|
||||||
|
|
||||||
This is an alternative to the use of static event tables. It is more
|
This is an alternative to the use of static event tables. It is more
|
||||||
flexible as it allows to connect events generated by some object to an
|
flexible as it allows connecting events generated by some object to an
|
||||||
event handler defined in a different object of a different class (which
|
event handler defined in a different object of a different class (which
|
||||||
is impossible to do directly with the event tables -- the events can be
|
is impossible to do directly with the event tables -- the events can be
|
||||||
only handled in another object if they are propagated upwards to it).
|
only handled in another object if they are propagated upwards to it).
|
||||||
@@ -2477,8 +2477,8 @@ public:
|
|||||||
@c wxEVT_TEXT_CUT and @c wxEVT_TEXT_PASTE.
|
@c wxEVT_TEXT_CUT and @c wxEVT_TEXT_PASTE.
|
||||||
|
|
||||||
If any of these events is processed (without being skipped) by an event
|
If any of these events is processed (without being skipped) by an event
|
||||||
handler, the corresponding operation doesn't take place which allows to
|
handler, the corresponding operation doesn't take place which allows
|
||||||
prevent the text from being copied from or pasted to a control. It is also
|
preventing the text from being copied from or pasted to a control. It is also
|
||||||
possible to examine the clipboard contents in the PASTE event handler and
|
possible to examine the clipboard contents in the PASTE event handler and
|
||||||
transform it in some way before inserting in a control -- for example,
|
transform it in some way before inserting in a control -- for example,
|
||||||
changing its case or removing invalid characters.
|
changing its case or removing invalid characters.
|
||||||
@@ -3023,7 +3023,7 @@ public:
|
|||||||
bool GetActive() const;
|
bool GetActive() const;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Allows to check if the window was activated by clicking it with the
|
Allows checking if the window was activated by clicking it with the
|
||||||
mouse or in some other way.
|
mouse or in some other way.
|
||||||
|
|
||||||
This method is currently only implemented in wxMSW and returns @c
|
This method is currently only implemented in wxMSW and returns @c
|
||||||
|
@@ -13,8 +13,8 @@
|
|||||||
|
|
||||||
This is a very simple class which just provides FilterEvent() virtual
|
This is a very simple class which just provides FilterEvent() virtual
|
||||||
method to be called by wxEvtHandler before starting process of any event.
|
method to be called by wxEvtHandler before starting process of any event.
|
||||||
Thus, inheriting from this class and overriding FilterEvent() allows to
|
Thus, inheriting from this class and overriding FilterEvent() allows
|
||||||
capture and possibly handle or ignore all the events happening in the
|
capturing and possibly handling or ignoring all the events happening in the
|
||||||
program. Of course, having event filters adds additional overhead to every
|
program. Of course, having event filters adds additional overhead to every
|
||||||
event processing and so should not be used lightly and your FilterEvent()
|
event processing and so should not be used lightly and your FilterEvent()
|
||||||
code should try to return as quickly as possible, especially for the events
|
code should try to return as quickly as possible, especially for the events
|
||||||
@@ -22,7 +22,7 @@
|
|||||||
|
|
||||||
An example of using this class:
|
An example of using this class:
|
||||||
@code
|
@code
|
||||||
// This class allows to determine the last time the user has worked with
|
// This class allows determining the last time the user has worked with
|
||||||
// this application:
|
// this application:
|
||||||
class LastActivityTimeDetector : public wxEventFilter
|
class LastActivityTimeDetector : public wxEventFilter
|
||||||
{
|
{
|
||||||
@@ -72,8 +72,8 @@
|
|||||||
filter during its creation so you may also override FilterEvent() method in
|
filter during its creation so you may also override FilterEvent() method in
|
||||||
your wxApp-derived class and, in fact, this is often the most convenient
|
your wxApp-derived class and, in fact, this is often the most convenient
|
||||||
way to do it. However creating a new class deriving directly from
|
way to do it. However creating a new class deriving directly from
|
||||||
wxEventFilter allows to isolate the event filtering code in its own
|
wxEventFilter allows isolating the event filtering code in its own
|
||||||
separate class and also to have several independent filters, if necessary.
|
separate class and also having several independent filters, if necessary.
|
||||||
|
|
||||||
@category{events}
|
@category{events}
|
||||||
|
|
||||||
@@ -118,7 +118,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Override this method to implement event pre-processing.
|
Override this method to implement event pre-processing.
|
||||||
|
|
||||||
This method allows to filter all the events processed by the program,
|
This method allows filtering all the events processed by the program,
|
||||||
so you should try to return quickly from it to avoid slowing down the
|
so you should try to return quickly from it to avoid slowing down the
|
||||||
program to a crawl.
|
program to a crawl.
|
||||||
|
|
||||||
|
@@ -96,7 +96,7 @@ public:
|
|||||||
virtual bool Save(wxOutputStream& os, const wxMBConv& conv = wxConvAuto());
|
virtual bool Save(wxOutputStream& os, const wxMBConv& conv = wxConvAuto());
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Allows to set the mode to be used for the config file creation. For example, to
|
Allows setting the mode to be used for the config file creation. For example, to
|
||||||
create a config file which is not readable by other users (useful if it stores
|
create a config file which is not readable by other users (useful if it stores
|
||||||
some sensitive information, such as passwords), you could use @c SetUmask(0077).
|
some sensitive information, such as passwords), you could use @c SetUmask(0077).
|
||||||
|
|
||||||
|
@@ -193,7 +193,7 @@ wxULongLong wxInvalidSize;
|
|||||||
invalid state and wxFileName::IsOk() returns false for it.
|
invalid state and wxFileName::IsOk() returns false for it.
|
||||||
|
|
||||||
File names can be case-sensitive or not, the function wxFileName::IsCaseSensitive()
|
File names can be case-sensitive or not, the function wxFileName::IsCaseSensitive()
|
||||||
allows to determine this. The rules for determining whether the file name is
|
allows determining this. The rules for determining whether the file name is
|
||||||
absolute or relative also depend on the file name format and the only portable way
|
absolute or relative also depend on the file name format and the only portable way
|
||||||
to answer this question is to use wxFileName::IsAbsolute() or wxFileName::IsRelative()
|
to answer this question is to use wxFileName::IsAbsolute() or wxFileName::IsRelative()
|
||||||
method.
|
method.
|
||||||
@@ -517,7 +517,7 @@ public:
|
|||||||
|
|
||||||
By default, all operations in this class work on the target of a
|
By default, all operations in this class work on the target of a
|
||||||
symbolic link (symlink) if the path of the file is actually a symlink.
|
symbolic link (symlink) if the path of the file is actually a symlink.
|
||||||
Using this method allows to turn off this "symlink following" behaviour
|
Using this method allows turning off this "symlink following" behaviour
|
||||||
and apply the operations to this path itself, even if it is a symlink.
|
and apply the operations to this path itself, even if it is a symlink.
|
||||||
|
|
||||||
The following methods are currently affected by this option:
|
The following methods are currently affected by this option:
|
||||||
|
@@ -204,7 +204,7 @@ public:
|
|||||||
automatically synchronized with button's value. Use functions
|
automatically synchronized with button's value. Use functions
|
||||||
defined in wxPickerBase to modify the text control.
|
defined in wxPickerBase to modify the text control.
|
||||||
@style{wxDIRP_DIR_MUST_EXIST}
|
@style{wxDIRP_DIR_MUST_EXIST}
|
||||||
Creates a picker which allows to select only existing directories in
|
Creates a picker which allows selecting only existing directories in
|
||||||
the popup wxDirDialog. Notice that, as with @c wxFLP_FILE_MUST_EXIST,
|
the popup wxDirDialog. Notice that, as with @c wxFLP_FILE_MUST_EXIST,
|
||||||
it is still possible to enter a non-existent directory even when
|
it is still possible to enter a non-existent directory even when
|
||||||
this file is specified if @c wxDIRP_USE_TEXTCTRL style is also used.
|
this file is specified if @c wxDIRP_USE_TEXTCTRL style is also used.
|
||||||
|
@@ -11,7 +11,7 @@
|
|||||||
the generic properties of the font without hardcoding in the sources a specific
|
the generic properties of the font without hardcoding in the sources a specific
|
||||||
face name.
|
face name.
|
||||||
|
|
||||||
wxFontFamily thus allows to group the font face names of fonts with similar
|
wxFontFamily thus allows grouping the font face names of fonts with similar
|
||||||
properties. Most wxWidgets ports use lists of fonts for each font family
|
properties. Most wxWidgets ports use lists of fonts for each font family
|
||||||
inspired by the data taken from http://www.codestyle.org/css/font-family.
|
inspired by the data taken from http://www.codestyle.org/css/font-family.
|
||||||
*/
|
*/
|
||||||
@@ -291,7 +291,7 @@ enum wxFontEncoding
|
|||||||
@class wxFontInfo
|
@class wxFontInfo
|
||||||
|
|
||||||
This class is a helper used for wxFont creation using named parameter
|
This class is a helper used for wxFont creation using named parameter
|
||||||
idiom: it allows to specify various wxFont attributes using the chained
|
idiom: it allows specifying various wxFont attributes using the chained
|
||||||
calls to its clearly named methods instead of passing them in the fixed
|
calls to its clearly named methods instead of passing them in the fixed
|
||||||
order to wxFont constructors.
|
order to wxFont constructors.
|
||||||
|
|
||||||
@@ -1169,7 +1169,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Sets the font size using a predefined symbolic size name.
|
Sets the font size using a predefined symbolic size name.
|
||||||
|
|
||||||
This function allows to change font size to be (very) large or small
|
This function allows changing font size to be (very) large or small
|
||||||
compared to the standard font size.
|
compared to the standard font size.
|
||||||
|
|
||||||
@see SetSymbolicSizeRelativeTo().
|
@see SetSymbolicSizeRelativeTo().
|
||||||
|
@@ -10,7 +10,7 @@
|
|||||||
/**
|
/**
|
||||||
@class wxFileSystemWatcher
|
@class wxFileSystemWatcher
|
||||||
|
|
||||||
The wxFileSystemWatcher class allows to receive notifications of file
|
The wxFileSystemWatcher class allows receiving notifications of file
|
||||||
system changes.
|
system changes.
|
||||||
|
|
||||||
@note Implementation limitations: this class is currently implemented for
|
@note Implementation limitations: this class is currently implemented for
|
||||||
|
@@ -1220,7 +1220,7 @@ void wxSetCursor(const wxCursor& cursor);
|
|||||||
/**
|
/**
|
||||||
Returns the dimensions of the work area on the display.
|
Returns the dimensions of the work area on the display.
|
||||||
|
|
||||||
This is the same as wxGetClientDisplayRect() but allows to retrieve the
|
This is the same as wxGetClientDisplayRect() but allows retrieving the
|
||||||
individual components instead of the entire rectangle.
|
individual components instead of the entire rectangle.
|
||||||
|
|
||||||
Any of the output pointers can be @NULL if the corresponding value is not
|
Any of the output pointers can be @NULL if the corresponding value is not
|
||||||
|
@@ -1565,7 +1565,7 @@ public:
|
|||||||
@class wxGraphicsPenInfo
|
@class wxGraphicsPenInfo
|
||||||
|
|
||||||
This class is a helper used for wxGraphicsPen creation using named parameter
|
This class is a helper used for wxGraphicsPen creation using named parameter
|
||||||
idiom: it allows to specify various wxGraphicsPen attributes using the chained
|
idiom: it allows specifying various wxGraphicsPen attributes using the chained
|
||||||
calls to its clearly named methods instead of passing them in the fixed
|
calls to its clearly named methods instead of passing them in the fixed
|
||||||
order to wxGraphicsPen constructors.
|
order to wxGraphicsPen constructors.
|
||||||
|
|
||||||
|
@@ -901,7 +901,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
This class is reference counted: it is created with ref count of 1, so
|
This class is reference counted: it is created with ref count of 1, so
|
||||||
calling DecRef() once will delete it. Calling IncRef() allows to lock
|
calling DecRef() once will delete it. Calling IncRef() allows locking
|
||||||
it until the matching DecRef() is called.
|
it until the matching DecRef() is called.
|
||||||
*/
|
*/
|
||||||
void DecRef();
|
void DecRef();
|
||||||
@@ -1005,7 +1005,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
This class is reference counted: it is created with ref count of 1, so
|
This class is reference counted: it is created with ref count of 1, so
|
||||||
calling DecRef() once will delete it. Calling IncRef() allows to lock
|
calling DecRef() once will delete it. Calling IncRef() allows locking
|
||||||
it until the matching DecRef() is called.
|
it until the matching DecRef() is called.
|
||||||
*/
|
*/
|
||||||
void IncRef();
|
void IncRef();
|
||||||
@@ -2935,7 +2935,7 @@ public:
|
|||||||
The base class version returns the editor which was associated with the
|
The base class version returns the editor which was associated with the
|
||||||
specified @a typeName when it was registered RegisterDataType() but
|
specified @a typeName when it was registered RegisterDataType() but
|
||||||
this function may be overridden to return something different. This
|
this function may be overridden to return something different. This
|
||||||
allows to override an editor used for one of the standard types.
|
allows overriding an editor used for one of the standard types.
|
||||||
|
|
||||||
The caller must call DecRef() on the returned pointer.
|
The caller must call DecRef() on the returned pointer.
|
||||||
*/
|
*/
|
||||||
@@ -3667,7 +3667,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Disable interactive resizing of the specified column.
|
Disable interactive resizing of the specified column.
|
||||||
|
|
||||||
This method allows to disable resizing of an individual column in a
|
This method allows one to disable resizing of an individual column in a
|
||||||
grid where the columns are otherwise resizable (which is the case by
|
grid where the columns are otherwise resizable (which is the case by
|
||||||
default).
|
default).
|
||||||
|
|
||||||
@@ -4625,7 +4625,7 @@ public:
|
|||||||
Sets the extra margins used around the grid area.
|
Sets the extra margins used around the grid area.
|
||||||
|
|
||||||
A grid may occupy more space than needed for its data display and
|
A grid may occupy more space than needed for its data display and
|
||||||
this function allows to set how big this extra space is
|
this function allows setting how big this extra space is
|
||||||
*/
|
*/
|
||||||
void SetMargins(int extraWidth, int extraHeight);
|
void SetMargins(int extraWidth, int extraHeight);
|
||||||
|
|
||||||
|
@@ -248,7 +248,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Set the column flags.
|
Set the column flags.
|
||||||
|
|
||||||
This method allows to set all flags at once, see also generic
|
This method allows setting all flags at once, see also generic
|
||||||
ChangeFlag(), SetFlag(), ClearFlag() and ToggleFlag() methods below as
|
ChangeFlag(), SetFlag(), ClearFlag() and ToggleFlag() methods below as
|
||||||
well as specific SetResizeable(), SetSortable(), SetReorderable() and
|
well as specific SetResizeable(), SetSortable(), SetReorderable() and
|
||||||
SetHidden() ones.
|
SetHidden() ones.
|
||||||
|
@@ -156,7 +156,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
If the help viewer is not running, runs it, and searches for sections matching
|
If the help viewer is not running, runs it, and searches for sections matching
|
||||||
the given keyword. If one match is found, the file is displayed at this section.
|
the given keyword. If one match is found, the file is displayed at this section.
|
||||||
The optional parameter allows to search the index (wxHELP_SEARCH_INDEX)
|
The optional parameter allows searching the index (wxHELP_SEARCH_INDEX)
|
||||||
but this currently is only supported by the wxHtmlHelpController.
|
but this currently is only supported by the wxHtmlHelpController.
|
||||||
|
|
||||||
- @e WinHelp, MS HTML Help:
|
- @e WinHelp, MS HTML Help:
|
||||||
|
@@ -476,7 +476,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Detach a child cell.
|
Detach a child cell.
|
||||||
|
|
||||||
Detaching a cell removes it from this container and allows to reattach
|
Detaching a cell removes it from this container and allows reattaching
|
||||||
it to another one by using InsertCell(). Alternatively, this method can
|
it to another one by using InsertCell(). Alternatively, this method can
|
||||||
be used to selectively remove some elements of the HTML document tree
|
be used to selectively remove some elements of the HTML document tree
|
||||||
by deleting the cell after calling it.
|
by deleting the cell after calling it.
|
||||||
|
@@ -97,7 +97,7 @@ protected:
|
|||||||
background of the selected cells in the same way as GetSelectedTextColour().
|
background of the selected cells in the same way as GetSelectedTextColour().
|
||||||
|
|
||||||
It should be rarely, if ever, used because wxVListBox::SetSelectionBackground
|
It should be rarely, if ever, used because wxVListBox::SetSelectionBackground
|
||||||
allows to change the selection background for all cells at once and doing
|
allows changing the selection background for all cells at once and doing
|
||||||
anything more fancy is probably going to look strangely.
|
anything more fancy is probably going to look strangely.
|
||||||
|
|
||||||
@see GetSelectedTextColour()
|
@see GetSelectedTextColour()
|
||||||
|
@@ -181,7 +181,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Attach a Windows icon handle.
|
Attach a Windows icon handle.
|
||||||
|
|
||||||
This wxMSW-specific method allows to assign a native Windows @c HICON
|
This wxMSW-specific method allows assigning a native Windows @c HICON
|
||||||
(which must be castes to @c WXHICON opaque handle type) to wxIcon.
|
(which must be castes to @c WXHICON opaque handle type) to wxIcon.
|
||||||
Notice that this means that the @c HICON will be destroyed by wxIcon
|
Notice that this means that the @c HICON will be destroyed by wxIcon
|
||||||
when it is destroyed.
|
when it is destroyed.
|
||||||
|
@@ -127,7 +127,7 @@ enum
|
|||||||
A special case of report view quite different from the other modes of the list
|
A special case of report view quite different from the other modes of the list
|
||||||
control is a virtual control in which the items data (including text, images
|
control is a virtual control in which the items data (including text, images
|
||||||
and attributes) is managed by the main program and is requested by the control
|
and attributes) is managed by the main program and is requested by the control
|
||||||
itself only when needed which allows to have controls with millions of items
|
itself only when needed which allows having controls with millions of items
|
||||||
without consuming much memory. To use virtual list control you must use
|
without consuming much memory. To use virtual list control you must use
|
||||||
wxListCtrl::SetItemCount first and override at least wxListCtrl::OnGetItemText
|
wxListCtrl::SetItemCount first and override at least wxListCtrl::OnGetItemText
|
||||||
(and optionally wxListCtrl::OnGetItemImage or wxListCtrl::OnGetItemColumnImage and
|
(and optionally wxListCtrl::OnGetItemImage or wxListCtrl::OnGetItemColumnImage and
|
||||||
@@ -453,7 +453,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Finish editing the label.
|
Finish editing the label.
|
||||||
|
|
||||||
This method allows to programmatically end editing a list control item
|
This method allows one to programmatically end editing a list control item
|
||||||
in place. Usually it will only be called when editing is in progress,
|
in place. Usually it will only be called when editing is in progress,
|
||||||
i.e. if GetEditControl() returns non-NULL. In particular, do not call
|
i.e. if GetEditControl() returns non-NULL. In particular, do not call
|
||||||
it from EVT_LIST_BEGIN_LABEL_EDIT handler as the edit control is not
|
it from EVT_LIST_BEGIN_LABEL_EDIT handler as the edit control is not
|
||||||
|
@@ -69,7 +69,7 @@ public:
|
|||||||
//@}
|
//@}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This allows to convert a double value to wxLongLong type.
|
This allows converting a double value to wxLongLong type.
|
||||||
|
|
||||||
Such conversion is not always possible in which case the result will be
|
Such conversion is not always possible in which case the result will be
|
||||||
silently truncated in a platform-dependent way.
|
silently truncated in a platform-dependent way.
|
||||||
|
@@ -306,7 +306,7 @@ public:
|
|||||||
SetWindowMenu() is called again).
|
SetWindowMenu() is called again).
|
||||||
|
|
||||||
To remove the window completely, you can use the wxFRAME_NO_WINDOW_MENU
|
To remove the window completely, you can use the wxFRAME_NO_WINDOW_MENU
|
||||||
window style but this function also allows to do it by passing @NULL
|
window style but this function also allows doing it by passing @NULL
|
||||||
pointer as @a menu.
|
pointer as @a menu.
|
||||||
|
|
||||||
The menu may include the items with the following standard identifiers
|
The menu may include the items with the following standard identifiers
|
||||||
|
@@ -7,7 +7,7 @@
|
|||||||
/////////////////////////////////////////////////////////////////////////////
|
/////////////////////////////////////////////////////////////////////////////
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Allows to intercept all modal dialog calls.
|
Allows intercepting all modal dialog calls.
|
||||||
|
|
||||||
This class can be used to hook into normal modal dialog handling for some
|
This class can be used to hook into normal modal dialog handling for some
|
||||||
special needs. One of the most common use cases is for testing: as
|
special needs. One of the most common use cases is for testing: as
|
||||||
|
@@ -10,7 +10,7 @@
|
|||||||
Simple class allowing to write strings to various output channels.
|
Simple class allowing to write strings to various output channels.
|
||||||
|
|
||||||
wxMessageOutput is a low-level class and doesn't provide any of the
|
wxMessageOutput is a low-level class and doesn't provide any of the
|
||||||
conveniences of wxLog. It simply allows to write a message to some output
|
conveniences of wxLog. It simply allows writing a message to some output
|
||||||
channel: usually file or standard error but possibly also a message box.
|
channel: usually file or standard error but possibly also a message box.
|
||||||
While use of wxLog and related functions is preferable in many cases
|
While use of wxLog and related functions is preferable in many cases
|
||||||
sometimes this simple interface may be more convenient.
|
sometimes this simple interface may be more convenient.
|
||||||
|
@@ -8,7 +8,7 @@
|
|||||||
/**
|
/**
|
||||||
@class wxMemoryOutputStream
|
@class wxMemoryOutputStream
|
||||||
|
|
||||||
This class allows to use all methods taking a wxOutputStream reference to write
|
This class allows using all methods taking a wxOutputStream reference to write
|
||||||
to in-memory data.
|
to in-memory data.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
@@ -72,7 +72,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
@class wxMemoryInputStream
|
@class wxMemoryInputStream
|
||||||
|
|
||||||
This class allows to use all methods taking a wxInputStream reference to read
|
This class allows using all methods taking a wxInputStream reference to read
|
||||||
in-memory data.
|
in-memory data.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
@@ -10,7 +10,7 @@
|
|||||||
/**
|
/**
|
||||||
@class wxNativeWindow
|
@class wxNativeWindow
|
||||||
|
|
||||||
Allows to embed a native widget in an application using wxWidgets.
|
Allows embedding a native widget in an application using wxWidgets.
|
||||||
|
|
||||||
This class can be used as a bridge between wxWidgets and native GUI
|
This class can be used as a bridge between wxWidgets and native GUI
|
||||||
toolkit, i.e. standard Windows controls under MSW, GTK+ widgets or Cocoa
|
toolkit, i.e. standard Windows controls under MSW, GTK+ widgets or Cocoa
|
||||||
|
@@ -8,7 +8,7 @@
|
|||||||
/**
|
/**
|
||||||
@class wxNotificationMessage
|
@class wxNotificationMessage
|
||||||
|
|
||||||
This class allows to show the user a message non intrusively.
|
This class allows showing the user a message non intrusively.
|
||||||
|
|
||||||
Currently it is implemented natively for Windows, OS X, GTK and uses
|
Currently it is implemented natively for Windows, OS X, GTK and uses
|
||||||
generic toast notifications under the other platforms. It's not recommended
|
generic toast notifications under the other platforms. It's not recommended
|
||||||
|
@@ -105,7 +105,7 @@ enum wxPenCap
|
|||||||
@class wxPenInfo
|
@class wxPenInfo
|
||||||
|
|
||||||
This class is a helper used for wxPen creation using named parameter
|
This class is a helper used for wxPen creation using named parameter
|
||||||
idiom: it allows to specify various wxPen attributes using the chained
|
idiom: it allows specifying various wxPen attributes using the chained
|
||||||
calls to its clearly named methods instead of passing them in the fixed
|
calls to its clearly named methods instead of passing them in the fixed
|
||||||
order to wxPen constructors.
|
order to wxPen constructors.
|
||||||
|
|
||||||
|
@@ -62,7 +62,7 @@ public:
|
|||||||
Globally disable restoring the persistence object properties.
|
Globally disable restoring the persistence object properties.
|
||||||
|
|
||||||
By default, restoring properties in Restore() is enabled but this
|
By default, restoring properties in Restore() is enabled but this
|
||||||
function allows to disable it. This is mostly useful for testing.
|
function allows disabling it. This is mostly useful for testing.
|
||||||
|
|
||||||
@see DisableSaving()
|
@see DisableSaving()
|
||||||
*/
|
*/
|
||||||
|
@@ -11,7 +11,7 @@
|
|||||||
whose version can be detected at run-time.
|
whose version can be detected at run-time.
|
||||||
|
|
||||||
The values of the constants are chosen so that they can be combined as flags;
|
The values of the constants are chosen so that they can be combined as flags;
|
||||||
this allows to check for operating system families like e.g. @c wxOS_MAC and @c wxOS_UNIX.
|
this allows checking for operating system families like e.g. @c wxOS_MAC and @c wxOS_UNIX.
|
||||||
|
|
||||||
Note that you can obtain more detailed information about the current OS
|
Note that you can obtain more detailed information about the current OS
|
||||||
version in use by checking the major, minor, and micro version numbers
|
version in use by checking the major, minor, and micro version numbers
|
||||||
|
@@ -67,7 +67,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Creates an object without any associated parent (and hence no id neither)
|
Creates an object without any associated parent (and hence no id neither)
|
||||||
but allows to specify the @a flags which can have the value of
|
but allows specifying the @a flags which can have the value of
|
||||||
@c wxPROCESS_DEFAULT or @c wxPROCESS_REDIRECT.
|
@c wxPROCESS_DEFAULT or @c wxPROCESS_REDIRECT.
|
||||||
|
|
||||||
Specifying the former value has no particular effect while using the latter
|
Specifying the former value has no particular effect while using the latter
|
||||||
@@ -174,7 +174,7 @@ public:
|
|||||||
Returns @true if there is data to be read on the child process standard
|
Returns @true if there is data to be read on the child process standard
|
||||||
output stream.
|
output stream.
|
||||||
|
|
||||||
This allows to write simple (and extremely inefficient) polling-based code
|
This allows writing simple (and extremely inefficient) polling-based code
|
||||||
waiting for a better mechanism in future wxWidgets versions.
|
waiting for a better mechanism in future wxWidgets versions.
|
||||||
See the @ref page_samples_exec "exec sample" for an example of using this
|
See the @ref page_samples_exec "exec sample" for an example of using this
|
||||||
function.
|
function.
|
||||||
|
@@ -180,8 +180,8 @@ public:
|
|||||||
|
|
||||||
Normally a Cancel button press is indicated by Update() returning
|
Normally a Cancel button press is indicated by Update() returning
|
||||||
@false but sometimes it may be more convenient to check if the dialog
|
@false but sometimes it may be more convenient to check if the dialog
|
||||||
was cancelled from elsewhere in the code and this function allows to
|
was cancelled from elsewhere in the code and this function allows
|
||||||
do it.
|
doing it.
|
||||||
|
|
||||||
It always returns @false if the Cancel button is not shown at all.
|
It always returns @false if the Cancel button is not shown at all.
|
||||||
|
|
||||||
|
@@ -229,7 +229,7 @@ wxPG_EX_NO_TOOLBAR_DIVIDER = 0x04000000,
|
|||||||
*/
|
*/
|
||||||
wxPG_EX_TOOLBAR_SEPARATOR = 0x08000000,
|
wxPG_EX_TOOLBAR_SEPARATOR = 0x08000000,
|
||||||
|
|
||||||
/** Allows to take focus on the entire area (on canvas)
|
/** Allows taking focus on the entire area (on canvas)
|
||||||
even if wxPropertyGrid is not a standalone control.
|
even if wxPropertyGrid is not a standalone control.
|
||||||
@hideinitializer
|
@hideinitializer
|
||||||
*/
|
*/
|
||||||
|
@@ -13,8 +13,8 @@
|
|||||||
A listbox-like control allowing the user to rearrange the items and to
|
A listbox-like control allowing the user to rearrange the items and to
|
||||||
enable or disable them.
|
enable or disable them.
|
||||||
|
|
||||||
This class allows to change the order of the items shown in it as well as
|
This class allows changing the order of the items shown in it as well as
|
||||||
to check or uncheck them individually. The data structure used to allow
|
checking or unchecking them individually. The data structure used to allow
|
||||||
this is the order array which contains the items indices indexed by their
|
this is the order array which contains the items indices indexed by their
|
||||||
position with an added twist that the unchecked items are represented by
|
position with an added twist that the unchecked items are represented by
|
||||||
the bitwise complement of the corresponding index (for any architecture
|
the bitwise complement of the corresponding index (for any architecture
|
||||||
|
@@ -51,7 +51,7 @@ enum wxTipKind
|
|||||||
wxTipKind_Auto
|
wxTipKind_Auto
|
||||||
};
|
};
|
||||||
/**
|
/**
|
||||||
Allows to show a tool tip with more customizations than wxToolTip.
|
Allows showing a tool tip with more customizations than wxToolTip.
|
||||||
|
|
||||||
Using this class is very simple, to give a standard warning for a password
|
Using this class is very simple, to give a standard warning for a password
|
||||||
text control if the password was entered correctly you could simply do:
|
text control if the password was entered correctly you could simply do:
|
||||||
|
@@ -73,7 +73,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Set the effects to use for showing and hiding the pages.
|
Set the effects to use for showing and hiding the pages.
|
||||||
|
|
||||||
This method allows to specify the effects passed to
|
This method allows specifying the effects passed to
|
||||||
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() respectively
|
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() respectively
|
||||||
when the pages need to be shown or hidden.
|
when the pages need to be shown or hidden.
|
||||||
|
|
||||||
@@ -102,7 +102,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Set the effect timeout to use for showing and hiding the pages.
|
Set the effect timeout to use for showing and hiding the pages.
|
||||||
|
|
||||||
This method allows to configure the timeout arguments passed to
|
This method allows configuring the timeout arguments passed to
|
||||||
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() if a
|
wxWindow::ShowWithEffect() and wxWindow::HideWithEffect() if a
|
||||||
non-default effect is used.
|
non-default effect is used.
|
||||||
|
|
||||||
|
@@ -8,7 +8,7 @@
|
|||||||
/**
|
/**
|
||||||
@class wxSingleInstanceChecker
|
@class wxSingleInstanceChecker
|
||||||
|
|
||||||
wxSingleInstanceChecker class allows to check that only a single instance of a
|
wxSingleInstanceChecker class allows checking that only a single instance of a
|
||||||
program is running.
|
program is running.
|
||||||
|
|
||||||
To do it, you should create an object of this class. As long as this object
|
To do it, you should create an object of this class. As long as this object
|
||||||
|
@@ -6829,7 +6829,7 @@ public:
|
|||||||
void SetWrapVisualFlags(int wrapVisualFlags);
|
void SetWrapVisualFlags(int wrapVisualFlags);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Retrive the display mode of visual flags for wrapped lines.
|
Retrieve the display mode of visual flags for wrapped lines.
|
||||||
|
|
||||||
The return value will be a bit list containing one or more of the
|
The return value will be a bit list containing one or more of the
|
||||||
@link wxStyledTextCtrl::wxSTC_WRAPVISUALFLAG_NONE wxSTC_WRAPVISUALFLAG_* @endlink constants.
|
@link wxStyledTextCtrl::wxSTC_WRAPVISUALFLAG_NONE wxSTC_WRAPVISUALFLAG_* @endlink constants.
|
||||||
@@ -6845,7 +6845,7 @@ public:
|
|||||||
void SetWrapVisualFlagsLocation(int wrapVisualFlagsLocation);
|
void SetWrapVisualFlagsLocation(int wrapVisualFlagsLocation);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Retrive the location of visual flags for wrapped lines.
|
Retrieve the location of visual flags for wrapped lines.
|
||||||
|
|
||||||
The return value will be a bit list containing one or more of the
|
The return value will be a bit list containing one or more of the
|
||||||
@link wxStyledTextCtrl::wxSTC_WRAPVISUALFLAGLOC_DEFAULT wxSTC_WRAPVISUALFLAGLOC_* @endlink constants.
|
@link wxStyledTextCtrl::wxSTC_WRAPVISUALFLAGLOC_DEFAULT wxSTC_WRAPVISUALFLAGLOC_* @endlink constants.
|
||||||
@@ -6858,7 +6858,7 @@ public:
|
|||||||
void SetWrapStartIndent(int indent);
|
void SetWrapStartIndent(int indent);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Retrive the start indent for wrapped lines.
|
Retrieve the start indent for wrapped lines.
|
||||||
*/
|
*/
|
||||||
int GetWrapStartIndent() const;
|
int GetWrapStartIndent() const;
|
||||||
|
|
||||||
|
@@ -39,7 +39,7 @@ enum wxStockLabelQueryFlag
|
|||||||
Return the label without any ellipsis at the end.
|
Return the label without any ellipsis at the end.
|
||||||
|
|
||||||
By default, stock items text is returned with ellipsis, if appropriate,
|
By default, stock items text is returned with ellipsis, if appropriate,
|
||||||
this flag allows to avoid having it. So using the same example as
|
this flag allows one to avoid having it. So using the same example as
|
||||||
above, the returned string would be "Print" or "&Print" if
|
above, the returned string would be "Print" or "&Print" if
|
||||||
wxSTOCK_WITH_MNEMONIC were also used.
|
wxSTOCK_WITH_MNEMONIC were also used.
|
||||||
|
|
||||||
|
@@ -86,7 +86,7 @@ public:
|
|||||||
|
|
||||||
This is the most general function for converting a multibyte string to
|
This is the most general function for converting a multibyte string to
|
||||||
a wide string, cMB2WC() may be often more convenient, however this
|
a wide string, cMB2WC() may be often more convenient, however this
|
||||||
function is the most efficient one as it allows to avoid any
|
function is the most efficient one as it allows avoiding any
|
||||||
unnecessary copying.
|
unnecessary copying.
|
||||||
|
|
||||||
The main case is when @a dst is not @NULL and @a srcLen is not
|
The main case is when @a dst is not @NULL and @a srcLen is not
|
||||||
|
@@ -2038,7 +2038,7 @@ public:
|
|||||||
//@{
|
//@{
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Allows to extend a function with the signature:
|
Allows extending a function with the signature:
|
||||||
@code bool SomeFunc(const wxUniChar& c) @endcode
|
@code bool SomeFunc(const wxUniChar& c) @endcode
|
||||||
which operates on a single character, to an entire wxString.
|
which operates on a single character, to an entire wxString.
|
||||||
|
|
||||||
|
@@ -34,7 +34,7 @@
|
|||||||
If set to non-zero value, abort the program if an assertion fails. The
|
If set to non-zero value, abort the program if an assertion fails. The
|
||||||
default behaviour in case of assertion failure depends on the build mode
|
default behaviour in case of assertion failure depends on the build mode
|
||||||
and can be changed by overriding wxApp::OnAssertFailure() but setting
|
and can be changed by overriding wxApp::OnAssertFailure() but setting
|
||||||
this option allows to change it without modifying the program code and
|
this option allows changing it without modifying the program code and
|
||||||
also applies to asserts which may happen before the wxApp object
|
also applies to asserts which may happen before the wxApp object
|
||||||
creation or after its destruction.
|
creation or after its destruction.
|
||||||
@endFlagTable
|
@endFlagTable
|
||||||
@@ -81,8 +81,8 @@
|
|||||||
@flag{gtk.tlw.can-set-transparent}
|
@flag{gtk.tlw.can-set-transparent}
|
||||||
wxTopLevelWindow::CanSetTransparent() method normally tries to detect
|
wxTopLevelWindow::CanSetTransparent() method normally tries to detect
|
||||||
automatically whether transparency for top level windows is currently
|
automatically whether transparency for top level windows is currently
|
||||||
supported, however this may sometimes fail and this option allows to
|
supported, however this may sometimes fail and this option allows
|
||||||
override the automatic detection. Setting it to 1 makes the transparency
|
overriding the automatic detection. Setting it to 1 makes the transparency
|
||||||
be always available (setting it can still fail, of course) and setting it
|
be always available (setting it can still fail, of course) and setting it
|
||||||
to 0 makes it always unavailable.
|
to 0 makes it always unavailable.
|
||||||
@flag{gtk.desktop}
|
@flag{gtk.desktop}
|
||||||
|
@@ -21,7 +21,7 @@
|
|||||||
one after the user finished entering the first one and so on.
|
one after the user finished entering the first one and so on.
|
||||||
|
|
||||||
When inheriting from this class you need to implement its two pure virtual
|
When inheriting from this class you need to implement its two pure virtual
|
||||||
methods. This allows to return the results incrementally and may or not be
|
methods. This allows returning the results incrementally and may or not be
|
||||||
convenient depending on where do they come from. If you prefer to return
|
convenient depending on where do they come from. If you prefer to return
|
||||||
all the completions at once, you should inherit from wxTextCompleterSimple
|
all the completions at once, you should inherit from wxTextCompleterSimple
|
||||||
instead.
|
instead.
|
||||||
|
@@ -960,7 +960,7 @@ public:
|
|||||||
@style{wxTE_READONLY}
|
@style{wxTE_READONLY}
|
||||||
The text will not be user-editable.
|
The text will not be user-editable.
|
||||||
@style{wxTE_RICH}
|
@style{wxTE_RICH}
|
||||||
Use rich text control under MSW, this allows to have more than 64KB
|
Use rich text control under MSW, this allows having more than 64KB
|
||||||
of text in the control. This style is ignored under other platforms.
|
of text in the control. This style is ignored under other platforms.
|
||||||
@style{wxTE_RICH2}
|
@style{wxTE_RICH2}
|
||||||
Use rich text control version 2.0 or higher under MSW, this style is
|
Use rich text control version 2.0 or higher under MSW, this style is
|
||||||
@@ -1469,7 +1469,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Converts given text position to client coordinates in pixels.
|
Converts given text position to client coordinates in pixels.
|
||||||
|
|
||||||
This function allows to find where is the character at the given
|
This function allows finding where is the character at the given
|
||||||
position displayed in the text control.
|
position displayed in the text control.
|
||||||
|
|
||||||
@onlyfor{wxmsw,wxgtk}. Additionally, wxGTK only implements this method
|
@onlyfor{wxmsw,wxgtk}. Additionally, wxGTK only implements this method
|
||||||
|
@@ -68,7 +68,7 @@ public:
|
|||||||
|
|
||||||
This method should be used instead of AutoComplete() overload taking
|
This method should be used instead of AutoComplete() overload taking
|
||||||
the array of possible completions if the total number of strings is too
|
the array of possible completions if the total number of strings is too
|
||||||
big as it allows to return the completions dynamically, depending on
|
big as it allows returning the completions dynamically, depending on
|
||||||
the text already entered by user and so is more efficient.
|
the text already entered by user and so is more efficient.
|
||||||
|
|
||||||
The specified @a completer object will be used to retrieve the list of
|
The specified @a completer object will be used to retrieve the list of
|
||||||
@@ -399,7 +399,7 @@ public:
|
|||||||
This function sets the maximum number of characters the user can enter
|
This function sets the maximum number of characters the user can enter
|
||||||
into the control.
|
into the control.
|
||||||
|
|
||||||
In other words, it allows to limit the text value length to @a len not
|
In other words, it allows limiting the text value length to @a len not
|
||||||
counting the terminating @c NUL character.
|
counting the terminating @c NUL character.
|
||||||
|
|
||||||
If @a len is 0, the previously set max length limit, if any, is discarded
|
If @a len is 0, the previously set max length limit, if any, is discarded
|
||||||
|
@@ -22,7 +22,7 @@ enum wxTextFileType
|
|||||||
/**
|
/**
|
||||||
@class wxTextFile
|
@class wxTextFile
|
||||||
|
|
||||||
The wxTextFile is a simple class which allows to work with text files on line by
|
The wxTextFile is a simple class which allows working with text files on line by
|
||||||
line basis. It also understands the differences in line termination characters
|
line basis. It also understands the differences in line termination characters
|
||||||
under different platforms and will not do anything bad to files with "non
|
under different platforms and will not do anything bad to files with "non
|
||||||
native" line termination sequences - in fact, it can be also used to modify the
|
native" line termination sequences - in fact, it can be also used to modify the
|
||||||
@@ -169,7 +169,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Gets the last line of the file.
|
Gets the last line of the file.
|
||||||
|
|
||||||
Together with GetPrevLine() it allows to enumerate the lines
|
Together with GetPrevLine() it allows enumerating the lines
|
||||||
in the file from the end to the beginning like this:
|
in the file from the end to the beginning like this:
|
||||||
|
|
||||||
@code
|
@code
|
||||||
|
@@ -809,7 +809,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Removes the given tool from the toolbar but doesn't delete it. This
|
Removes the given tool from the toolbar but doesn't delete it. This
|
||||||
allows to insert/add this tool back to this (or another) toolbar later.
|
allows inserting/adding this tool back to this (or another) toolbar later.
|
||||||
|
|
||||||
@note It is unnecessary to call Realize() for the change to take place,
|
@note It is unnecessary to call Realize() for the change to take place,
|
||||||
it will happen immediately.
|
it will happen immediately.
|
||||||
|
@@ -467,8 +467,8 @@ public:
|
|||||||
void SetIcon(const wxIcon& icon);
|
void SetIcon(const wxIcon& icon);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Sets several icons of different sizes for this window: this allows to
|
Sets several icons of different sizes for this window: this allows
|
||||||
use different icons for different situations (e.g. task switching bar,
|
using different icons for different situations (e.g. task switching bar,
|
||||||
taskbar, window title bar) instead of scaling, with possibly bad looking
|
taskbar, window title bar) instead of scaling, with possibly bad looking
|
||||||
results, the only icon set by SetIcon().
|
results, the only icon set by SetIcon().
|
||||||
|
|
||||||
|
@@ -7,7 +7,7 @@
|
|||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This class allows to get translations for strings.
|
This class allows getting translations for strings.
|
||||||
|
|
||||||
In wxWidgets this class manages message catalogs which contain the
|
In wxWidgets this class manages message catalogs which contain the
|
||||||
translations of the strings used to the current language. Unlike wxLocale,
|
translations of the strings used to the current language. Unlike wxLocale,
|
||||||
@@ -539,7 +539,7 @@ public:
|
|||||||
|
|
||||||
If @a context is not empty (notice that this argument is only available
|
If @a context is not empty (notice that this argument is only available
|
||||||
starting from wxWidgets 3.1.1), item translation is looked up in the
|
starting from wxWidgets 3.1.1), item translation is looked up in the
|
||||||
specified context. This allows to have different translations for the same
|
specified context. This allows having different translations for the same
|
||||||
string appearing in different contexts, e.g. it may be necessary to
|
string appearing in different contexts, e.g. it may be necessary to
|
||||||
translate the same English "Open" verb differently depending on the object
|
translate the same English "Open" verb differently depending on the object
|
||||||
it applies to. To do this, you need to use @c msgctxt in the source message
|
it applies to. To do this, you need to use @c msgctxt in the source message
|
||||||
|
@@ -24,7 +24,7 @@ enum
|
|||||||
Don't show the column headers.
|
Don't show the column headers.
|
||||||
|
|
||||||
By default this control shows the column headers, using this class
|
By default this control shows the column headers, using this class
|
||||||
allows to avoid this and show only the data.
|
allows avoiding this and showing only the data.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
*/
|
*/
|
||||||
|
@@ -868,8 +868,8 @@ wxString wxGetOsDescription();
|
|||||||
/**
|
/**
|
||||||
Gets the version and the operating system ID for currently running OS.
|
Gets the version and the operating system ID for currently running OS.
|
||||||
The returned wxOperatingSystemId value can be used for a basic categorization
|
The returned wxOperatingSystemId value can be used for a basic categorization
|
||||||
of the OS family; the major, minor, and micro version numbers allows to
|
of the OS family; the major, minor, and micro version numbers allows
|
||||||
detect a specific system.
|
detecting a specific system.
|
||||||
|
|
||||||
If on Unix-like systems the version can't be detected all three version
|
If on Unix-like systems the version can't be detected all three version
|
||||||
numbers will have a value of -1.
|
numbers will have a value of -1.
|
||||||
@@ -1026,7 +1026,7 @@ enum
|
|||||||
Always show the child process console under MSW.
|
Always show the child process console under MSW.
|
||||||
|
|
||||||
The child console is hidden by default if the child IO is redirected,
|
The child console is hidden by default if the child IO is redirected,
|
||||||
this flag allows to change this and show it nevertheless.
|
this flag allows changing this and showing it nevertheless.
|
||||||
|
|
||||||
This flag is ignored under the other platforms.
|
This flag is ignored under the other platforms.
|
||||||
*/
|
*/
|
||||||
|
@@ -364,7 +364,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Creates a wxFloatingPointValidator object with automatic type deduction.
|
Creates a wxFloatingPointValidator object with automatic type deduction.
|
||||||
|
|
||||||
Similarly to wxMakeIntegerValidator(), this function allows to avoid
|
Similarly to wxMakeIntegerValidator(), this function allows avoiding
|
||||||
explicitly specifying the validator type.
|
explicitly specifying the validator type.
|
||||||
|
|
||||||
@since 2.9.2
|
@since 2.9.2
|
||||||
|
@@ -276,7 +276,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
@class wxFFileStream
|
@class wxFFileStream
|
||||||
|
|
||||||
This stream allows to both read from and write to a file using buffered
|
This stream allows both reading from and writing to a file using buffered
|
||||||
STDIO functions.
|
STDIO functions.
|
||||||
|
|
||||||
@library{wxbase}
|
@library{wxbase}
|
||||||
|
@@ -257,7 +257,7 @@ enum wxWindowVariant
|
|||||||
@style{wxWS_EX_BLOCK_EVENTS}
|
@style{wxWS_EX_BLOCK_EVENTS}
|
||||||
wxCommandEvents and the objects of the derived classes are
|
wxCommandEvents and the objects of the derived classes are
|
||||||
forwarded to the parent window and so on recursively by default.
|
forwarded to the parent window and so on recursively by default.
|
||||||
Using this flag for the given window allows to block this
|
Using this flag for the given window allows blocking this
|
||||||
propagation at this window, i.e. prevent the events from being
|
propagation at this window, i.e. prevent the events from being
|
||||||
propagated further upwards. Dialogs have this flag on by default
|
propagated further upwards. Dialogs have this flag on by default
|
||||||
for the reasons explained in the @ref overview_events.
|
for the reasons explained in the @ref overview_events.
|
||||||
|
@@ -886,7 +886,7 @@ public:
|
|||||||
void SetEncoding(const wxString& enc);
|
void SetEncoding(const wxString& enc);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Sets the enconding of the file which will be used to save the document.
|
Sets the encoding of the file which will be used to save the document.
|
||||||
*/
|
*/
|
||||||
void SetFileEncoding(const wxString& encoding);
|
void SetFileEncoding(const wxString& encoding);
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user