Mirrors_UI_SDK/wxWidgets
1
0
Fork 0
mirror of https://github.com/wxWidgets/wxWidgets.git synced 2026-09-24 15:45:11 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

revised st*.h headers

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56148 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2008-10-07 16:57:34 +00:00
parent 3a89adc1f0
commit 4701dc0983
14 changed files with 692 additions and 544 deletions
Download Patch File Download Diff File Expand all files Collapse all files
interface/wx/stackwalk.h
+35 -41
View File
@@ -11,36 +11,33 @@
wxStackWalker allows an application to enumerate, or walk, the stack frames
(the function callstack).
It is mostly useful in only two situations:
inside wxApp::OnFatalException function to
programmatically get the location of the crash and, in debug builds, in
wxApp::OnAssertFailure to report the caller of the failed
assert.
wxStackWalker works by repeatedly calling
the wxStackWalker::OnStackFrame method for each frame in the
stack, so to use it you must derive your own class from it and override this
method.
It is mostly useful in only two situations: inside wxApp::OnFatalException
function to programmatically get the location of the crash and, in debug builds,
in wxApp::OnAssertFailure to report the caller of the failed assert.
wxStackWalker works by repeatedly calling the wxStackWalker::OnStackFrame
method for each frame in the stack, so to use it you must derive your own
class from it and override this method.
This class will not return anything except raw stack frame addresses if the
debug information is not available. Under Win32 this means that the PDB file
matching the program being executed should be present. Note that if you use
Microsoft Visual C++ compiler, you can create PDB files even for the programs
built in release mode and it doesn't affect the program size (at least if you
don't forget to add @c /opt:ref option which is suppressed by using
@c /debug linker option by default but should be always enabled for
release builds). Under Unix, you need to compile your program with debugging
information (usually using @c -g compiler and linker options) to get the
file and line numbers information, however function names should be available
even without it. Of course, all this is only @true if you build using a recent
enough version of GNU libc which provides the @c backtrace() function
needed to walk the stack.
matching the program being executed should be present.
Note that if you use Microsoft Visual C++ compiler, you can create PDB files
even for the programs built in release mode and it doesn't affect the program
size (at least if you don't forget to add @c /opt:ref option which is suppressed
by using @c /debug linker option by default but should be always enabled for
release builds).
Under Unix, you need to compile your program with debugging information
(usually using @c -g compiler and linker options) to get the file and line
numbers information, however function names should be available even without it.
Of course, all this is only @true if you build using a recent enough version
of GNU libc which provides the @c backtrace() function needed to walk the stack.
@ref overview_debuggingoverview "debugging overview" for how to make it
available.
See @ref overview_debugging for how to make it available.
@library{wxbase}
@category{FIXME}
@category{debugging}
@see wxStackFrame
*/
@@ -48,8 +45,7 @@ class wxStackWalker
{
public:
/**
Constructor does nothing, use Walk() to walk the
stack.
Constructor does nothing, use Walk() to walk the stack.
*/
wxStackWalker();
@@ -69,14 +65,15 @@ public:
number of them (this can be useful when Walk() is called from some known
location and you don't want to see the first few frames anyhow; also
notice that Walk() frame itself is not included if skip = 1).
Up to @a maxDepth frames are walked from the innermost to the outermost one.
*/
virtual void Walk(size_t skip = 1, size_t maxDepth = 200);
/**
Enumerate stack frames from the location of uncaught exception.
This method can only be called from
wxApp::OnFatalException.
This method can only be called from wxApp::OnFatalException().
Up to @a maxDepth frames are walked from the innermost to the outermost one.
*/
virtual void WalkFromException(size_t maxDepth = 200);
@@ -88,12 +85,11 @@ public:
@class wxStackFrame
wxStackFrame represents a single stack frame, or a single function in the call
stack, and is used exclusively together with
wxStackWalker, see there for a more detailed
discussion.
stack, and is used exclusively together with wxStackWalker, see there for a more
detailed discussion.
@library{wxbase}
@category{FIXME}
@category{debugging}
@see wxStackWalker
*/
@@ -106,10 +102,10 @@ public:
void* GetAddress() const;
/**
Return the name of the file containing this frame, empty if
unavailable (typically because debug info is missing).
Use HasSourceLocation() to check whether
the file name is available.
Return the name of the file containing this frame, empty if unavailable
(typically because debug info is missing).
Use HasSourceLocation() to check whether the file name is available.
*/
wxString GetFileName() const;
@@ -131,8 +127,7 @@ public:
wxString GetModule() const;
/**
Return the unmangled (if possible) name of the function containing this
frame.
Return the unmangled (if possible) name of the function containing this frame.
*/
wxString GetName() const;
@@ -143,11 +138,10 @@ public:
/**
Get the name, type and value (in text form) of the given parameter.
Any pointer may be @NULL if you're not interested in the corresponding
value.
Any pointer may be @NULL if you're not interested in the corresponding value.
Return @true if at least some values could be retrieved.
This function currently is only implemented under Win32 and requires a PDB
file.
This function currently is only implemented under Win32 and requires a PDB file.
*/
bool GetParam(size_t n, wxString* type, wxString* name,
wxString* value) const;
interface/wx/statbmp.h
+12 -11
View File
@@ -9,12 +9,13 @@
/**
@class wxStaticBitmap
A static bitmap control displays a bitmap. Native implementations on some
platforms are only meant for display of the small icons in the dialog
A static bitmap control displays a bitmap. Native implementations on some
platforms are only meant for display of the small icons in the dialog
boxes. In particular, under Windows 9x the size of bitmap is limited
to 64*64 pixels.
If you want to display larger images portably, you may use generic
implementation wxGenericStaticBitmap declared in <wx/generic/statbmpg.h>.
If you want to display larger images portably, you may use generic
implementation wxGenericStaticBitmap declared in \<wx/generic/statbmpg.h\>.
@library{wxcore}
@category{ctrl}
@@ -29,7 +30,7 @@ public:
Default constructor
*/
wxStaticBitmap();
/**
Constructor, creating and showing a static bitmap control.
@@ -68,18 +69,18 @@ public:
const wxString& name = "staticBitmap");
/**
Returns the bitmap currently used in the control. Notice that this method can
be called even if SetIcon() had been used.
Returns the bitmap currently used in the control.
Notice that this method can be called even if SetIcon() had been used.
@see SetBitmap()
*/
virtual wxBitmap GetBitmap() const;
/**
Returns the icon currently used in the control. Notice that this method can
only be called if SetIcon() had been used: an icon
can't be retrieved from the control if a bitmap had been set (using
wxStaticBitmap::SetBitmap).
Returns the icon currently used in the control.
Notice that this method can only be called if SetIcon() had been used: an icon
can't be retrieved from the control if a bitmap had been set
(using wxStaticBitmap::SetBitmap).
@see SetIcon()
*/
interface/wx/statbox.h
+7 -7
View File
@@ -35,7 +35,7 @@ public:
Default constructor
*/
wxStaticBox();
/**
Constructor, creating and showing a static box.
@@ -46,11 +46,11 @@ public:
@param label
Text to be displayed in the static box, the empty string for no label.
@param pos
Window position. If wxDefaultPosition is specified then a default
position is chosen.
Window position.
If wxDefaultPosition is specified then a default position is chosen.
@param size
Checkbox size. If the size (-1, -1) is specified then a default size is
chosen.
Checkbox size.
If wxDefaultSize is specified then a default size is chosen.
@param style
Window style. See wxStaticBox.
@param name
@@ -71,8 +71,8 @@ public:
virtual ~wxStaticBox();
/**
Creates the static box for two-step construction. See wxStaticBox()
for further details.
Creates the static box for two-step construction.
See wxStaticBox() for further details.
*/
bool Create(wxWindow* parent, wxWindowID id,
const wxString& label,
interface/wx/statline.h
+6 -6
View File
@@ -25,7 +25,7 @@
@endStyleTable
@library{wxcore}
@category{FIXME}
@category{ctrl}
@see wxStaticBox
*/
@@ -36,7 +36,7 @@ public:
Default constructor
*/
wxStaticLine();
/**
Constructor, creating and showing a static line.
@@ -45,8 +45,8 @@ public:
@param id
Window identifier. The value wxID_ANY indicates a default value.
@param pos
Window position. If wxDefaultPosition is specified then a default
position is chosen.
Window position.
If wxDefaultPosition is specified then a default position is chosen.
@param size
Size. Note that either the height or the width (depending on
whether the line if horizontal or vertical) is ignored.
@@ -64,8 +64,8 @@ public:
const wxString& name = "staticLine");
/**
Creates the static line for two-step construction. See wxStaticLine()
for further details.
Creates the static line for two-step construction.
See wxStaticLine() for further details.
*/
bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
const wxPoint& pos = wxDefaultPosition,
interface/wx/stattext.h
+26 -22
View File
@@ -50,7 +50,7 @@ public:
Default constructor.
*/
wxStaticText();
/**
Constructor, creating and showing a text control.
@@ -90,32 +90,33 @@ public:
/**
Returns the contents of the control.
Note that the returned string contains both the mnemonics (@c characters),
Note that the returned string contains both the mnemonics (@& characters),
if any, and markup tags, if any.
Use GetLabelText() if only the
label text is needed.
Use GetLabelText() if only the label text is needed.
*/
wxString GetLabel() const;
//@{
/**
The first form returns the control's label without the mnemonics characters (if
any)
and without the markup (if the control has @c wxST_MARKUP style).
The second (static) version returns the given @a label string without the
mnemonics
characters (if any) and without the markup.
This method returns the control's label without the mnemonics characters
(if any) and without the markup (if the control has @c wxST_MARKUP style).
*/
wxString GetLabelText();
const static wxString GetLabelText(const wxString& label);
//@}
wxString GetLabelText() const;
/**
This overload returns the given @a label string without the
mnemonics characters (if any) and without the markup.
*/
static wxString GetLabelText(const wxString& label);
/**
Sets the static text label and updates the controls size to exactly fit the
label unless the control has wxST_NO_AUTORESIZE flag.
This function allows to set decorated static label text on platforms which
support it (currently only GTK+ 2). For the other platforms, the markup is
ignored.
The supported tags are:
<TABLE>
<TR>
@@ -156,14 +157,16 @@ public:
</TR>
<TR>
<TD>&lt;span&gt;</TD>
<TD>generic formatter tag; see Pango Markup for more information.</TD>
<TD>generic formatter tag; see Pango Markup
(http://library.gnome.org/devel/pango/unstable/PangoMarkupFormat.html)
for more information.</TD>
</TR>
</TABLE>
Note that the string must be well-formed (e.g. all tags must be correctly
closed)
otherwise it can be not shown correctly or at all.
closed) otherwise it can be not shown correctly or at all.
Also note that you need to escape the following special characters:
<TABLE>
<TR>
<TD>@b Special character</TD>
@@ -190,23 +193,24 @@ public:
<TD>@c &amp;gt;</TD>
</TR>
</TABLE>
The non-escaped ampersand @c &amp; characters are interpreted as
mnemonics; see wxControl::SetLabel.
Example:
@param label
The new label to set. It may contain newline characters and the markup tags
described above.
The new label to set.
It may contain newline characters and the markup tags described above.
*/
virtual void SetLabel(const wxString& label);
/**
This functions wraps the controls label so that each of its lines becomes at
most @a width pixels wide if possible (the lines are broken at words
boundaries so it might not be the case if words are too long). If @e width
is negative, no wrapping is done. Note that this width is not
boundaries so it might not be the case if words are too long).
If @a width is negative, no wrapping is done. Note that this width is not
necessarily the total width of the control, since a few pixels for the
border (depending on the controls border style) may be added.
interface/wx/statusbr.h
+35 -71
View File
@@ -10,55 +10,53 @@
@class wxStatusBar
A status bar is a narrow window that can be placed along the bottom of a frame
to give
small amounts of status information. It can contain one or more fields, one or
more of which can
be variable length according to the size of the window.
wxWindow
wxEvtHandler
wxObject
to give small amounts of status information. It can contain one or more fields,
one or more of which can be variable length according to the size of the window.
@beginStyleTable
@style{wxST_SIZEGRIP}
On Windows 95, displays a gripper at right-hand side of the status
bar.
On Windows 95, displays a gripper at right-hand side of the status bar.
@endStyleTable
@todo reference to win95 may be old and wrong
@remarks
It is possible to create controls and other windows on the status bar.
Position these windows from an OnSize event handler.
@library{wxcore}
@category{miscwnd}
@see wxFrame, @ref overview_samplestatbar "Status bar sample"
@see wxFrame, @ref page_samples_statbar
*/
class wxStatusBar : public wxWindow
{
public:
//@{
/**
Default ctor.
*/
wxStatusBar();
/**
Constructor, creating the window.
@param parent
The window parent, usually a frame.
@param id
The window identifier. It may take a value of -1 to indicate a default
value.
The window identifier.
It may take a value of -1 to indicate a default value.
@param style
The window style. See wxStatusBar.
@param name
The name of the window. This parameter is used to associate a name with the
item,
allowing the application user to set Motif resource values for
item, allowing the application user to set Motif resource values for
individual windows.
@see Create()
*/
wxStatusBar();
wxStatusBar(wxWindow* parent, wxWindowID id = wxID_ANY,
long style = wxST_SIZEGRIP,
const wxString& name = "statusBar");
//@}
/**
Destructor.
@@ -99,7 +97,7 @@ public:
The number of the status field to retrieve, starting from zero.
@return The status field string if the field is valid, otherwise the
empty string.
empty string.
@see SetStatusText()
*/
@@ -126,64 +124,31 @@ public:
The number of fields.
@param widths
An array of n integers interpreted in the same way as
in SetStatusWidths
in SetStatusWidths().
*/
virtual void SetFieldsCount(int number = 1, int* widths = NULL);
/**
Sets the minimal possible height for the status bar. The real height may be
bigger than the height specified here depending on the size of the font used by
the status bar.
Sets the minimal possible height for the status bar.
The real height may be bigger than the height specified here depending
on the size of the font used by the status bar.
*/
virtual void SetMinHeight(int height);
/**
Sets the styles of the fields in the status line which can make fields appear
flat
or raised instead of the standard sunken 3D border.
flat or raised instead of the standard sunken 3D border.
@param n
The number of fields in the status bar. Must be equal to the
number passed to SetFieldsCount the last
time it was called.
number passed to SetFieldsCount() the last time it was called.
@param styles
Contains an array of n integers with the styles for each field. There
are three possible styles:
wxSB_NORMAL
(default) The field appears sunken with a standard 3D border.
wxSB_FLAT
No border is painted around the field so that it appears flat.
wxSB_RAISED
A raised 3D border is painted around the field.
- wxSB_NORMAL (default): The field appears sunken with a standard 3D border.
- wxSB_FLAT: No border is painted around the field so that it appears flat.
- wxSB_RAISED: A raised 3D border is painted around the field.
*/
virtual void SetStatusStyles(int n, int* styles);
@@ -207,25 +172,24 @@ public:
the space left for all variable width fields is divided between them according
to the absolute value of this number. A variable width field with width of -2
gets twice as much of it as a field with width -1 and so on.
For example, to create one fixed width field of width 100 in the right part of
the status bar and two more fields which get 66% and 33% of the remaining
space correspondingly, you should use an array containing -2, -1 and 100.
@param n
The number of fields in the status bar. Must be equal to the
number passed to SetFieldsCount the last
time it was called.
number passed to SetFieldsCount() the last time it was called.
@param widths
Contains an array of n integers, each of which is
either an absolute status field width in pixels if positive or indicates a
Contains an array of n integers, each of which is either an
absolute status field width in pixels if positive or indicates a
variable width field if negative.
@remarks The widths of the variable fields are calculated from the total
width of all fields, minus the sum of widths of the
non-variable fields, divided by the number of variable
fields.
non-variable fields, divided by the number of variable fields.
@see SetFieldsCount(), wxFrame::SetStatusWidths
@see SetFieldsCount(), wxFrame::SetStatusWidths()
*/
virtual void SetStatusWidths(int n, int* widths);
};
interface/wx/stc/stc.h
+129 -89
View File
File diff suppressed because it is too large Load Diff
interface/wx/stdpaths.h
+68 -64
View File
@@ -16,17 +16,16 @@
for the Unix, Windows and Mac OS X systems, however please note that these are
just the examples and the actual values may differ. For example, under Windows:
the system administrator may change the standard directories locations, i.e.
the Windows directory may be named @c W:\\Win2003 instead of
the default @c C:\\Windows.
the Windows directory may be named @c "W:\Win2003" instead of
the default @c "C:\Windows".
The strings @c appname and @c username should be
replaced with the value returned by wxApp::GetAppName
and the name of the currently logged in user, respectively. The string
@c prefix is only used under Unix and is @c /usr/local by
The strings @c appname and @c username should be replaced with the value
returned by wxApp::GetAppName() and the name of the currently logged in user,
respectively. The string @c prefix is only used under Unix and is @c /usr/local by
default but may be changed using wxStandardPaths::SetInstallPrefix.
The directories returned by the methods of this class may or may not exist. If
they don't exist, it's up to the caller to create them, wxStandardPaths doesn't
The directories returned by the methods of this class may or may not exist.
If they don't exist, it's up to the caller to create them, wxStandardPaths doesn't
do it.
Finally note that these functions only work with standardly packaged
@@ -37,15 +36,15 @@
This class is MT-safe: its methods may be called concurrently from different
threads without additional locking.
Note that you don't allocate an instance of class wxStandardPaths, but retrieve the
global standard paths object using @c wxStandardPaths::Get on which you call the
Note that you don't allocate an instance of class wxStandardPaths, but retrieve the
global standard paths object using @c wxStandardPaths::Get on which you call the
desired methods.
@library{wxbase}
@category{file}
@see wxFileConfig
*/
*/
class wxStandardPaths
{
public:
@@ -57,9 +56,9 @@ public:
/**
Return the directory containing the system config files.
Example return values:
- Unix: @c /etc
- Windows: @c C:\\Documents @c and @c Settings\\All @c Users\\Application Data
- Mac: @c /Library/Preferences
- Unix: @c /etc
- Windows: @c "C:\Documents and Settings\All Users\Application Data"
- Mac: @c /Library/Preferences
@see wxFileConfig
*/
@@ -69,9 +68,9 @@ public:
Return the location of the applications global, i.e. not user-specific,
data files.
Example return values:
- Unix: @c prefix/share/appname
- Windows: the directory where the executable file is located
- Mac: @c appname.app/Contents/SharedSupport bundle subdirectory
- Unix: @c prefix/share/appname
- Windows: the directory where the executable file is located
- Mac: @c appname.app/Contents/SharedSupport bundle subdirectory
@see GetLocalDataDir()
*/
@@ -80,9 +79,9 @@ public:
/**
Return the directory containing the current user's documents.
Example return values:
- Unix: @c ~ (the home directory)
- Windows: @c C:\\Documents @c and @c Settings\\username\\My Documents
- Mac: @c ~/Documents
- Unix: @c ~ (the home directory)
- Windows: @c "C:\Documents and Settings\username\My Documents"
- Mac: @c ~/Documents
@since 2.7.0
*/
@@ -91,36 +90,38 @@ public:
/**
Return the directory and the filename for the current executable.
Example return values:
- Unix: @c /usr/local/bin/exename
- Windows: @c C:\\Programs\\AppFolder\\exename.exe
- Mac: @c /Programs/exename
- Unix: @c /usr/local/bin/exename
- Windows: @c "C:\Programs\AppFolder\exename.exe"
- Mac: @c /Programs/exename
*/
virtual wxString GetExecutablePath() const;
/**
@note This function is only available under Unix.
Return the program installation prefix, e.g. @c /usr, @c /opt or
@c /home/zeitlin.
Return the program installation prefix, e.g. @c /usr, @c /opt or @c /home/zeitlin.
If the prefix had been previously by SetInstallPrefix(), returns that
value, otherwise tries to determine it automatically (Linux only right
now) and finally returns the default @c /usr/local value if it failed.
value, otherwise tries to determine it automatically (Linux only right now)
and finally returns the default @c /usr/local value if it failed.
@note This function is only available under Unix.
*/
wxString GetInstallPrefix() const;
/**
Return the location for application data files which are host-specific and
can't, or shouldn't, be shared with the other machines.
This is the same as GetDataDir() except
under Unix where it returns @c /etc/appname.
This is the same as GetDataDir() except under Unix where it returns @c /etc/appname.
*/
virtual wxString GetLocalDataDir() const;
/**
Return the localized resources directory containing the resource files of the
specified category for the given language.
In general this is just the same as @a lang subdirectory of
GetResourcesDir() (or @c lang.lproj under Mac OS X) but is something quite
different for message catalog category under Unix where it returns the standard
In general this is just the same as @a lang subdirectory of GetResourcesDir()
(or @c lang.lproj under Mac OS X) but is something quite different for
message catalog category under Unix where it returns the standard
@c prefix/share/locale/lang/LC_MESSAGES directory.
@since 2.7.0
@@ -131,24 +132,25 @@ public:
/**
Return the directory where the loadable modules (plugins) live.
Example return values:
- Unix: @c prefix/lib/appname
- Windows: the directory of the executable file
- Mac: @c appname.app/Contents/PlugIns bundle subdirectory
- Unix: @c prefix/lib/appname
- Windows: the directory of the executable file
- Mac: @c appname.app/Contents/PlugIns bundle subdirectory
@see wxDynamicLibrary
*/
virtual wxString GetPluginsDir() const;
/**
Return the directory where the application resource files are located. The
resources are the auxiliary data files needed for the application to run and
include, for example, image and sound files it might use.
This function is the same as GetDataDir() for
all platforms except Mac OS X.
Return the directory where the application resource files are located.
The resources are the auxiliary data files needed for the application to run
and include, for example, image and sound files it might use.
This function is the same as GetDataDir() for all platforms except Mac OS X.
Example return values:
- Unix: @c prefix/share/@e appname
- Windows: the directory where the executable file is located
- Mac: @c appname.app/Contents/Resources bundle subdirectory
- Unix: @c prefix/share/appname
- Windows: the directory where the executable file is located
- Mac: @c appname.app/Contents/Resources bundle subdirectory
@since 2.7.0
@@ -157,10 +159,9 @@ public:
virtual wxString GetResourcesDir() const;
/**
Return the directory for storing temporary files. To create unique temporary
files,
it is best to use wxFileName::CreateTempFileName for correct behaviour when
multiple processes are attempting to create temporary files.
Return the directory for storing temporary files.
To create unique temporary files, it is best to use wxFileName::CreateTempFileName
for correct behaviour when multiple processes are attempting to create temporary files.
@since 2.7.2
*/
@@ -168,40 +169,42 @@ public:
/**
Return the directory for the user config files:
- Unix: @c ~ (the home directory)
- Windows: @c C:\\Documents @c and @c Settings\\username\\Application Data
- Mac: @c ~/Library/Preferences
- Unix: @c ~ (the home directory)
- Windows: @c "C:\Documents and Settings\username\Application Data"
- Mac: @c ~/Library/Preferences
Only use this method if you have a single configuration file to put in this
directory, otherwise GetUserDataDir() is
more appropriate.
directory, otherwise GetUserDataDir() is more appropriate.
*/
virtual wxString GetUserConfigDir() const;
/**
Return the directory for the user-dependent application data files:
- Unix: @c ~/.appname
- Windows: @c C:\\Documents @c and @c Settings\\username\\Application @c Data\\appname
- Mac: @c ~/Library/Application @c Support/appname
- Unix: @c ~/.appname
- Windows: @c "C:\Documents and Settings\username\Application Data\appname"
- Mac: @c "~/Library/Application Support/appname"
*/
virtual wxString GetUserDataDir() const;
/**
Return the directory for user data files which shouldn't be shared with
the other machines.
This is the same as GetUserDataDir() for all platforms except Windows where it returns
@c C:\\Documents @c and @c Settings\\username\\Local @c Settings\\Application @c Data\\appname
@c "C:\Documents and Settings\username\Local Settings\Application Data\appname"
*/
virtual wxString GetUserLocalDataDir() const;
/**
@note This function is only available under Unix.
Lets wxStandardPaths know about the real program installation prefix on a Unix
system. By default, the value returned by
GetInstallPrefix() is used.
system. By default, the value returned by GetInstallPrefix() is used.
Although under Linux systems the program prefix may usually be determined
automatically, portable programs should call this function. Usually the prefix
is set during program configuration if using GNU autotools and so it is enough
to pass its value defined in @c config.h to this function.
@note This function is only available under Unix.
*/
void SetInstallPrefix(const wxString& prefix);
@@ -209,10 +212,11 @@ public:
Controls what application information is used when constructing paths that
should be unique to this program, such as the application data directory, the
plugins directory on Unix, etc.
Valid values for @a info are @c AppInfo_None and either one or
combination of @c AppInfo_AppName and @c AppInfo_VendorName. The
first one tells this class to not use neither application nor vendor name in
the paths.
Valid values for @a info are @c AppInfo_None and either one or combination
of @c AppInfo_AppName and @c AppInfo_VendorName. The first one tells this
class to not use neither application nor vendor name in the paths.
By default, only the application name is used under Unix systems but both
application and vendor names are used under Windows and Mac.
*/
interface/wx/stopwatch.h
+9 -10
View File
@@ -9,11 +9,12 @@
/**
@class wxStopWatch
The wxStopWatch class allow you to measure time intervals. For example, you may
use it to measure the time elapsed by some function:
The wxStopWatch class allow you to measure time intervals.
For example, you may use it to measure the time elapsed by some function:
@code
wxStopWatch sw;
wxStopWatch sw;
CallLongRunningFunction();
wxLogMessage("The long running function took %ldms to execute",
sw.Time());
@@ -38,8 +39,8 @@ public:
wxStopWatch();
/**
Pauses the stop watch. Call Resume() to resume
time measuring again.
Pauses the stop watch. Call Resume() to resume time measuring again.
If this method is called several times, @c Resume() must be called the same
number of times to really resume the stop watch. You may, however, call
Start() to resume it unconditionally.
@@ -47,8 +48,7 @@ public:
void Pause();
/**
Resumes the stop watch which had been paused with
Pause().
Resumes the stop watch which had been paused with Pause().
*/
void Resume();
@@ -58,9 +58,8 @@ public:
void Start(long milliseconds = 0);
/**
Returns the time in milliseconds since the start (or restart) or the last call
of
Pause().
Returns the time in milliseconds since the start (or restart) or the last
call of Pause().
*/
long Time() const;
};
interface/wx/strconv.h
+15 -13
View File
@@ -30,7 +30,7 @@
@library{wxbase}
@category{conv}
@see wxCSConv, wxEncodingConverter, @ref overview_mbconv "wxMBConv classes overview"
@see wxCSConv, wxEncodingConverter, @ref overview_mbconv
*/
class wxMBConv
{
@@ -116,10 +116,11 @@ public:
@a dst is non-@NULL, unused otherwise.
@param src
Point to the source string, must not be @NULL.
@param
The number of characters of the source string to convert or @c
wxNO_LEN (default parameter) to convert everything up to and
@param srcLen
The number of characters of the source string to convert or
@c wxNO_LEN (default parameter) to convert everything up to and
including the terminating @c NUL character(s).
@return
The number of character written (or which would have been written
if it were non-@NULL) to @a dst or @c wxCONV_FAILED on error.
@@ -143,10 +144,11 @@ public:
@a dst is non-@NULL, unused otherwise.
@param src
Point to the source string, must not be @NULL.
@param
The number of characters of the source string to convert or @c
wxNO_LEN (default parameter) to convert everything up to and
@param srcLen
The number of characters of the source string to convert or
@c wxNO_LEN (default parameter) to convert everything up to and
including the terminating @c NUL character.
@return
The number of character written (or which would have been written
if it were non-@NULL) to @a dst or @c wxCONV_FAILED on error.
@@ -301,7 +303,7 @@ public:
@library{wxbase}
@category{conv}
@see wxMBConvUTF8, @ref overview_mbconv "wxMBConv classes overview"
@see wxMBConvUTF8, @ref overview_mbconv
*/
class wxMBConvUTF7 : public wxMBConv
{
@@ -318,7 +320,7 @@ class wxMBConvUTF7 : public wxMBConv
@library{wxbase}
@category{conv}
@see wxMBConvUTF7, @ref overview_mbconv "wxMBConv classes overview"
@see wxMBConvUTF7, @ref overview_mbconv
*/
class wxMBConvUTF8 : public wxMBConv
{
@@ -341,7 +343,7 @@ class wxMBConvUTF8 : public wxMBConv
@library{wxbase}
@category{conv}
@see wxMBConvUTF8, wxMBConvUTF32, @ref overview_mbconv "wxMBConv classes overview"
@see wxMBConvUTF8, wxMBConvUTF32, @ref overview_mbconv
*/
class wxMBConvUTF16 : public wxMBConv
{
@@ -362,7 +364,7 @@ class wxMBConvUTF16 : public wxMBConv
@library{wxbase}
@category{conv}
@see wxMBConvUTF8, wxMBConvUTF16, @ref overview_mbconv "wxMBConv classes overview"
@see wxMBConvUTF8, wxMBConvUTF16, @ref overview_mbconv
*/
class wxMBConvUTF32 : public wxMBConv
{
@@ -389,7 +391,7 @@ class wxMBConvUTF32 : public wxMBConv
@library{wxbase}
@category{conv}
@see wxMBConv, wxEncodingConverter, @ref overview_mbconv "wxMBConv classes overview"
@see wxMBConv, wxEncodingConverter, @ref overview_mbconv
*/
class wxCSConv : public wxMBConv
{
@@ -466,7 +468,7 @@ public:
@library{wxbase}
@category{conv}
@see @ref overview_mbconv "wxMBConv classes overview"
@see @ref overview_mbconv
*/
class wxMBConvFile : public wxMBConv
{
interface/wx/stream.h
+5 -2
View File
@@ -115,6 +115,7 @@ public:
/**
Constructor; creates a new empty stream buffer which won't flush any data
to a stream. mode specifies the type of the buffer (read, write, read_write).
This stream buffer has the advantage to be stream independent and to work
only on memory buffers but it is still compatible with the rest of the
wxStream classes. You can write, read to this special stream and it will
@@ -129,7 +130,9 @@ public:
wxStreamBuffer(BufMode mode);
/**
Constructor. It initializes the stream buffer with the data of the specified
Constructor.
This method initializes the stream buffer with the data of the specified
stream buffer. The new stream buffer has the same attributes, size, position
and they share the same buffer. This will cause problems if the stream to
which the stream buffer belong is destroyed and the newly cloned stream
@@ -450,7 +453,7 @@ enum wxStreamProtocolType
handle it and create a stream to decompress it:
@code
factory = wxFilterClassFactory::Find(filename, wxSTREAM_FILEEXT);
factory = wxFilterClassFactory::Find(filename, wxSTREAM_FILEEXT);
if (factory)
stream = factory-NewStream(new wxFFileInputStream(filename));
@endcode
interface/wx/string.h
+231 -192
View File
File diff suppressed because it is too large Load Diff
interface/wx/sysopt.h
+112 -16
View File
@@ -14,7 +14,103 @@
used to optimize behaviour that doesn't deserve a distinct API,
but is still important to be able to configure.
These options are currently recognised by wxWidgets.
These options are currently recognised by wxWidgets:
@section sysopt_win Windows
@beginFlagTable
@flag{no-maskblt}
1 to never use WIN32's MaskBlt function, 0 to allow it to be used where possible.
Default: 0. In some circumstances the MaskBlt function can be slower than using
the fallback code, especially if using DC cacheing. By default, MaskBlt will be
used where it is implemented by the operating system and driver.
@flag{msw.remap}
If 1 (the default), wxToolBar bitmap colours will be remapped to the current
theme's values. Set this to 0 to disable this functionality, for example if
you're using more than 16 colours in your tool bitmaps.
@flag{msw.window.no-clip-children}
If 1, windows will not automatically get the WS_CLIPCHILDREN style.
This restores the way windows are refreshed back to the method used in
versions of wxWidgets earlier than 2.5.4, and for some complex window
hierarchies it can reduce apparent refresh delays.
You may still specify wxCLIP_CHILDREN for individual windows.
@flag{msw.notebook.themed-background}
If set to 0, globally disables themed backgrounds on notebook pages.
Note that this won't disable the theme on the actual notebook background
(noticeable only if there are no pages).
@flag{msw.staticbox.optimized-paint}
If set to 0, switches off optimized wxStaticBox painting.
Setting this to 0 causes more flicker, but allows applications to paint
graphics on the parent of a static box (the optimized refresh causes any
such drawing to disappear).
@flag{msw.display.directdraw}
If set to 1, use DirectDraw-based implementation of wxDisplay.
By default the standard Win32 functions are used.
@flag{msw.font.no-proof-quality}
If set to 1, use default fonts quality instead of proof quality when
creating fonts. With proof quality the fonts have slightly better
appearance but not all fonts are available in this quality,
e.g. the Terminal font in small sizes is not and this option may be
used if wider fonts selection is more important than higher quality.
@endFlagTable
@section sysopt_gtk GTK+
@beginFlagTable
@flag{gtk.tlw.can-set-transparent}
wxTopLevelWindow::CanSetTransparent() method normally tries to detect
automatically whether transparency for top level windows is currently
supported, however this may sometimes fail and this option allows to
override the automatic detection. Setting it to 1 makes the transparency
be always available (setting it can still fail, of course) and setting it
to 0 makes it always unavailable.
@flag{gtk.desktop}
This option can be set to override the default desktop environment
determination. Supported values are GNOME and KDE.
@flag{gtk.window.force-background-colour}
If 1, the backgrounds of windows with the wxBG_STYLE_COLOUR background
style are cleared forcibly instead of relying on the underlying GTK+
window colour. This works around a display problem when running
applications under KDE with the gtk-qt theme installed (0.6 and below).
@endFlagTable
@section sysopt_mac Mac
@beginFlagTable
@flag{mac.window-plain-transition}
If 1, uses a plainer transition when showing a window.
You can also use the symbol wxMAC_WINDOW_PLAIN_TRANSITION.
@flag{window-default-variant}
The default variant used by windows (cast to integer from the wxWindowVariant enum).
Also known as wxWINDOW_DEFAULT_VARIANT.
flag{mac.listctrl.always_use_generic}
Tells wxListCtrl to use the generic control even when it is capable of
using the native control instead. Also knwon as wxMAC_ALWAYS_USE_GENERIC_LISTCTRL.
@endFlagTable
@section sysopt_mgl MGL
@beginFlagTable
@flag{mgl.aa-threshold}
Set this integer option to point size below which fonts are not antialiased. Default: 10.
@flag{mgl.screen-refresh}
Screen refresh rate in Hz. A reasonable default is used if not specified.
@endFlagTable
@section sysopt_motif Motif
@beginFlagTable
@flag{motif.largebuttons}
If 1, uses a bigger default size for wxButtons.
@endFlagTable
The compile-time option to include or exclude this functionality is wxUSE_SYSTEM_OPTIONS.
@library{wxbase}
@category{misc}
@@ -26,41 +122,41 @@ class wxSystemOptions : public wxObject
{
public:
/**
Default constructor. You don't need to create an instance of wxSystemOptions
since all of its functions are static.
Default constructor.
You don't need to create an instance of wxSystemOptions since all
of its functions are static.
*/
wxSystemOptions();
/**
Gets an option. The function is case-insensitive to @e name.
Gets an option. The function is case-insensitive to @a name.
Returns empty string if the option hasn't been set.
@see SetOption(), GetOptionInt(),
HasOption()
@see SetOption(), GetOptionInt(), HasOption()
*/
static wxString GetOption(const wxString& name);
/**
Gets an option as an integer. The function is case-insensitive to @e name.
Gets an option as an integer. The function is case-insensitive to @a name.
If the option hasn't been set, this function returns 0.
@see SetOption(), GetOption(),
HasOption()
@see SetOption(), GetOption(), HasOption()
*/
static int GetOptionInt(const wxString& name);
/**
Returns @true if the given option is present. The function is
case-insensitive to @e name.
Returns @true if the given option is present.
The function is case-insensitive to @a name.
@see SetOption(), GetOption(),
GetOptionInt()
@see SetOption(), GetOption(), GetOptionInt()
*/
static bool HasOption(const wxString& name);
/**
Returns @true if the option with the given @a name had been set to 0
value. This is mostly useful for boolean options for which you can't use
Returns @true if the option with the given @a name had been set to 0 value.
This is mostly useful for boolean options for which you can't use
@c GetOptionInt(name) == 0 as this would also be @true if the option
hadn't been set at all.
*/
@@ -68,7 +164,7 @@ public:
//@{
/**
Sets an option. The function is case-insensitive to @e name.
Sets an option. The function is case-insensitive to @a name.
*/
void SetOption(const wxString& name, const wxString& value);
void SetOption(const wxString& name, int value);
interface/wx/textdlg.h
+2
View File
@@ -31,6 +31,8 @@ public:
Parent window.
@param message
Message to show on the dialog.
@param caption
The caption of the dialog.
@param defaultValue
The default value, which may be the empty string.
@param style