Merge branch 'master' into osx-10_10-min-10_11-SDK
This commit is contained in:
@@ -27,13 +27,13 @@ This version of wxWidgets supports the following primary platforms:
|
|||||||
|
|
||||||
- Windows XP, Vista, 7, 8 and 10 (32/64 bits).
|
- Windows XP, Vista, 7, 8 and 10 (32/64 bits).
|
||||||
- Most Unix variants using the GTK+ toolkit (version 2.6 or newer or 3.x).
|
- Most Unix variants using the GTK+ toolkit (version 2.6 or newer or 3.x).
|
||||||
- OS X (10.7 or newer) using Cocoa (32/64 bits).
|
- macOS (10.7 or newer) using Cocoa (32/64 bits).
|
||||||
|
|
||||||
Most popular C++ compilers are supported including but not limited to:
|
Most popular C++ compilers are supported including but not limited to:
|
||||||
|
|
||||||
- Microsoft Visual C++ 2003 or later (up to 2019).
|
- Microsoft Visual C++ 2003 or later (up to 2019).
|
||||||
- g++ 3.4 or later, including MinGW/MinGW-64/TDM under Windows.
|
- g++ 3.4 or later, including MinGW/MinGW-64/TDM under Windows.
|
||||||
- Clang under OS X and Linux.
|
- Clang under macOS and Linux.
|
||||||
- Intel icc compiler.
|
- Intel icc compiler.
|
||||||
- Oracle (ex-Sun) CC.
|
- Oracle (ex-Sun) CC.
|
||||||
|
|
||||||
|
@@ -30,7 +30,7 @@ executing simultaneously (portably!) and so on.
|
|||||||
--------------------------------------
|
--------------------------------------
|
||||||
|
|
||||||
wxBase can be compiled and used under Win32, mostly any modern Unix system
|
wxBase can be compiled and used under Win32, mostly any modern Unix system
|
||||||
(including OS X), VMS and BeOS (this release couldn't be tested under
|
(including macOS), VMS and BeOS (this release couldn't be tested under
|
||||||
these platforms so you might encounter some problems but they should be easy
|
these platforms so you might encounter some problems but they should be easy
|
||||||
to solve -- please contact us in this case!)
|
to solve -- please contact us in this case!)
|
||||||
|
|
||||||
|
@@ -14,7 +14,7 @@ When using multi-threaded applications, it is often required to access or
|
|||||||
modify memory which is shared between threads. Atomic integer and pointer
|
modify memory which is shared between threads. Atomic integer and pointer
|
||||||
operations are an efficient way to handle this issue (another, less efficient,
|
operations are an efficient way to handle this issue (another, less efficient,
|
||||||
way is to use a wxMutex or wxCriticalSection). A native implementation exists
|
way is to use a wxMutex or wxCriticalSection). A native implementation exists
|
||||||
for Windows, Linux, Solaris and OS X; for others, a wxCriticalSection is
|
for Windows, Linux, Solaris and macOS; for others, a wxCriticalSection is
|
||||||
used to protect the data.
|
used to protect the data.
|
||||||
|
|
||||||
One particular application is reference counting (used by so-called
|
One particular application is reference counting (used by so-called
|
||||||
|
@@ -39,9 +39,9 @@ Notice that for compatibility reasons, this symbol is defined for console
|
|||||||
applications under Windows as well, but it should only be used in the GUI code
|
applications under Windows as well, but it should only be used in the GUI code
|
||||||
while <tt>__WINDOWS__</tt> should be used for the platform tests.}
|
while <tt>__WINDOWS__</tt> should be used for the platform tests.}
|
||||||
@itemdef{__WXOSX__, OS X GUI using any Apple widget framework (AppKit or UIKit)}
|
@itemdef{__WXOSX__, OS X GUI using any Apple widget framework (AppKit or UIKit)}
|
||||||
@itemdef{__WXOSX_IPHONE__, OS X iPhone (UIKit)}
|
@itemdef{__WXOSX_IPHONE__, iPhone (UIKit)}
|
||||||
@itemdef{__WXOSX_COCOA__, OS X using Cocoa (AppKit)}
|
@itemdef{__WXOSX_COCOA__, macOS using Cocoa (AppKit)}
|
||||||
@itemdef{__WXOSX_MAC__, OS X (Cocoa)}
|
@itemdef{__WXOSX_MAC__, macOS (Cocoa)}
|
||||||
@itemdef{__WXPM__, OS/2 native Presentation Manager (not used any longer).}
|
@itemdef{__WXPM__, OS/2 native Presentation Manager (not used any longer).}
|
||||||
@itemdef{__WXSTUBS__, Stubbed version ('template' wxWin implementation)}
|
@itemdef{__WXSTUBS__, Stubbed version ('template' wxWin implementation)}
|
||||||
@itemdef{__WXXT__, Xt; mutually exclusive with WX_MOTIF, not implemented in wxWidgets 2.x}
|
@itemdef{__WXXT__, Xt; mutually exclusive with WX_MOTIF, not implemented in wxWidgets 2.x}
|
||||||
@@ -59,7 +59,7 @@ versions: Cocoa for the desktop and a very early iPhone port. To summarize:
|
|||||||
<tt>__WXOSX_MAC__</tt>.
|
<tt>__WXOSX_MAC__</tt>.
|
||||||
@li If you want to test for wxOSX on the iPhone, use
|
@li If you want to test for wxOSX on the iPhone, use
|
||||||
<tt>__WXOSX_IPHONE__</tt>.
|
<tt>__WXOSX_IPHONE__</tt>.
|
||||||
@li If you want to test for any port under OS X, including, for
|
@li If you want to test for any port under macOS, including, for
|
||||||
example, wxGTK and also wxBase, use <tt>__DARWIN__</tt> (see below).
|
example, wxGTK and also wxBase, use <tt>__DARWIN__</tt> (see below).
|
||||||
|
|
||||||
The convention is to use the <tt>__WX</tt> prefix for these
|
The convention is to use the <tt>__WX</tt> prefix for these
|
||||||
|
@@ -114,7 +114,7 @@ include: Microsoft Visual C++ (.vc), Borland C++ (.bcc) and MinGW/Cygwin
|
|||||||
(.gcc). Makefiles are provided for the wxWidgets library itself, samples,
|
(.gcc). Makefiles are provided for the wxWidgets library itself, samples,
|
||||||
demos, and utilities.
|
demos, and utilities.
|
||||||
|
|
||||||
On Linux and OS X, you use the @c 'configure' command to generate the
|
On Linux and macOS, you use the @c 'configure' command to generate the
|
||||||
necessary makefiles. You should also use this method when building with
|
necessary makefiles. You should also use this method when building with
|
||||||
MinGW/Cygwin on Windows.
|
MinGW/Cygwin on Windows.
|
||||||
|
|
||||||
@@ -127,7 +127,7 @@ On Windows using a compiler other than MinGW/Cygwin, you would build the
|
|||||||
wxWidgets library from the @c "build/msw" directory which contains the relevant
|
wxWidgets library from the @c "build/msw" directory which contains the relevant
|
||||||
makefiles.
|
makefiles.
|
||||||
|
|
||||||
On Windows using MinGW/Cygwin, and on Unix and OS X, you invoke
|
On Windows using MinGW/Cygwin, and on Unix and macOS, you invoke
|
||||||
'configure' (found in the top-level of the wxWidgets source hierarchy), from
|
'configure' (found in the top-level of the wxWidgets source hierarchy), from
|
||||||
within a suitable empty directory for containing makefiles, object files and
|
within a suitable empty directory for containing makefiles, object files and
|
||||||
libraries.
|
libraries.
|
||||||
|
@@ -91,7 +91,7 @@ NetBSD, Solaris, AIX, ...) and require GTK+ 2.6 or later or GTK+ 3.x. The
|
|||||||
primary supported compiler is GNU g++.
|
primary supported compiler is GNU g++.
|
||||||
|
|
||||||
@li wxOSX/Cocoa: This is the native port for Apple computers. wxOSX/Cocoa
|
@li wxOSX/Cocoa: This is the native port for Apple computers. wxOSX/Cocoa
|
||||||
supports 32 or 64 bit Intel Macs running OS X 10.10 or later. The port can be
|
supports 32 or 64 bit Intel Macs running macOS 10.10 or later. The port can be
|
||||||
built either with g++ or clang.
|
built either with g++ or clang.
|
||||||
|
|
||||||
Other platforms (e.g. iOS - with a minimum requirement of iOS 13), compilers (Borland C++
|
Other platforms (e.g. iOS - with a minimum requirement of iOS 13), compilers (Borland C++
|
||||||
|
@@ -52,8 +52,8 @@ starting with 3.1.4. Use @c configure option @c \--with-gtk=2 to use GTK 2.
|
|||||||
|
|
||||||
@section page_port_wxosx wxOSX/Cocoa
|
@section page_port_wxosx wxOSX/Cocoa
|
||||||
|
|
||||||
wxOSX/Cocoa is the port of wxWidgets for the OS X platform. It requires
|
wxOSX/Cocoa is the port of wxWidgets for the macOS platform. It requires
|
||||||
OS X 10.10 or later, Xcode 7.2.1 or greater, and fully supports 64 bit builds.
|
macOS 10.10 or later, Xcode 7.2.1 or greater, and fully supports 64 bit builds.
|
||||||
|
|
||||||
@subpage plat_osx_install "Build and Install Instructions"
|
@subpage plat_osx_install "Build and Install Instructions"
|
||||||
|
|
||||||
|
@@ -652,7 +652,7 @@ first argument of @c save, @c load or @c delete, followed by the "service" and
|
|||||||
"user" arguments as used by wxSecretStore methods. After storing some password,
|
"user" arguments as used by wxSecretStore methods. After storing some password,
|
||||||
you can check that it can be retrieved later and also that it can be seen in
|
you can check that it can be retrieved later and also that it can be seen in
|
||||||
the OS-provided password manager (e.g. credential manager under MSW or keychain
|
the OS-provided password manager (e.g. credential manager under MSW or keychain
|
||||||
utility under OS X).
|
utility under macOS).
|
||||||
|
|
||||||
@sampledir{secretstore}
|
@sampledir{secretstore}
|
||||||
|
|
||||||
|
@@ -108,7 +108,7 @@ compatible but can also be binary compatible.
|
|||||||
|
|
||||||
Binary compatibility makes it possible to get the maximum benefit from using
|
Binary compatibility makes it possible to get the maximum benefit from using
|
||||||
shared libraries, also known as dynamic link libraries (DLLs) on Windows or
|
shared libraries, also known as dynamic link libraries (DLLs) on Windows or
|
||||||
dynamic shared libraries on OS X.
|
dynamic shared libraries on macOS.
|
||||||
|
|
||||||
For example, suppose several applications are installed on a system requiring
|
For example, suppose several applications are installed on a system requiring
|
||||||
wxWidgets 2.6.0, 2.6.1 and 2.6.2. Since 2.6.2 is backward compatible with the
|
wxWidgets 2.6.0, 2.6.1 and 2.6.2. Since 2.6.2 is backward compatible with the
|
||||||
|
@@ -82,7 +82,7 @@ XPM nor BMP formats are appropriate as they don't have support for alpha and
|
|||||||
another format, typically PNG, should be used. wxWidgets provides a similar
|
another format, typically PNG, should be used. wxWidgets provides a similar
|
||||||
helper for PNG bitmaps called wxBITMAP_PNG() that can be used to either load
|
helper for PNG bitmaps called wxBITMAP_PNG() that can be used to either load
|
||||||
PNG files embedded in resources (meaning either Windows resource section of the
|
PNG files embedded in resources (meaning either Windows resource section of the
|
||||||
executable file or OS X "Resource" subdirectory of the application bundle) or
|
executable file or macOS "Resource" subdirectory of the application bundle) or
|
||||||
arrays containing PNG data included into the program code itself.
|
arrays containing PNG data included into the program code itself.
|
||||||
|
|
||||||
@see @ref group_class_gdi
|
@see @ref group_class_gdi
|
||||||
|
@@ -5,7 +5,7 @@ CMake Overview {#overview_cmake}
|
|||||||
CMake allows building wxWidgets on various platforms with your preferred build
|
CMake allows building wxWidgets on various platforms with your preferred build
|
||||||
system.
|
system.
|
||||||
|
|
||||||
Most linux distributions contain CMake as a package on Windows and OS X you can
|
Most linux distributions contain CMake as a package on Windows and macOS you can
|
||||||
download an installer at the [CMake Page](https://cmake.org).
|
download an installer at the [CMake Page](https://cmake.org).
|
||||||
|
|
||||||
Using the CMake GUI {#cmake_gui}
|
Using the CMake GUI {#cmake_gui}
|
||||||
@@ -30,7 +30,7 @@ Using the CMake Command Line {#cmake_cli}
|
|||||||
|
|
||||||
Run `cmake --help` to see a list of available generators on your platform.
|
Run `cmake --help` to see a list of available generators on your platform.
|
||||||
These can than be specified using the -G command line option. On Windows it
|
These can than be specified using the -G command line option. On Windows it
|
||||||
is recommended to use Visual Studio and on OS X Xcode is recommended.
|
is recommended to use Visual Studio and on macOS Xcode is recommended.
|
||||||
Various build options can be specified using -D see
|
Various build options can be specified using -D see
|
||||||
[available options](#cmake_options).
|
[available options](#cmake_options).
|
||||||
|
|
||||||
|
@@ -80,12 +80,12 @@ locations when possible.
|
|||||||
|
|
||||||
Depending on the platform, the default location differs. On Windows, it is
|
Depending on the platform, the default location differs. On Windows, it is
|
||||||
alongside the executable. On Unix, translations are expected to be in
|
alongside the executable. On Unix, translations are expected to be in
|
||||||
"$prefix/share/locale". On OS X, application bundle's @em Resources subdirectory
|
"$prefix/share/locale". On macOS, application bundle's @em Resources subdirectory
|
||||||
is used.
|
is used.
|
||||||
|
|
||||||
In all cases, translations are searched for in subdirectories named using the
|
In all cases, translations are searched for in subdirectories named using the
|
||||||
languages codes from ISO 639. The .mo file(s) should be located either directly
|
languages codes from ISO 639. The .mo file(s) should be located either directly
|
||||||
in that directory or in LC_MESSAGES subdirectory. On OS X, ".lproj" extension
|
in that directory or in LC_MESSAGES subdirectory. On macOS, ".lproj" extension
|
||||||
is used for the per-languages Resources subdirectories.
|
is used for the per-languages Resources subdirectories.
|
||||||
|
|
||||||
Here's how an app would typically install the files on Unix:
|
Here's how an app would typically install the files on Unix:
|
||||||
@@ -94,7 +94,7 @@ Here's how an app would typically install the files on Unix:
|
|||||||
/usr/share/locale/de/LC_MESSAGES/myapp.mo
|
/usr/share/locale/de/LC_MESSAGES/myapp.mo
|
||||||
/usr/share/locale/fr/LC_MESSAGES/myapp.mo
|
/usr/share/locale/fr/LC_MESSAGES/myapp.mo
|
||||||
@endcode
|
@endcode
|
||||||
And on OS X:
|
And on macOS:
|
||||||
@code
|
@code
|
||||||
MyApp.app/Contents/MacOS/MyApp
|
MyApp.app/Contents/MacOS/MyApp
|
||||||
MyApp.app/Contents/Resources/de.lproj/myapp.mo
|
MyApp.app/Contents/Resources/de.lproj/myapp.mo
|
||||||
|
@@ -42,7 +42,7 @@ list styles with a renumber option.
|
|||||||
There are a few disadvantages to using wxRichTextCtrl. It is not native, so
|
There are a few disadvantages to using wxRichTextCtrl. It is not native, so
|
||||||
does not behave exactly as a native wxTextCtrl, although common editing
|
does not behave exactly as a native wxTextCtrl, although common editing
|
||||||
conventions are followed. Users may miss the built-in spelling correction on
|
conventions are followed. Users may miss the built-in spelling correction on
|
||||||
OS X, or any special character input that may be provided by the native
|
macOS, or any special character input that may be provided by the native
|
||||||
control. It would also be a poor choice if intended users rely on screen
|
control. It would also be a poor choice if intended users rely on screen
|
||||||
readers that would be not work well with non-native text input implementation.
|
readers that would be not work well with non-native text input implementation.
|
||||||
You might mitigate this by providing the choice between wxTextCtrl and
|
You might mitigate this by providing the choice between wxTextCtrl and
|
||||||
@@ -495,7 +495,7 @@ tables, text boxes, and floating images, in addition to a simplified-HTML mode f
|
|||||||
|
|
||||||
There are also things that could be done to take advantage of the underlying
|
There are also things that could be done to take advantage of the underlying
|
||||||
text capabilities of the platform; higher-level text formatting APIs are
|
text capabilities of the platform; higher-level text formatting APIs are
|
||||||
available on some platforms, such as OS X, and some of translation from
|
available on some platforms, such as macOS, and some of translation from
|
||||||
high level to low level wxDC API is unnecessary. However this would require
|
high level to low level wxDC API is unnecessary. However this would require
|
||||||
additions to the wxWidgets API.
|
additions to the wxWidgets API.
|
||||||
|
|
||||||
|
@@ -135,7 +135,7 @@ to buffer overflows. At last, C++ has a standard string class (@c std::string).
|
|||||||
why the need for wxString? There are several advantages:
|
why the need for wxString? There are several advantages:
|
||||||
|
|
||||||
@li <b>Efficiency:</b> Since wxWidgets 3.0 wxString uses @c std::string (in UTF8
|
@li <b>Efficiency:</b> Since wxWidgets 3.0 wxString uses @c std::string (in UTF8
|
||||||
mode under Linux, Unix and OS X) or @c std::wstring (in UTF16 mode under Windows)
|
mode under Linux, Unix and macOS) or @c std::wstring (in UTF16 mode under Windows)
|
||||||
internally by default to store its contents. wxString will therefore inherit the
|
internally by default to store its contents. wxString will therefore inherit the
|
||||||
performance characteristics from @c std::string.
|
performance characteristics from @c std::string.
|
||||||
@li <b>Compatibility:</b> This class tries to combine almost full compatibility
|
@li <b>Compatibility:</b> This class tries to combine almost full compatibility
|
||||||
|
@@ -182,7 +182,7 @@ aware of the potential problems covered by the following section.
|
|||||||
wxWidgets uses the system @c wchar_t in wxString implementation by default
|
wxWidgets uses the system @c wchar_t in wxString implementation by default
|
||||||
under all systems. Thus, under Microsoft Windows, UCS-2 (simplified version of
|
under all systems. Thus, under Microsoft Windows, UCS-2 (simplified version of
|
||||||
UTF-16 without support for surrogate characters) is used as @c wchar_t is 2
|
UTF-16 without support for surrogate characters) is used as @c wchar_t is 2
|
||||||
bytes on this platform. Under Unix systems, including OS X, UCS-4 (also
|
bytes on this platform. Under Unix systems, including macOS, UCS-4 (also
|
||||||
known as UTF-32) is used by default, however it is also possible to build
|
known as UTF-32) is used by default, however it is also possible to build
|
||||||
wxWidgets to use UTF-8 internally by passing @c \--enable-utf8 option to
|
wxWidgets to use UTF-8 internally by passing @c \--enable-utf8 option to
|
||||||
configure.
|
configure.
|
||||||
|
@@ -2663,15 +2663,15 @@ should be processed on. It is filtered out and ignored on any other platforms.
|
|||||||
Possible elemental values are:
|
Possible elemental values are:
|
||||||
@beginDefList
|
@beginDefList
|
||||||
@itemdef{ @c win, Windows }
|
@itemdef{ @c win, Windows }
|
||||||
@itemdef{ @c mac, OS X (or Mac Classic in wxWidgets version supporting it) }
|
@itemdef{ @c mac, macOS (or Mac Classic in wxWidgets version supporting it) }
|
||||||
@itemdef{ @c unix, Any Unix platform @em except OS X }
|
@itemdef{ @c unix, Any Unix platform @em except macOS }
|
||||||
@endDefList
|
@endDefList
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
@code
|
@code
|
||||||
<label platform="win">Windows</label>
|
<label platform="win">Windows</label>
|
||||||
<label platform="unix">Unix</label>
|
<label platform="unix">Unix</label>
|
||||||
<label platform="mac">OS X</label>
|
<label platform="mac">macOS</label>
|
||||||
<help platform="mac|unix">Not a Windows machine</help>
|
<help platform="mac|unix">Not a Windows machine</help>
|
||||||
@endcode
|
@endcode
|
||||||
|
|
||||||
|
@@ -5,7 +5,7 @@ wxiOS is far from a full supported port, but can be used
|
|||||||
as base for simple applications and future improvements.
|
as base for simple applications and future improvements.
|
||||||
|
|
||||||
It requires Xcode with iOS SDK 9.0 or later. Xcode is available
|
It requires Xcode with iOS SDK 9.0 or later. Xcode is available
|
||||||
for free in the OS X app store.
|
for free in the macOS app store.
|
||||||
|
|
||||||
To build wxiOS you should use Xcode to open the minimal samples
|
To build wxiOS you should use Xcode to open the minimal samples
|
||||||
Xcode project file located at:
|
Xcode project file located at:
|
||||||
|
@@ -1,4 +1,4 @@
|
|||||||
wxWidgets for OS X installation {#plat_osx_install}
|
wxWidgets for macOS installation {#plat_osx_install}
|
||||||
-----------------------------------
|
-----------------------------------
|
||||||
|
|
||||||
[TOC]
|
[TOC]
|
||||||
@@ -33,7 +33,7 @@ After the compilation completes, use Finder to run the samples and demos
|
|||||||
* The source code for the samples is in wxWidgets/samples
|
* The source code for the samples is in wxWidgets/samples
|
||||||
* The source code for the demos is in wxWidgets/demos
|
* The source code for the demos is in wxWidgets/demos
|
||||||
|
|
||||||
More information about building on OS X is available in the wxWiki.
|
More information about building on macOS is available in the wxWiki.
|
||||||
Here are two useful links
|
Here are two useful links
|
||||||
* https://wiki.wxwidgets.org/Guides_%26_Tutorials
|
* https://wiki.wxwidgets.org/Guides_%26_Tutorials
|
||||||
* https://wiki.wxwidgets.org/Development:_wxMac
|
* https://wiki.wxwidgets.org/Development:_wxMac
|
||||||
|
@@ -97,7 +97,7 @@ This version of wxWidgets supports the following primary platforms:
|
|||||||
|
|
||||||
* Windows XP, Vista, 7, 8 and 10 (32/64 bits).
|
* Windows XP, Vista, 7, 8 and 10 (32/64 bits).
|
||||||
* Most Unix variants using the GTK+ toolkit (version 2.6 or newer)
|
* Most Unix variants using the GTK+ toolkit (version 2.6 or newer)
|
||||||
* OS X (10.10 or newer) using Cocoa (32/64 bits)
|
* macOS (10.10 or newer) using Cocoa (32/64 bits)
|
||||||
|
|
||||||
There is some support for the following platforms:
|
There is some support for the following platforms:
|
||||||
|
|
||||||
@@ -116,7 +116,7 @@ Files
|
|||||||
wxWidgets is distributed in source form in several archive formats. ZIP and 7z
|
wxWidgets is distributed in source form in several archive formats. ZIP and 7z
|
||||||
archives are for Microsoft Windows users and contain the files with DOS/Windows
|
archives are for Microsoft Windows users and contain the files with DOS/Windows
|
||||||
line endings while the compressed tar archives are for Unix systems (including
|
line endings while the compressed tar archives are for Unix systems (including
|
||||||
OS X) and contain the files with Unix line endings. Please notice that some
|
macOS) and contain the files with Unix line endings. Please notice that some
|
||||||
Windows tools still don't accept files with Unix line endings and that compiling
|
Windows tools still don't accept files with Unix line endings and that compiling
|
||||||
sources with DOS line endings under Unix will fail, so please choose the correct
|
sources with DOS line endings under Unix will fail, so please choose the correct
|
||||||
file for your system.
|
file for your system.
|
||||||
|
@@ -230,7 +230,7 @@ public:
|
|||||||
"Version " to @a version).
|
"Version " to @a version).
|
||||||
|
|
||||||
The generic about dialog and native GTK+ dialog use @a version only,
|
The generic about dialog and native GTK+ dialog use @a version only,
|
||||||
as a suffix to the program name. The native MSW and OS X about dialogs
|
as a suffix to the program name. The native MSW and macOS about dialogs
|
||||||
use the long version.
|
use the long version.
|
||||||
*/
|
*/
|
||||||
void SetVersion(const wxString& version, const wxString& longVersion = wxString());
|
void SetVersion(const wxString& version, const wxString& longVersion = wxString());
|
||||||
|
@@ -15,13 +15,13 @@ enum wxAcceleratorEntryFlags
|
|||||||
/** hold Alt key down */
|
/** hold Alt key down */
|
||||||
wxACCEL_ALT,
|
wxACCEL_ALT,
|
||||||
|
|
||||||
/** hold Ctrl key down, corresponds to Command key on OS X */
|
/** hold Ctrl key down, corresponds to Command key on macOS */
|
||||||
wxACCEL_CTRL,
|
wxACCEL_CTRL,
|
||||||
|
|
||||||
/** hold Shift key down */
|
/** hold Shift key down */
|
||||||
wxACCEL_SHIFT,
|
wxACCEL_SHIFT,
|
||||||
|
|
||||||
/** corresponds to real Ctrl key on OS X, identic to @c wxACCEL_CTRL on other platforms */
|
/** corresponds to real Ctrl key on macOS, identic to @c wxACCEL_CTRL on other platforms */
|
||||||
wxACCEL_RAW_CTRL,
|
wxACCEL_RAW_CTRL,
|
||||||
|
|
||||||
/** deprecated, identic to @c wxACCEL_CTRL on all platforms. */
|
/** deprecated, identic to @c wxACCEL_CTRL on all platforms. */
|
||||||
|
@@ -95,8 +95,8 @@ public:
|
|||||||
using this control instead of just creating and managing the buttons
|
using this control instead of just creating and managing the buttons
|
||||||
directly is that the correct buttons and layout for the current platform
|
directly is that the correct buttons and layout for the current platform
|
||||||
are used by this class. E.g. the buttons are positioned under the list
|
are used by this class. E.g. the buttons are positioned under the list
|
||||||
control under OS X and GTK+ but to its right under MSW and the buttons
|
control under macOS and GTK+ but to its right under MSW and the buttons
|
||||||
themselves use system-specific bitmaps under OS X.
|
themselves use system-specific bitmaps under macOS.
|
||||||
|
|
||||||
This class is always used in conjunction with wxAddRemoveAdaptor which is
|
This class is always used in conjunction with wxAddRemoveAdaptor which is
|
||||||
used to actually add items to or remove them from the control containing
|
used to actually add items to or remove them from the control containing
|
||||||
|
@@ -771,7 +771,7 @@ public:
|
|||||||
|
|
||||||
Under Windows and Linux/Unix, you should parse the command line
|
Under Windows and Linux/Unix, you should parse the command line
|
||||||
arguments and check for files to be opened when starting your
|
arguments and check for files to be opened when starting your
|
||||||
application. Under OS X, you need to override MacOpenFiles()
|
application. Under macOS, you need to override MacOpenFiles()
|
||||||
since command line arguments are used differently there.
|
since command line arguments are used differently there.
|
||||||
|
|
||||||
You may use the wxCmdLineParser to parse command line arguments.
|
You may use the wxCmdLineParser to parse command line arguments.
|
||||||
@@ -1054,7 +1054,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
May be overridden to indicate that the application is not a foreground
|
May be overridden to indicate that the application is not a foreground
|
||||||
GUI application under OS X.
|
GUI application under macOS.
|
||||||
|
|
||||||
This method is called during the application startup and returns @true
|
This method is called during the application startup and returns @true
|
||||||
by default. In this case, wxWidgets ensures that the application is ran
|
by default. In this case, wxWidgets ensures that the application is ran
|
||||||
|
@@ -9,7 +9,7 @@
|
|||||||
@class wxAppProgressIndicator
|
@class wxAppProgressIndicator
|
||||||
|
|
||||||
A helper class that can be used to update the progress bar in the taskbar
|
A helper class that can be used to update the progress bar in the taskbar
|
||||||
button on Windows and the dock icon on OS X.
|
button on Windows and the dock icon on macOS.
|
||||||
|
|
||||||
@library{wxcore}
|
@library{wxcore}
|
||||||
@category{misc}
|
@category{misc}
|
||||||
|
@@ -665,7 +665,7 @@ public:
|
|||||||
@endcode
|
@endcode
|
||||||
in your application startup code.
|
in your application startup code.
|
||||||
|
|
||||||
However under OS X this function uses native image loading and so
|
However under macOS this function uses native image loading and so
|
||||||
doesn't require wxWidgets PNG support.
|
doesn't require wxWidgets PNG support.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
|
@@ -12,7 +12,7 @@
|
|||||||
bits is set if point is over a tab.
|
bits is set if point is over a tab.
|
||||||
Notice that wxOSX currently only returns wxBK_HITTEST_ONLABEL or
|
Notice that wxOSX currently only returns wxBK_HITTEST_ONLABEL or
|
||||||
wxBK_HITTEST_NOWHERE and never the other values, so you should only test
|
wxBK_HITTEST_NOWHERE and never the other values, so you should only test
|
||||||
for these two in the code that should be portable under OS X.
|
for these two in the code that should be portable under macOS.
|
||||||
*/
|
*/
|
||||||
enum
|
enum
|
||||||
{
|
{
|
||||||
|
@@ -32,7 +32,7 @@
|
|||||||
|
|
||||||
A button may have either a single image for all states or different images
|
A button may have either a single image for all states or different images
|
||||||
for the following states (different images are not currently supported
|
for the following states (different images are not currently supported
|
||||||
under OS X where the normal image is used for all states):
|
under macOS where the normal image is used for all states):
|
||||||
@li @b normal: the default state
|
@li @b normal: the default state
|
||||||
@li @b disabled: bitmap shown when the button is disabled.
|
@li @b disabled: bitmap shown when the button is disabled.
|
||||||
@li @b pressed: bitmap shown when the button is pushed (e.g. while the user
|
@li @b pressed: bitmap shown when the button is pushed (e.g. while the user
|
||||||
@@ -115,7 +115,7 @@ public:
|
|||||||
@ref page_stockitems "this list", a standard label will be used. In
|
@ref page_stockitems "this list", a standard label will be used. In
|
||||||
other words, if you use a predefined @c wxID_XXX constant, just omit
|
other words, if you use a predefined @c wxID_XXX constant, just omit
|
||||||
the label completely rather than specifying it. In particular, help
|
the label completely rather than specifying it. In particular, help
|
||||||
buttons (the ones with @a id of @c wxID_HELP) under OS X can't
|
buttons (the ones with @a id of @c wxID_HELP) under macOS can't
|
||||||
display any label at all and while wxButton will detect if the standard
|
display any label at all and while wxButton will detect if the standard
|
||||||
"Help" label is used and ignore it, using any other label will prevent
|
"Help" label is used and ignore it, using any other label will prevent
|
||||||
the button from correctly appearing as a help button and so should be
|
the button from correctly appearing as a help button and so should be
|
||||||
|
@@ -125,7 +125,7 @@ typedef wxUSE_UNICODE_dependent wxUChar;
|
|||||||
\- @c wchar_t when <tt>wxUSE_UNICODE_WCHAR==1</tt> and <tt>wxUSE_UNICODE==1</tt>
|
\- @c wchar_t when <tt>wxUSE_UNICODE_WCHAR==1</tt> and <tt>wxUSE_UNICODE==1</tt>
|
||||||
|
|
||||||
The @c wxUSE_UNICODE_WCHAR symbol is defined to @c 1 when building on
|
The @c wxUSE_UNICODE_WCHAR symbol is defined to @c 1 when building on
|
||||||
Windows while it's defined to @c 0 when building on Unix, Linux or OS X.
|
Windows while it's defined to @c 0 when building on Unix, Linux or macOS.
|
||||||
(Note that @c wxUSE_UNICODE_UTF8 symbol is defined as the opposite of
|
(Note that @c wxUSE_UNICODE_UTF8 symbol is defined as the opposite of
|
||||||
@c wxUSE_UNICODE_WCHAR.)
|
@c wxUSE_UNICODE_WCHAR.)
|
||||||
|
|
||||||
|
@@ -730,7 +730,7 @@ public:
|
|||||||
Sets a hint shown in an empty unfocused combo control.
|
Sets a hint shown in an empty unfocused combo control.
|
||||||
|
|
||||||
Notice that hints are known as <em>cue banners</em> under MSW or
|
Notice that hints are known as <em>cue banners</em> under MSW or
|
||||||
<em>placeholder strings</em> under OS X.
|
<em>placeholder strings</em> under macOS.
|
||||||
|
|
||||||
@see wxTextEntry::SetHint()
|
@see wxTextEntry::SetHint()
|
||||||
|
|
||||||
|
@@ -182,7 +182,7 @@ public:
|
|||||||
so that this button is only added to a dialog for non-Windows platforms
|
so that this button is only added to a dialog for non-Windows platforms
|
||||||
(use wxDIALOG_EX_CONTEXTHELP on Windows).
|
(use wxDIALOG_EX_CONTEXTHELP on Windows).
|
||||||
|
|
||||||
Note that on OS X, the cursor does not change when in context-sensitive
|
Note that on macOS, the cursor does not change when in context-sensitive
|
||||||
help mode.
|
help mode.
|
||||||
|
|
||||||
@library{wxcore}
|
@library{wxcore}
|
||||||
|
@@ -140,7 +140,7 @@ public:
|
|||||||
- under MacOS, it defaults to @c wxBITMAP_TYPE_MACCURSOR_RESOURCE;
|
- under MacOS, it defaults to @c wxBITMAP_TYPE_MACCURSOR_RESOURCE;
|
||||||
when specifying a string resource name, first the color cursors 'crsr'
|
when specifying a string resource name, first the color cursors 'crsr'
|
||||||
and then the black/white cursors 'CURS' in the resource chain are scanned
|
and then the black/white cursors 'CURS' in the resource chain are scanned
|
||||||
through. Note that resource forks are deprecated on OS X so this
|
through. Note that resource forks are deprecated on macOS so this
|
||||||
is only available for legacy reasons and should not be used in
|
is only available for legacy reasons and should not be used in
|
||||||
new code.
|
new code.
|
||||||
- under GTK, it defaults to @c wxBITMAP_TYPE_XPM.
|
- under GTK, it defaults to @c wxBITMAP_TYPE_XPM.
|
||||||
|
@@ -613,9 +613,9 @@ public:
|
|||||||
wxDataViewVirtualListModel is a specialized data model which lets you address
|
wxDataViewVirtualListModel is a specialized data model which lets you address
|
||||||
an item by its position (row) rather than its wxDataViewItem and as such offers
|
an item by its position (row) rather than its wxDataViewItem and as such offers
|
||||||
the exact same interface as wxDataViewIndexListModel.
|
the exact same interface as wxDataViewIndexListModel.
|
||||||
The important difference is that under platforms other than OS X, using this
|
The important difference is that under platforms other than macOS, using this
|
||||||
model will result in a truly virtual control able to handle millions of items
|
model will result in a truly virtual control able to handle millions of items
|
||||||
as the control doesn't store any item (a feature not supported by OS X).
|
as the control doesn't store any item (a feature not supported by macOS).
|
||||||
|
|
||||||
@see wxDataViewListModel for the API.
|
@see wxDataViewListModel for the API.
|
||||||
|
|
||||||
@@ -733,7 +733,7 @@ public:
|
|||||||
text.
|
text.
|
||||||
|
|
||||||
Currently this attribute is only supported in the generic version of
|
Currently this attribute is only supported in the generic version of
|
||||||
wxDataViewCtrl and GTK and ignored by the native OS X implementations.
|
wxDataViewCtrl and GTK and ignored by the native macOS implementations.
|
||||||
|
|
||||||
@since 3.1.2
|
@since 3.1.2
|
||||||
*/
|
*/
|
||||||
@@ -981,7 +981,7 @@ wxEventType wxEVT_DATAVIEW_ITEM_DROP;
|
|||||||
Process a @c wxEVT_DATAVIEW_COLUMN_HEADER_CLICK event.
|
Process a @c wxEVT_DATAVIEW_COLUMN_HEADER_CLICK event.
|
||||||
@event{EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK(id, func)}
|
@event{EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK(id, func)}
|
||||||
Process a @c wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK event.
|
Process a @c wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK event.
|
||||||
Notice that currently this event is not generated in the native OS X
|
Notice that currently this event is not generated in the native macOS
|
||||||
versions of the control.
|
versions of the control.
|
||||||
@event{EVT_DATAVIEW_COLUMN_SORTED(id, func)}
|
@event{EVT_DATAVIEW_COLUMN_SORTED(id, func)}
|
||||||
Process a @c wxEVT_DATAVIEW_COLUMN_SORTED event.
|
Process a @c wxEVT_DATAVIEW_COLUMN_SORTED event.
|
||||||
@@ -1433,8 +1433,8 @@ public:
|
|||||||
style as in the case of single selection it returns the same thing as
|
style as in the case of single selection it returns the same thing as
|
||||||
GetSelection().
|
GetSelection().
|
||||||
|
|
||||||
Notice that under all platforms except OS X the currently focused
|
Notice that under all platforms except macOS the currently focused
|
||||||
item may be selected or not but under OS X the current item is always
|
item may be selected or not but under macOS the current item is always
|
||||||
selected.
|
selected.
|
||||||
|
|
||||||
@see SetCurrentItem(), GetCurrentColumn()
|
@see SetCurrentItem(), GetCurrentColumn()
|
||||||
@@ -1639,7 +1639,7 @@ public:
|
|||||||
In single selection mode, calling this method is the same as calling
|
In single selection mode, calling this method is the same as calling
|
||||||
Select() and is thus not very useful. In multiple selection mode this
|
Select() and is thus not very useful. In multiple selection mode this
|
||||||
method only moves the current item however without changing the
|
method only moves the current item however without changing the
|
||||||
selection except under OS X where the current item is always selected,
|
selection except under macOS where the current item is always selected,
|
||||||
so calling SetCurrentItem() selects @a item if it hadn't been selected
|
so calling SetCurrentItem() selects @a item if it hadn't been selected
|
||||||
before.
|
before.
|
||||||
|
|
||||||
@@ -1695,7 +1695,7 @@ public:
|
|||||||
This function can only be used when all rows have the same height, i.e.
|
This function can only be used when all rows have the same height, i.e.
|
||||||
when wxDV_VARIABLE_LINE_HEIGHT flag is not used.
|
when wxDV_VARIABLE_LINE_HEIGHT flag is not used.
|
||||||
|
|
||||||
Currently this is implemented in the generic and native GTK and OS X
|
Currently this is implemented in the generic and native GTK and macOS
|
||||||
(since 3.1.1) versions.
|
(since 3.1.1) versions.
|
||||||
|
|
||||||
Also notice that this method can only be used to increase the row
|
Also notice that this method can only be used to increase the row
|
||||||
@@ -2030,7 +2030,7 @@ public:
|
|||||||
The default value of @c wxDVR_DEFAULT_ALIGNMENT indicates that the content
|
The default value of @c wxDVR_DEFAULT_ALIGNMENT indicates that the content
|
||||||
should have the same alignment as the column header.
|
should have the same alignment as the column header.
|
||||||
|
|
||||||
The method is not implemented under OS X and the renderer always aligns
|
The method is not implemented under macOS and the renderer always aligns
|
||||||
its contents as the column header on that platform. The other platforms
|
its contents as the column header on that platform. The other platforms
|
||||||
support both vertical and horizontal alignment.
|
support both vertical and horizontal alignment.
|
||||||
*/
|
*/
|
||||||
@@ -3822,7 +3822,7 @@ public:
|
|||||||
|
|
||||||
Currently support for setting this field and for vetoing the change is
|
Currently support for setting this field and for vetoing the change is
|
||||||
only available in the generic version of wxDataViewCtrl, i.e. under MSW
|
only available in the generic version of wxDataViewCtrl, i.e. under MSW
|
||||||
but not GTK nor OS X.
|
but not GTK nor macOS.
|
||||||
|
|
||||||
@since 2.9.3
|
@since 2.9.3
|
||||||
*/
|
*/
|
||||||
@@ -3883,7 +3883,7 @@ public:
|
|||||||
moved) and ::wxDrag_DefaultMove.
|
moved) and ::wxDrag_DefaultMove.
|
||||||
|
|
||||||
Currently it is only honoured by the generic version of wxDataViewCtrl
|
Currently it is only honoured by the generic version of wxDataViewCtrl
|
||||||
(used e.g. under MSW) and not supported by the native GTK and OS X
|
(used e.g. under MSW) and not supported by the native GTK and macOS
|
||||||
versions.
|
versions.
|
||||||
|
|
||||||
@see GetDropEffect()
|
@see GetDropEffect()
|
||||||
@@ -3903,7 +3903,7 @@ public:
|
|||||||
|
|
||||||
Currently this is only available when using the generic version of
|
Currently this is only available when using the generic version of
|
||||||
wxDataViewCtrl (used e.g. under MSW) and always returns ::wxDragNone in
|
wxDataViewCtrl (used e.g. under MSW) and always returns ::wxDragNone in
|
||||||
the GTK and OS X native versions.
|
the GTK and macOS native versions.
|
||||||
|
|
||||||
@since 2.9.4
|
@since 2.9.4
|
||||||
*/
|
*/
|
||||||
|
@@ -164,7 +164,7 @@ struct wxFontMetrics
|
|||||||
In general wxDC methods don't support alpha transparency and the alpha
|
In general wxDC methods don't support alpha transparency and the alpha
|
||||||
component of wxColour is simply ignored and you need to use wxGraphicsContext
|
component of wxColour is simply ignored and you need to use wxGraphicsContext
|
||||||
for full transparency support. There are, however, a few exceptions: first,
|
for full transparency support. There are, however, a few exceptions: first,
|
||||||
under OS X and GTK+ 3 colours with alpha channel are supported in all the normal
|
under macOS and GTK+ 3 colours with alpha channel are supported in all the normal
|
||||||
wxDC-derived classes as they use wxGraphicsContext internally. Second,
|
wxDC-derived classes as they use wxGraphicsContext internally. Second,
|
||||||
under all platforms wxSVGFileDC also fully supports alpha channel. In both
|
under all platforms wxSVGFileDC also fully supports alpha channel. In both
|
||||||
of these cases the instances of wxPen or wxBrush that are built from
|
of these cases the instances of wxPen or wxBrush that are built from
|
||||||
@@ -173,7 +173,7 @@ struct wxFontMetrics
|
|||||||
|
|
||||||
@section dc_transform_support Support for Transformation Matrix
|
@section dc_transform_support Support for Transformation Matrix
|
||||||
|
|
||||||
On some platforms (currently under MSW, GTK+ 3, OS X) wxDC has support for
|
On some platforms (currently under MSW, GTK+ 3, macOS) wxDC has support for
|
||||||
applying an arbitrary affine transformation matrix to its coordinate system
|
applying an arbitrary affine transformation matrix to its coordinate system
|
||||||
(since 3.1.1 this feature is also supported by wxGCDC in all ports).
|
(since 3.1.1 this feature is also supported by wxGCDC in all ports).
|
||||||
Call CanUseTransformMatrix() to check if this support is available and then
|
Call CanUseTransformMatrix() to check if this support is available and then
|
||||||
@@ -1640,7 +1640,7 @@ public:
|
|||||||
context, if this wxDC has something that could be thought of in that
|
context, if this wxDC has something that could be thought of in that
|
||||||
way. (Not all of them do.)
|
way. (Not all of them do.)
|
||||||
|
|
||||||
For example, on Windows the return value is an HDC, on OS X it is a
|
For example, on Windows the return value is an HDC, on macOS it is a
|
||||||
CGContextRef and on wxGTK it will be a GdkDrawable. If the DC is a
|
CGContextRef and on wxGTK it will be a GdkDrawable. If the DC is a
|
||||||
wxGCDC then the return value will be the value returned from
|
wxGCDC then the return value will be the value returned from
|
||||||
wxGraphicsContext::GetNativeContext. A value of NULL is returned if
|
wxGraphicsContext::GetNativeContext. A value of NULL is returned if
|
||||||
|
@@ -40,7 +40,7 @@
|
|||||||
backing store for the window contents. In this case, the associated @e DC
|
backing store for the window contents. In this case, the associated @e DC
|
||||||
may be @NULL but a valid backing store bitmap should be specified.
|
may be @NULL but a valid backing store bitmap should be specified.
|
||||||
|
|
||||||
Finally, please note that GTK+ 2.0 as well as OS X provide double buffering
|
Finally, please note that GTK+ 2.0 as well as macOS provide double buffering
|
||||||
themselves natively. You can either use wxWindow::IsDoubleBuffered() to
|
themselves natively. You can either use wxWindow::IsDoubleBuffered() to
|
||||||
determine whether you need to use buffering or not, or use
|
determine whether you need to use buffering or not, or use
|
||||||
wxAutoBufferedPaintDC to avoid needless double buffering on the systems
|
wxAutoBufferedPaintDC to avoid needless double buffering on the systems
|
||||||
|
@@ -931,13 +931,13 @@ enum wxKeyCode
|
|||||||
WXK_CLEAR,
|
WXK_CLEAR,
|
||||||
WXK_SHIFT,
|
WXK_SHIFT,
|
||||||
WXK_ALT,
|
WXK_ALT,
|
||||||
/** Note that under OS X, to improve compatibility with other
|
/** Note that under macOS, to improve compatibility with other
|
||||||
* systems, 'WXK_CONTROL' represents the 'Command' key. Use this
|
* systems, 'WXK_CONTROL' represents the 'Command' key. Use this
|
||||||
* constant to work with keyboard shortcuts. See 'WXK_RAW_CONTROL'
|
* constant to work with keyboard shortcuts. See 'WXK_RAW_CONTROL'
|
||||||
* to get the state of the actual 'Control' key.
|
* to get the state of the actual 'Control' key.
|
||||||
*/
|
*/
|
||||||
WXK_CONTROL,
|
WXK_CONTROL,
|
||||||
/** Under OS X, where the 'Command' key is mapped to 'Control'
|
/** Under macOS, where the 'Command' key is mapped to 'Control'
|
||||||
* to improve compatibility with other systems, WXK_RAW_CONTROL may
|
* to improve compatibility with other systems, WXK_RAW_CONTROL may
|
||||||
* be used to obtain the state of the actual 'Control' key
|
* be used to obtain the state of the actual 'Control' key
|
||||||
* ('WXK_CONTROL' would obtain the status of the 'Command' key).
|
* ('WXK_CONTROL' would obtain the status of the 'Command' key).
|
||||||
@@ -1035,7 +1035,7 @@ enum wxKeyCode
|
|||||||
WXK_WINDOWS_RIGHT,
|
WXK_WINDOWS_RIGHT,
|
||||||
WXK_WINDOWS_MENU ,
|
WXK_WINDOWS_MENU ,
|
||||||
|
|
||||||
/** This special key code was used to represent the key used for keyboard shortcuts. Under OS X,
|
/** This special key code was used to represent the key used for keyboard shortcuts. Under macOS,
|
||||||
* this key maps to the 'Command' (aka logo or 'Apple') key, whereas on Linux/Windows/others
|
* this key maps to the 'Command' (aka logo or 'Apple') key, whereas on Linux/Windows/others
|
||||||
* this is the Control key, with the new semantic of WXK_CONTROL, WXK_COMMAND is not needed anymore
|
* this is the Control key, with the new semantic of WXK_CONTROL, WXK_COMMAND is not needed anymore
|
||||||
*/
|
*/
|
||||||
@@ -1089,14 +1089,14 @@ enum wxKeyModifier
|
|||||||
{
|
{
|
||||||
wxMOD_NONE = 0x0000,
|
wxMOD_NONE = 0x0000,
|
||||||
wxMOD_ALT = 0x0001,
|
wxMOD_ALT = 0x0001,
|
||||||
/** Ctlr Key, corresponds to Command key on OS X */
|
/** Ctlr Key, corresponds to Command key on macOS */
|
||||||
wxMOD_CONTROL = 0x0002,
|
wxMOD_CONTROL = 0x0002,
|
||||||
wxMOD_ALTGR = wxMOD_ALT | wxMOD_CONTROL,
|
wxMOD_ALTGR = wxMOD_ALT | wxMOD_CONTROL,
|
||||||
wxMOD_SHIFT = 0x0004,
|
wxMOD_SHIFT = 0x0004,
|
||||||
wxMOD_META = 0x0008,
|
wxMOD_META = 0x0008,
|
||||||
wxMOD_WIN = wxMOD_META,
|
wxMOD_WIN = wxMOD_META,
|
||||||
|
|
||||||
/** used to describe the true Ctrl Key under OS X,
|
/** used to describe the true Ctrl Key under macOS,
|
||||||
identic to @c wxMOD_CONTROL on other platforms */
|
identic to @c wxMOD_CONTROL on other platforms */
|
||||||
wxMOD_RAW_CONTROL,
|
wxMOD_RAW_CONTROL,
|
||||||
|
|
||||||
|
@@ -126,7 +126,7 @@ enum wxDialogLayoutAdaptationMode
|
|||||||
calling SetExtraStyle() before Create is called (two-step
|
calling SetExtraStyle() before Create is called (two-step
|
||||||
construction).
|
construction).
|
||||||
@style{wxDIALOG_EX_METAL}
|
@style{wxDIALOG_EX_METAL}
|
||||||
On OS X, frames with this style will be shown with a metallic
|
On macOS, frames with this style will be shown with a metallic
|
||||||
look. This is an extra style.
|
look. This is an extra style.
|
||||||
@endStyleTable
|
@endStyleTable
|
||||||
|
|
||||||
|
@@ -123,7 +123,7 @@ public:
|
|||||||
is included.
|
is included.
|
||||||
|
|
||||||
For example, on Windows @c ".dll" is returned, and either @c ".dylib"
|
For example, on Windows @c ".dll" is returned, and either @c ".dylib"
|
||||||
or @c ".bundle" on OS X.
|
or @c ".bundle" on macOS.
|
||||||
*/
|
*/
|
||||||
static wxString GetDllExt(wxDynamicLibraryCategory cat = wxDL_LIBRARY);
|
static wxString GetDllExt(wxDynamicLibraryCategory cat = wxDL_LIBRARY);
|
||||||
|
|
||||||
|
@@ -1574,7 +1574,7 @@ public:
|
|||||||
Under GTK, the raw key code is the @c keyval field of the corresponding
|
Under GTK, the raw key code is the @c keyval field of the corresponding
|
||||||
GDK event.
|
GDK event.
|
||||||
|
|
||||||
Under OS X, the raw key code is the @c keyCode field of the
|
Under macOS, the raw key code is the @c keyCode field of the
|
||||||
corresponding NSEvent.
|
corresponding NSEvent.
|
||||||
|
|
||||||
@note Currently the raw key codes are not supported by all ports, use
|
@note Currently the raw key codes are not supported by all ports, use
|
||||||
@@ -1594,7 +1594,7 @@ public:
|
|||||||
Under GTK, the raw flags contain the @c hardware_keycode field of the
|
Under GTK, the raw flags contain the @c hardware_keycode field of the
|
||||||
corresponding GDK event.
|
corresponding GDK event.
|
||||||
|
|
||||||
Under OS X, the raw flags contain the modifiers state.
|
Under macOS, the raw flags contain the modifiers state.
|
||||||
|
|
||||||
@note Currently the raw key flags are not supported by all ports, use
|
@note Currently the raw key flags are not supported by all ports, use
|
||||||
@ifdef_ wxHAS_RAW_KEY_CODES to determine if this feature is available.
|
@ifdef_ wxHAS_RAW_KEY_CODES to determine if this feature is available.
|
||||||
@@ -2784,7 +2784,7 @@ public:
|
|||||||
(or zoom in), a negative value means we should shrink (or zoom out).
|
(or zoom in), a negative value means we should shrink (or zoom out).
|
||||||
|
|
||||||
This method is only valid to call for @c wxEVT_MAGNIFY events which are
|
This method is only valid to call for @c wxEVT_MAGNIFY events which are
|
||||||
currently only generated under OS X.
|
currently only generated under macOS.
|
||||||
|
|
||||||
@see Magnify()
|
@see Magnify()
|
||||||
|
|
||||||
@@ -2877,7 +2877,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Returns @true if the event is a magnify (i.e.\ pinch to zoom) event.
|
Returns @true if the event is a magnify (i.e.\ pinch to zoom) event.
|
||||||
|
|
||||||
Such events are currently generated only under OS X.
|
Such events are currently generated only under macOS.
|
||||||
|
|
||||||
@see GetMagnification()
|
@see GetMagnification()
|
||||||
|
|
||||||
|
@@ -108,7 +108,7 @@ const char wxFileSelectorDefaultWildcardStr[];
|
|||||||
descriptive test; "BMP files (*.bmp)|*.bmp" is displayed as "*.bmp", and both
|
descriptive test; "BMP files (*.bmp)|*.bmp" is displayed as "*.bmp", and both
|
||||||
"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif" and "Image files|*.bmp;*.gif"
|
"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif" and "Image files|*.bmp;*.gif"
|
||||||
are errors.
|
are errors.
|
||||||
On Mac OS X in the open file dialog the filter choice box is not shown by default.
|
On Mac macOS in the open file dialog the filter choice box is not shown by default.
|
||||||
Instead all given wildcards are appplied at the same time: So in the above
|
Instead all given wildcards are appplied at the same time: So in the above
|
||||||
example all bmp, gif and png files are displayed. To enforce the
|
example all bmp, gif and png files are displayed. To enforce the
|
||||||
display of the filter choice set the corresponding wxSystemOptions before calling
|
display of the filter choice set the corresponding wxSystemOptions before calling
|
||||||
@@ -117,7 +117,7 @@ const char wxFileSelectorDefaultWildcardStr[];
|
|||||||
wxSystemOptions::SetOption(wxOSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1)
|
wxSystemOptions::SetOption(wxOSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1)
|
||||||
@endcode
|
@endcode
|
||||||
But in contrast to Windows and Unix, where the file type choice filters only
|
But in contrast to Windows and Unix, where the file type choice filters only
|
||||||
the selected files, on Mac OS X even in this case the dialog shows all files
|
the selected files, on Mac macOS even in this case the dialog shows all files
|
||||||
matching all file types. The files which does not match the currently selected
|
matching all file types. The files which does not match the currently selected
|
||||||
file type are greyed out and are not selectable.
|
file type are greyed out and are not selectable.
|
||||||
|
|
||||||
@@ -143,9 +143,9 @@ const char wxFileSelectorDefaultWildcardStr[];
|
|||||||
3.1.0.
|
3.1.0.
|
||||||
@style{wxFD_FILE_MUST_EXIST}
|
@style{wxFD_FILE_MUST_EXIST}
|
||||||
For open dialog only: the user may only select files that actually
|
For open dialog only: the user may only select files that actually
|
||||||
exist. Notice that under OS X the file dialog with @c wxFD_OPEN
|
exist. Notice that under macOS the file dialog with @c wxFD_OPEN
|
||||||
style always behaves as if this style was specified, because it is
|
style always behaves as if this style was specified, because it is
|
||||||
impossible to choose a file that doesn't exist from a standard OS X
|
impossible to choose a file that doesn't exist from a standard macOS
|
||||||
file dialog.
|
file dialog.
|
||||||
@style{wxFD_MULTIPLE}
|
@style{wxFD_MULTIPLE}
|
||||||
For open dialog only: allows selecting multiple files.
|
For open dialog only: allows selecting multiple files.
|
||||||
|
@@ -739,7 +739,7 @@ public:
|
|||||||
This method can be used to allow this application to use the font from
|
This method can be used to allow this application to use the font from
|
||||||
the given file even if it is not globally installed on the system.
|
the given file even if it is not globally installed on the system.
|
||||||
|
|
||||||
Under OS X this method actually doesn't do anything other than check
|
Under macOS this method actually doesn't do anything other than check
|
||||||
for the existence of the file in the "Fonts" subdirectory of the
|
for the existence of the file in the "Fonts" subdirectory of the
|
||||||
application bundle "Resources" directory. You are responsible for
|
application bundle "Resources" directory. You are responsible for
|
||||||
actually making the font file available in this directory and setting
|
actually making the font file available in this directory and setting
|
||||||
|
@@ -119,7 +119,7 @@
|
|||||||
frames having this style (the dialogs don't have a minimize or a
|
frames having this style (the dialogs don't have a minimize or a
|
||||||
maximize box by default)
|
maximize box by default)
|
||||||
@style{wxFRAME_EX_METAL}
|
@style{wxFRAME_EX_METAL}
|
||||||
On OS X, frames with this style will be shown with a metallic
|
On macOS, frames with this style will be shown with a metallic
|
||||||
look. This is an extra style.
|
look. This is an extra style.
|
||||||
@endExtraStyleTable
|
@endExtraStyleTable
|
||||||
|
|
||||||
|
@@ -14,10 +14,10 @@
|
|||||||
system changes.
|
system changes.
|
||||||
|
|
||||||
@note Implementation limitations: this class is currently implemented for
|
@note Implementation limitations: this class is currently implemented for
|
||||||
MSW, OS X and GTK ports but doesn't detect all changes correctly
|
MSW, macOS and GTK ports but doesn't detect all changes correctly
|
||||||
everywhere: under MSW accessing the file is not detected (only
|
everywhere: under MSW accessing the file is not detected (only
|
||||||
modifying it is) and under OS X neither accessing nor modifying is
|
modifying it is) and under macOS neither accessing nor modifying is
|
||||||
detected (only creating and deleting files is). Moreover, OS X
|
detected (only creating and deleting files is). Moreover, macOS
|
||||||
version doesn't currently collapse pairs of create/delete events in a
|
version doesn't currently collapse pairs of create/delete events in a
|
||||||
rename event, unlike the other ones.
|
rename event, unlike the other ones.
|
||||||
|
|
||||||
@@ -85,7 +85,7 @@ public:
|
|||||||
Additionally a file mask can be specified to include only files
|
Additionally a file mask can be specified to include only files
|
||||||
matching that particular mask.
|
matching that particular mask.
|
||||||
|
|
||||||
This method is implemented efficiently on MSW and OS X, but
|
This method is implemented efficiently on MSW and macOS, but
|
||||||
should be used with care on other platforms for directories with lots
|
should be used with care on other platforms for directories with lots
|
||||||
of children (e.g. the root directory) as it calls Add() for each
|
of children (e.g. the root directory) as it calls Add() for each
|
||||||
subdirectory, potentially creating a lot of watches and taking a long
|
subdirectory, potentially creating a lot of watches and taking a long
|
||||||
@@ -250,7 +250,7 @@ enum wxFSWFlags
|
|||||||
Notice that under MSW this event is sometimes -- although not always --
|
Notice that under MSW this event is sometimes -- although not always --
|
||||||
followed by a ::wxFSW_EVENT_MODIFY for the new file.
|
followed by a ::wxFSW_EVENT_MODIFY for the new file.
|
||||||
|
|
||||||
Under OS X this event is only detected when watching entire trees. When
|
Under macOS this event is only detected when watching entire trees. When
|
||||||
watching directories, separate ::wxFSW_EVENT_CREATE and
|
watching directories, separate ::wxFSW_EVENT_CREATE and
|
||||||
::wxFSW_EVENT_DELETE events are detected instead.
|
::wxFSW_EVENT_DELETE events are detected instead.
|
||||||
*/
|
*/
|
||||||
@@ -262,7 +262,7 @@ enum wxFSWFlags
|
|||||||
Depending on the program doing the file modification, multiple such
|
Depending on the program doing the file modification, multiple such
|
||||||
events can be reported for a single logical file update.
|
events can be reported for a single logical file update.
|
||||||
|
|
||||||
Under OS X this event is only detected when watching entire trees.
|
Under macOS this event is only detected when watching entire trees.
|
||||||
*/
|
*/
|
||||||
wxFSW_EVENT_MODIFY = 0x08,
|
wxFSW_EVENT_MODIFY = 0x08,
|
||||||
|
|
||||||
@@ -276,8 +276,8 @@ enum wxFSWFlags
|
|||||||
/**
|
/**
|
||||||
The item's metadata was changed, e.g.\ its permissions or timestamps.
|
The item's metadata was changed, e.g.\ its permissions or timestamps.
|
||||||
|
|
||||||
This event is currently only detected under Linux and OS X.
|
This event is currently only detected under Linux and macOS.
|
||||||
Under OS X this event is only detected when watching entire trees.
|
Under macOS this event is only detected when watching entire trees.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
*/
|
*/
|
||||||
@@ -289,8 +289,8 @@ enum wxFSWFlags
|
|||||||
wxFSW_EVENT_UNMOUNT cannot be set; unmount events are produced automatically. This flag
|
wxFSW_EVENT_UNMOUNT cannot be set; unmount events are produced automatically. This flag
|
||||||
is therefore not included in wxFSW_EVENT_ALL.
|
is therefore not included in wxFSW_EVENT_ALL.
|
||||||
|
|
||||||
This event is currently only detected under Linux and OS X.
|
This event is currently only detected under Linux and macOS.
|
||||||
Under OS X this event is only detected when watching entire trees.
|
Under macOS this event is only detected when watching entire trees.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
*/
|
*/
|
||||||
|
@@ -55,7 +55,7 @@
|
|||||||
This flag is only available in wxWidgets 3.1.0 and later.
|
This flag is only available in wxWidgets 3.1.0 and later.
|
||||||
@style{wxGA_PROGRESS}
|
@style{wxGA_PROGRESS}
|
||||||
Reflect the value of gauge in the application taskbar button under
|
Reflect the value of gauge in the application taskbar button under
|
||||||
Windows 7 and later and the dock icon under OS X, ignored under
|
Windows 7 and later and the dock icon under macOS, ignored under
|
||||||
the other platforms.
|
the other platforms.
|
||||||
This flag is only available in wxWidgets 3.1.0 and later.
|
This flag is only available in wxWidgets 3.1.0 and later.
|
||||||
|
|
||||||
|
@@ -1131,7 +1131,7 @@ const wxSize wxDefaultSize;
|
|||||||
@endcode
|
@endcode
|
||||||
to be able to use @c wxBITMAP_PNG(mybitmap) in the code.
|
to be able to use @c wxBITMAP_PNG(mybitmap) in the code.
|
||||||
|
|
||||||
Under OS X the file with the specified name and "png" extension must be
|
Under macOS the file with the specified name and "png" extension must be
|
||||||
present in the "Resources" subdirectory of the application bundle.
|
present in the "Resources" subdirectory of the application bundle.
|
||||||
|
|
||||||
Under the other platforms, this is equivalent to wxBITMAP_PNG_FROM_DATA()
|
Under the other platforms, this is equivalent to wxBITMAP_PNG_FROM_DATA()
|
||||||
@@ -1175,7 +1175,7 @@ const wxSize wxDefaultSize;
|
|||||||
|
|
||||||
You can use wxBITMAP_PNG() to load the PNG bitmaps from resources on the
|
You can use wxBITMAP_PNG() to load the PNG bitmaps from resources on the
|
||||||
platforms that support this and only fall back to loading them from data
|
platforms that support this and only fall back to loading them from data
|
||||||
under the other ones (i.e. not Windows and not OS X).
|
under the other ones (i.e. not Windows and not macOS).
|
||||||
|
|
||||||
@header{wx/gdicmn.h}
|
@header{wx/gdicmn.h}
|
||||||
|
|
||||||
|
@@ -144,7 +144,7 @@ class wxGLAttributes : public wxGLAttribsBase
|
|||||||
public:
|
public:
|
||||||
/**
|
/**
|
||||||
Use true colour instead of colour index rendering for each pixel.
|
Use true colour instead of colour index rendering for each pixel.
|
||||||
It makes no effect for OS X.
|
It makes no effect for macOS.
|
||||||
*/
|
*/
|
||||||
wxGLAttributes& RGBA();
|
wxGLAttributes& RGBA();
|
||||||
|
|
||||||
@@ -158,7 +158,7 @@ public:
|
|||||||
wxGLAttributes& BufferSize(int val);
|
wxGLAttributes& BufferSize(int val);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Specifies the framebuffer level. It makes no effect for OS X.
|
Specifies the framebuffer level. It makes no effect for macOS.
|
||||||
|
|
||||||
@param val
|
@param val
|
||||||
0 for main buffer, >0 for overlay, <0 for underlay.
|
0 for main buffer, >0 for overlay, <0 for underlay.
|
||||||
@@ -246,7 +246,7 @@ public:
|
|||||||
wxGLAttributes& Samplers(int val);
|
wxGLAttributes& Samplers(int val);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Used to request a frame buffer sRGB capable. It makes no effect for OS X.
|
Used to request a frame buffer sRGB capable. It makes no effect for macOS.
|
||||||
*/
|
*/
|
||||||
wxGLAttributes& FrameBuffersRGB();
|
wxGLAttributes& FrameBuffersRGB();
|
||||||
|
|
||||||
@@ -315,7 +315,7 @@ public:
|
|||||||
@param val
|
@param val
|
||||||
The major version number requested.
|
The major version number requested.
|
||||||
|
|
||||||
It has no effect under OS X where specifying CoreProfile() will
|
It has no effect under macOS where specifying CoreProfile() will
|
||||||
result in using OpenGL version at least 3.2.
|
result in using OpenGL version at least 3.2.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& MajorVersion(int val);
|
wxGLContextAttrs& MajorVersion(int val);
|
||||||
@@ -326,7 +326,7 @@ public:
|
|||||||
@param val
|
@param val
|
||||||
The minor version number requested, e.g. 2 if OpenGL 3.2 is requested.
|
The minor version number requested, e.g. 2 if OpenGL 3.2 is requested.
|
||||||
|
|
||||||
It has no effect under OS X where specifying CoreProfile() will
|
It has no effect under macOS where specifying CoreProfile() will
|
||||||
result in using OpenGL version at least 3.2.
|
result in using OpenGL version at least 3.2.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& MinorVersion(int val);
|
wxGLContextAttrs& MinorVersion(int val);
|
||||||
@@ -340,7 +340,7 @@ public:
|
|||||||
@param vminor
|
@param vminor
|
||||||
The minor version number requested, e.g. 5 if OpenGL 4.5 is requested.
|
The minor version number requested, e.g. 5 if OpenGL 4.5 is requested.
|
||||||
|
|
||||||
It has no effect under OS X where specifying CoreProfile() will
|
It has no effect under macOS where specifying CoreProfile() will
|
||||||
result in using OpenGL version at least 3.2.
|
result in using OpenGL version at least 3.2.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& OGLVersion(int vmayor, int vminor);
|
wxGLContextAttrs& OGLVersion(int vmayor, int vminor);
|
||||||
@@ -358,7 +358,7 @@ public:
|
|||||||
later. They must not support functionality marked as deprecated or
|
later. They must not support functionality marked as deprecated or
|
||||||
removed by the requested version of the OpenGL API.
|
removed by the requested version of the OpenGL API.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& ForwardCompatible();
|
wxGLContextAttrs& ForwardCompatible();
|
||||||
|
|
||||||
@@ -367,7 +367,7 @@ public:
|
|||||||
subsets of OpenGL, lacking some features of the full specification.
|
subsets of OpenGL, lacking some features of the full specification.
|
||||||
Used mainly in embedded devices such as mobile phones.
|
Used mainly in embedded devices such as mobile phones.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& ES2();
|
wxGLContextAttrs& ES2();
|
||||||
|
|
||||||
@@ -376,7 +376,7 @@ public:
|
|||||||
some logs are enabled and also allows OGL to send debug messages through
|
some logs are enabled and also allows OGL to send debug messages through
|
||||||
a callback function.
|
a callback function.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& DebugCtx();
|
wxGLContextAttrs& DebugCtx();
|
||||||
|
|
||||||
@@ -384,14 +384,14 @@ public:
|
|||||||
Request robustness, or how OpenGL handles out-of-bounds buffer object
|
Request robustness, or how OpenGL handles out-of-bounds buffer object
|
||||||
accesses and graphics reset notification behaviours.
|
accesses and graphics reset notification behaviours.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& Robust();
|
wxGLContextAttrs& Robust();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
With robustness enabled, never deliver notification of reset events.
|
With robustness enabled, never deliver notification of reset events.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& NoResetNotify();
|
wxGLContextAttrs& NoResetNotify();
|
||||||
|
|
||||||
@@ -399,7 +399,7 @@ public:
|
|||||||
With robustness enabled, if graphics reset happens, all context state is
|
With robustness enabled, if graphics reset happens, all context state is
|
||||||
lost.
|
lost.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& LoseOnReset();
|
wxGLContextAttrs& LoseOnReset();
|
||||||
|
|
||||||
@@ -407,7 +407,7 @@ public:
|
|||||||
Request OpenGL to protect other applications or shared contexts from reset
|
Request OpenGL to protect other applications or shared contexts from reset
|
||||||
side-effects.
|
side-effects.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& ResetIsolation();
|
wxGLContextAttrs& ResetIsolation();
|
||||||
|
|
||||||
@@ -419,7 +419,7 @@ public:
|
|||||||
@param val
|
@param val
|
||||||
0 for not flushing, 1 (wxWidgets default) for flushing pending commands.
|
0 for not flushing, 1 (wxWidgets default) for flushing pending commands.
|
||||||
|
|
||||||
It has no effect under OS X.
|
It has no effect under macOS.
|
||||||
*/
|
*/
|
||||||
wxGLContextAttrs& ReleaseFlush(int val = 1);
|
wxGLContextAttrs& ReleaseFlush(int val = 1);
|
||||||
|
|
||||||
@@ -620,7 +620,7 @@ enum
|
|||||||
This attribute should be followed by the major version number
|
This attribute should be followed by the major version number
|
||||||
requested.
|
requested.
|
||||||
|
|
||||||
It has no effect under OS X where specifying ::WX_GL_CORE_PROFILE will
|
It has no effect under macOS where specifying ::WX_GL_CORE_PROFILE will
|
||||||
result in using OpenGL version at least 3.2 but can still be used
|
result in using OpenGL version at least 3.2 but can still be used
|
||||||
there for portability.
|
there for portability.
|
||||||
|
|
||||||
@@ -769,7 +769,7 @@ enum
|
|||||||
parameter) but it's discouraged.
|
parameter) but it's discouraged.
|
||||||
|
|
||||||
@note
|
@note
|
||||||
On those platforms which use a configure script (e.g. Linux and OS X)
|
On those platforms which use a configure script (e.g. Linux and macOS)
|
||||||
OpenGL support is automatically enabled if the relative headers and
|
OpenGL support is automatically enabled if the relative headers and
|
||||||
libraries are found.
|
libraries are found.
|
||||||
To switch it on under the other platforms (e.g. Windows), you need to edit
|
To switch it on under the other platforms (e.g. Windows), you need to edit
|
||||||
|
@@ -1327,7 +1327,7 @@ public:
|
|||||||
Creates wxGraphicsBitmap from a native bitmap handle.
|
Creates wxGraphicsBitmap from a native bitmap handle.
|
||||||
|
|
||||||
@a bitmap meaning is platform-dependent. Currently it's a GDI+ @c
|
@a bitmap meaning is platform-dependent. Currently it's a GDI+ @c
|
||||||
Bitmap pointer under MSW, @c CGImage pointer under OS X or a @c
|
Bitmap pointer under MSW, @c CGImage pointer under macOS or a @c
|
||||||
cairo_surface_t pointer when using Cairo under any platform.
|
cairo_surface_t pointer when using Cairo under any platform.
|
||||||
|
|
||||||
Notice that this method takes ownership of @a bitmap, i.e. it will be
|
Notice that this method takes ownership of @a bitmap, i.e. it will be
|
||||||
@@ -1534,7 +1534,7 @@ public:
|
|||||||
|
|
||||||
Currently this function returns "gdiplus" for Windows GDI+
|
Currently this function returns "gdiplus" for Windows GDI+
|
||||||
implementation, "direct2d" for Windows Direct2D implementation,
|
implementation, "direct2d" for Windows Direct2D implementation,
|
||||||
"cairo" for Cairo implementation and "cg" for OS X CoreGraphics
|
"cairo" for Cairo implementation and "cg" for macOS CoreGraphics
|
||||||
implementation.
|
implementation.
|
||||||
|
|
||||||
@remarks The string returned by this method is not user-readable and is
|
@remarks The string returned by this method is not user-readable and is
|
||||||
@@ -1559,7 +1559,7 @@ public:
|
|||||||
virtual void GetVersion(int* major, int* minor = NULL, int* micro=NULL) const = 0;
|
virtual void GetVersion(int* major, int* minor = NULL, int* micro=NULL) const = 0;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns the default renderer on this platform. On OS X this is the Core
|
Returns the default renderer on this platform. On macOS this is the Core
|
||||||
Graphics (a.k.a. Quartz 2D) renderer, on MSW the GDIPlus renderer, and
|
Graphics (a.k.a. Quartz 2D) renderer, on MSW the GDIPlus renderer, and
|
||||||
on GTK we currently default to the Cairo renderer.
|
on GTK we currently default to the Cairo renderer.
|
||||||
*/
|
*/
|
||||||
|
@@ -18,8 +18,8 @@ enum
|
|||||||
/**
|
/**
|
||||||
Size the column automatically to fit all values.
|
Size the column automatically to fit all values.
|
||||||
|
|
||||||
@note On OS X, this style is only implemented in the Cocoa build on
|
@note On macOS, this style is only implemented in the Cocoa build on
|
||||||
OS X >= 10.5; it behaves identically to wxCOL_WIDTH_DEFAULT otherwise.
|
macOS >= 10.5; it behaves identically to wxCOL_WIDTH_DEFAULT otherwise.
|
||||||
*/
|
*/
|
||||||
wxCOL_WIDTH_AUTOSIZE = -2
|
wxCOL_WIDTH_AUTOSIZE = -2
|
||||||
};
|
};
|
||||||
|
@@ -20,7 +20,7 @@
|
|||||||
RunScript return a value, which is a very critical feature in many web
|
RunScript return a value, which is a very critical feature in many web
|
||||||
embedding scenarios.
|
embedding scenarios.
|
||||||
|
|
||||||
This class is only available on OS X.
|
This class is only available on macOS.
|
||||||
**/
|
**/
|
||||||
|
|
||||||
class wxWebKitCtrl : public wxControl
|
class wxWebKitCtrl : public wxControl
|
||||||
|
@@ -131,7 +131,7 @@ enum wxLocaleInfo
|
|||||||
Short date format.
|
Short date format.
|
||||||
|
|
||||||
Notice that short and long date formats may be the same under POSIX
|
Notice that short and long date formats may be the same under POSIX
|
||||||
systems currently but may, and typically are, different under MSW or OS X.
|
systems currently but may, and typically are, different under MSW or macOS.
|
||||||
|
|
||||||
@since 2.9.0
|
@since 2.9.0
|
||||||
*/
|
*/
|
||||||
|
@@ -85,7 +85,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Returns true if Control or Alt are pressed.
|
Returns true if Control or Alt are pressed.
|
||||||
|
|
||||||
Checks if Control, Alt or, under OS X only, Command key are pressed
|
Checks if Control, Alt or, under macOS only, Command key are pressed
|
||||||
(notice that the real Control key is still taken into account under OS
|
(notice that the real Control key is still taken into account under OS
|
||||||
X too).
|
X too).
|
||||||
|
|
||||||
@@ -97,7 +97,7 @@ public:
|
|||||||
bool HasModifiers() const;
|
bool HasModifiers() const;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns true if the Control key or Apple/Command key under OS X is pressed.
|
Returns true if the Control key or Apple/Command key under macOS is pressed.
|
||||||
|
|
||||||
This function doesn't distinguish between right and left control keys.
|
This function doesn't distinguish between right and left control keys.
|
||||||
|
|
||||||
@@ -106,7 +106,7 @@ public:
|
|||||||
bool ControlDown() const;
|
bool ControlDown() const;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns true if the Control key (also under OS X).
|
Returns true if the Control key (also under macOS).
|
||||||
|
|
||||||
This function doesn't distinguish between right and left control keys.
|
This function doesn't distinguish between right and left control keys.
|
||||||
|
|
||||||
|
@@ -588,7 +588,7 @@ public:
|
|||||||
Returns @NULL if no label is being edited.
|
Returns @NULL if no label is being edited.
|
||||||
|
|
||||||
@note It is currently only implemented for wxMSW and the generic version,
|
@note It is currently only implemented for wxMSW and the generic version,
|
||||||
not for the native OS X version.
|
not for the native macOS version.
|
||||||
*/
|
*/
|
||||||
wxTextCtrl* GetEditControl() const;
|
wxTextCtrl* GetEditControl() const;
|
||||||
|
|
||||||
|
@@ -251,7 +251,7 @@ public:
|
|||||||
and this function can be used to retrieve it. Notice that the default
|
and this function can be used to retrieve it. Notice that the default
|
||||||
menu can be replaced by calling SetWindowMenu().
|
menu can be replaced by calling SetWindowMenu().
|
||||||
|
|
||||||
This function is currently not available under OS X.
|
This function is currently not available under macOS.
|
||||||
|
|
||||||
@return The current Window menu or @NULL.
|
@return The current Window menu or @NULL.
|
||||||
*/
|
*/
|
||||||
@@ -320,7 +320,7 @@ public:
|
|||||||
All of which are handled by wxMDIParentFrame itself. If any other
|
All of which are handled by wxMDIParentFrame itself. If any other
|
||||||
commands are used in the menu, the derived frame should handle them.
|
commands are used in the menu, the derived frame should handle them.
|
||||||
|
|
||||||
This function is currently not available under OS X.
|
This function is currently not available under macOS.
|
||||||
|
|
||||||
@param menu
|
@param menu
|
||||||
The menu to be used instead of the standard MDI Window menu or @NULL.
|
The menu to be used instead of the standard MDI Window menu or @NULL.
|
||||||
|
@@ -445,8 +445,8 @@ public:
|
|||||||
@note
|
@note
|
||||||
Please note that @e wxID_ABOUT and @e wxID_EXIT are predefined by wxWidgets
|
Please note that @e wxID_ABOUT and @e wxID_EXIT are predefined by wxWidgets
|
||||||
and have a special meaning since entries using these IDs will be taken out
|
and have a special meaning since entries using these IDs will be taken out
|
||||||
of the normal menus under OS X and will be inserted into the system menu
|
of the normal menus under macOS and will be inserted into the system menu
|
||||||
(following the appropriate OS X interface guideline).
|
(following the appropriate macOS interface guideline).
|
||||||
|
|
||||||
Menu items may be either @e normal items, @e check items or @e radio items.
|
Menu items may be either @e normal items, @e check items or @e radio items.
|
||||||
Normal items don't have any special properties while the check items have a
|
Normal items don't have any special properties while the check items have a
|
||||||
|
@@ -418,7 +418,7 @@ public:
|
|||||||
"ALT" and @c "SHIFT" strings (case doesn't matter) separated by either
|
"ALT" and @c "SHIFT" strings (case doesn't matter) separated by either
|
||||||
@c '-' or @c '+' characters and followed by the accelerator itself.
|
@c '-' or @c '+' characters and followed by the accelerator itself.
|
||||||
Notice that @c CTRL corresponds to the "Ctrl" key on most platforms but
|
Notice that @c CTRL corresponds to the "Ctrl" key on most platforms but
|
||||||
not under OS X where it is mapped to "Cmd" key on Mac keyboard.
|
not under macOS where it is mapped to "Cmd" key on Mac keyboard.
|
||||||
Usually this is exactly what you want in portable code but if you
|
Usually this is exactly what you want in portable code but if you
|
||||||
really need to use the (rarely used for this purpose) "Ctrl" key even
|
really need to use the (rarely used for this purpose) "Ctrl" key even
|
||||||
under Mac, you may use @c RAWCTRL to prevent this mapping. Under the
|
under Mac, you may use @c RAWCTRL to prevent this mapping. Under the
|
||||||
|
@@ -56,7 +56,7 @@ const char wxMessageBoxCaptionStr[] = "Message";
|
|||||||
Displays a warning icon in the dialog. This style should be used for
|
Displays a warning icon in the dialog. This style should be used for
|
||||||
informative warnings or, in combination with @c wxYES_NO or @c wxCANCEL,
|
informative warnings or, in combination with @c wxYES_NO or @c wxCANCEL,
|
||||||
for questions that have potentially serious consequences (caution
|
for questions that have potentially serious consequences (caution
|
||||||
icon is used on OS X in this case).
|
icon is used on macOS in this case).
|
||||||
@style{wxICON_QUESTION}
|
@style{wxICON_QUESTION}
|
||||||
Displays a question mark symbol. This icon is automatically used
|
Displays a question mark symbol. This icon is automatically used
|
||||||
with @c wxYES_NO so it's usually unnecessary to specify it explicitly.
|
with @c wxYES_NO so it's usually unnecessary to specify it explicitly.
|
||||||
|
@@ -10,7 +10,7 @@
|
|||||||
|
|
||||||
This class allows showing 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, macOS, 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
|
||||||
but @c wxGenericNotificationMessage can be used instead of the native ones.
|
but @c wxGenericNotificationMessage can be used instead of the native ones.
|
||||||
This might make sense if your application requires features not available in
|
This might make sense if your application requires features not available in
|
||||||
@@ -30,8 +30,8 @@
|
|||||||
recommended to call MSWUseToasts() before showing the first notification
|
recommended to call MSWUseToasts() before showing the first notification
|
||||||
message.
|
message.
|
||||||
|
|
||||||
@par OS X
|
@par macOS
|
||||||
The OS X implementation uses Notification Center to display native notifications.
|
The macOS implementation uses Notification Center to display native notifications.
|
||||||
In order to use actions your notifications must use the alert style. This can
|
In order to use actions your notifications must use the alert style. This can
|
||||||
be enabled by the user in system settings or by setting the
|
be enabled by the user in system settings or by setting the
|
||||||
@c NSUserNotificationAlertStyle value in Info.plist to @c alert. Please note
|
@c NSUserNotificationAlertStyle value in Info.plist to @c alert. Please note
|
||||||
|
@@ -23,7 +23,7 @@ enum wxOperatingSystemId
|
|||||||
wxOS_UNKNOWN = 0, //!< returned on error
|
wxOS_UNKNOWN = 0, //!< returned on error
|
||||||
|
|
||||||
wxOS_MAC_OS = 1 << 0, //!< Apple Mac OS 8/9/X with Mac paths
|
wxOS_MAC_OS = 1 << 0, //!< Apple Mac OS 8/9/X with Mac paths
|
||||||
wxOS_MAC_OSX_DARWIN = 1 << 1, //!< Apple OS X with Unix paths
|
wxOS_MAC_OSX_DARWIN = 1 << 1, //!< Apple macOS with Unix paths
|
||||||
|
|
||||||
//! A combination of all @c wxOS_MAC_* values previously listed.
|
//! A combination of all @c wxOS_MAC_* values previously listed.
|
||||||
wxOS_MAC = wxOS_MAC_OS|wxOS_MAC_OSX_DARWIN,
|
wxOS_MAC = wxOS_MAC_OS|wxOS_MAC_OSX_DARWIN,
|
||||||
|
@@ -106,7 +106,7 @@ wxEventType wxEVT_POWER_RESUME;
|
|||||||
powering off the screen and Acquire() method can be used to do this.
|
powering off the screen and Acquire() method can be used to do this.
|
||||||
|
|
||||||
Notice that currently this functionality is only implemented for MSW and
|
Notice that currently this functionality is only implemented for MSW and
|
||||||
OS X.
|
macOS.
|
||||||
|
|
||||||
If possible, use wxPowerResourceBlocker class to ensure that Release() is
|
If possible, use wxPowerResourceBlocker class to ensure that Release() is
|
||||||
called instead of calling it manually.
|
called instead of calling it manually.
|
||||||
|
@@ -12,8 +12,8 @@
|
|||||||
|
|
||||||
This class encapsulates the differences -- both in appearance and
|
This class encapsulates the differences -- both in appearance and
|
||||||
behaviour -- between preferences dialogs on different platforms. In
|
behaviour -- between preferences dialogs on different platforms. In
|
||||||
particular, OS X preferences look very different from the typical notebook
|
particular, macOS preferences look very different from the typical notebook
|
||||||
control used on other platforms, and both OS X and GTK+ preferences windows
|
control used on other platforms, and both macOS and GTK+ preferences windows
|
||||||
are modeless unlike Windows options dialogs that are typically modal.
|
are modeless unlike Windows options dialogs that are typically modal.
|
||||||
|
|
||||||
wxPreferencesEditor is able to hide the differences by hiding the creation
|
wxPreferencesEditor is able to hide the differences by hiding the creation
|
||||||
@@ -90,7 +90,7 @@ public:
|
|||||||
Returns whether changes to values in preferences pages should be
|
Returns whether changes to values in preferences pages should be
|
||||||
applied immediately or only when the user clicks the OK button.
|
applied immediately or only when the user clicks the OK button.
|
||||||
|
|
||||||
Currently, changes are applied immediately on OS X and GTK+.
|
Currently, changes are applied immediately on macOS and GTK+.
|
||||||
|
|
||||||
The preprocessor macro `wxHAS_PREF_EDITOR_APPLY_IMMEDIATELY` is defined
|
The preprocessor macro `wxHAS_PREF_EDITOR_APPLY_IMMEDIATELY` is defined
|
||||||
in this case as well.
|
in this case as well.
|
||||||
@@ -149,10 +149,10 @@ public:
|
|||||||
/**
|
/**
|
||||||
Return 32x32 icon used for the page on some platforms.
|
Return 32x32 icon used for the page on some platforms.
|
||||||
|
|
||||||
Currently only used on OS X.
|
Currently only used on macOS.
|
||||||
|
|
||||||
@note This method is only pure virtual on platforms that require it
|
@note This method is only pure virtual on platforms that require it
|
||||||
(OS X). On other platforms, it has default implementation that
|
(macOS). On other platforms, it has default implementation that
|
||||||
returns an invalid bitmap. The preprocessor symbol
|
returns an invalid bitmap. The preprocessor symbol
|
||||||
`wxHAS_PREF_EDITOR_ICONS` is defined if this method must be
|
`wxHAS_PREF_EDITOR_ICONS` is defined if this method must be
|
||||||
implemented.
|
implemented.
|
||||||
@@ -182,7 +182,7 @@ public:
|
|||||||
Specialization of wxPreferencesPage useful for certain commonly used
|
Specialization of wxPreferencesPage useful for certain commonly used
|
||||||
preferences page.
|
preferences page.
|
||||||
|
|
||||||
On OS X, preferences pages named "General" and "Advanced" are commonly used
|
On macOS, preferences pages named "General" and "Advanced" are commonly used
|
||||||
in apps and the OS provides stock icons for them that should be used.
|
in apps and the OS provides stock icons for them that should be used.
|
||||||
Instead of reimplementing this behaviour yourself, you can inherit from
|
Instead of reimplementing this behaviour yourself, you can inherit from
|
||||||
wxStockPreferencesPage and get correct title and icon.
|
wxStockPreferencesPage and get correct title and icon.
|
||||||
@@ -214,6 +214,6 @@ public:
|
|||||||
|
|
||||||
/// Reimplemented to return suitable name for the page's kind.
|
/// Reimplemented to return suitable name for the page's kind.
|
||||||
virtual wxString GetName() const;
|
virtual wxString GetName() const;
|
||||||
/// Reimplemented to return stock icon on OS X.
|
/// Reimplemented to return stock icon on macOS.
|
||||||
virtual wxBitmap GetLargeIcon() const;
|
virtual wxBitmap GetLargeIcon() const;
|
||||||
};
|
};
|
||||||
|
@@ -290,7 +290,7 @@ public:
|
|||||||
created. In particular, printing code relying on wxDC::GetTextExtent()
|
created. In particular, printing code relying on wxDC::GetTextExtent()
|
||||||
heavily (for example, wxHtmlEasyPrinting and other wxHTML classes do) is
|
heavily (for example, wxHtmlEasyPrinting and other wxHTML classes do) is
|
||||||
affected. It is recommended to use native preview functionality on
|
affected. It is recommended to use native preview functionality on
|
||||||
platforms that offer it (OS X, GTK+).
|
platforms that offer it (macOS, GTK+).
|
||||||
|
|
||||||
@library{wxcore}
|
@library{wxcore}
|
||||||
@category{printing}
|
@category{printing}
|
||||||
@@ -805,7 +805,7 @@ public:
|
|||||||
page rectangle, or page margins rectangle to perform your own scaling.
|
page rectangle, or page margins rectangle to perform your own scaling.
|
||||||
|
|
||||||
@note
|
@note
|
||||||
While the underlying drawing model of OS X is floating-point,
|
While the underlying drawing model of macOS is floating-point,
|
||||||
wxWidgets's drawing model scales from integer coordinates.
|
wxWidgets's drawing model scales from integer coordinates.
|
||||||
*/
|
*/
|
||||||
void MapScreenSizeToDevice();
|
void MapScreenSizeToDevice();
|
||||||
|
@@ -49,7 +49,7 @@ enum wxPropertySheetDialogFlags
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Shrinks the dialog window to fit the currently selected page
|
Shrinks the dialog window to fit the currently selected page
|
||||||
(common behaviour for property sheets on OS X).
|
(common behaviour for property sheets on macOS).
|
||||||
*/
|
*/
|
||||||
wxPROPSHEET_SHRINKTOFIT = 0x0100,
|
wxPROPSHEET_SHRINKTOFIT = 0x0100,
|
||||||
};
|
};
|
||||||
|
@@ -14,7 +14,7 @@
|
|||||||
possible to extend this class (interface) to other types of
|
possible to extend this class (interface) to other types of
|
||||||
image content.
|
image content.
|
||||||
|
|
||||||
Implemented on Windows, GTK+ and OS X:
|
Implemented on Windows, GTK+ and macOS:
|
||||||
@li wxNativePixelData: Class to access to wxBitmap's internal data
|
@li wxNativePixelData: Class to access to wxBitmap's internal data
|
||||||
without alpha channel (RGB).
|
without alpha channel (RGB).
|
||||||
@li wxAlphaPixelData: Class to access to wxBitmap's internal data with
|
@li wxAlphaPixelData: Class to access to wxBitmap's internal data with
|
||||||
|
@@ -520,7 +520,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Draw a title bar button in the given state.
|
Draw a title bar button in the given state.
|
||||||
|
|
||||||
This function is currently only available under MSW and OS X (and only
|
This function is currently only available under MSW and macOS (and only
|
||||||
for wxTITLEBAR_BUTTON_CLOSE under the latter), its best replacement for
|
for wxTITLEBAR_BUTTON_CLOSE under the latter), its best replacement for
|
||||||
the other platforms is to use wxArtProvider to retrieve the bitmaps for
|
the other platforms is to use wxArtProvider to retrieve the bitmaps for
|
||||||
@c wxART_HELP and @c wxART_CLOSE (but not any other title bar buttons
|
@c wxART_HELP and @c wxART_CLOSE (but not any other title bar buttons
|
||||||
|
@@ -139,7 +139,7 @@ public:
|
|||||||
A collection of secrets, sometimes called a key chain.
|
A collection of secrets, sometimes called a key chain.
|
||||||
|
|
||||||
This class provides access to the secrets stored in the OS-provided
|
This class provides access to the secrets stored in the OS-provided
|
||||||
facility, e.g. credentials manager under MSW, keychain under OS X or
|
facility, e.g. credentials manager under MSW, keychain under macOS or
|
||||||
Freedesktop-compliant password storage mechanism such as GNOME keyring
|
Freedesktop-compliant password storage mechanism such as GNOME keyring
|
||||||
under Unix systems.
|
under Unix systems.
|
||||||
|
|
||||||
@@ -155,7 +155,7 @@ public:
|
|||||||
included in the string to allow storing passwords for more than one server.
|
included in the string to allow storing passwords for more than one server.
|
||||||
|
|
||||||
Notice that this class is always available under MSW (except when using
|
Notice that this class is always available under MSW (except when using
|
||||||
MinGW32 which doesn't provide the required @c wincred.h header) and OS X
|
MinGW32 which doesn't provide the required @c wincred.h header) and macOS
|
||||||
but requires libsecret (see https://developer.gnome.org/libsecret/) under
|
but requires libsecret (see https://developer.gnome.org/libsecret/) under
|
||||||
Unix and may not be compiled in if it wasn't found. You can check @c
|
Unix and may not be compiled in if it wasn't found. You can check @c
|
||||||
wxUSE_SECRETSTORE to test for this. Moreover, retrieving the default
|
wxUSE_SECRETSTORE to test for this. Moreover, retrieving the default
|
||||||
|
@@ -969,7 +969,7 @@ public:
|
|||||||
and ordering defined by the platform or toolkit's user interface guidelines
|
and ordering defined by the platform or toolkit's user interface guidelines
|
||||||
(if such things exist). By using this class, you can ensure that all your
|
(if such things exist). By using this class, you can ensure that all your
|
||||||
standard dialogs look correct on all major platforms. Currently it conforms to
|
standard dialogs look correct on all major platforms. Currently it conforms to
|
||||||
the Windows, GTK+ and OS X human interface guidelines.
|
the Windows, GTK+ and macOS human interface guidelines.
|
||||||
|
|
||||||
When there aren't interface guidelines defined for a particular platform or
|
When there aren't interface guidelines defined for a particular platform or
|
||||||
toolkit, wxStdDialogButtonSizer reverts to the Windows implementation.
|
toolkit, wxStdDialogButtonSizer reverts to the Windows implementation.
|
||||||
@@ -980,9 +980,9 @@ public:
|
|||||||
and then call Realize in order to create the actual button layout used.
|
and then call Realize in order to create the actual button layout used.
|
||||||
Other than these special operations, this sizer works like any other sizer.
|
Other than these special operations, this sizer works like any other sizer.
|
||||||
|
|
||||||
If you add a button with wxID_SAVE, on OS X the button will be renamed to
|
If you add a button with wxID_SAVE, on macOS the button will be renamed to
|
||||||
"Save" and the wxID_NO button will be renamed to "Don't Save" in accordance
|
"Save" and the wxID_NO button will be renamed to "Don't Save" in accordance
|
||||||
with the OS X Human Interface Guidelines.
|
with the macOS Human Interface Guidelines.
|
||||||
|
|
||||||
@library{wxcore}
|
@library{wxcore}
|
||||||
@category{winlayout}
|
@category{winlayout}
|
||||||
|
@@ -664,7 +664,7 @@ enum wxSocketEventFlags
|
|||||||
This option can have surprising platform dependent behaviour, so check the
|
This option can have surprising platform dependent behaviour, so check the
|
||||||
documentation for your platform's implementation of setsockopt().
|
documentation for your platform's implementation of setsockopt().
|
||||||
|
|
||||||
Note that on BSD-based systems(e.g. OS X), use of
|
Note that on BSD-based systems(e.g. macOS), use of
|
||||||
@b wxSOCKET_REUSEADDR implies @b SO_REUSEPORT in addition to
|
@b wxSOCKET_REUSEADDR implies @b SO_REUSEPORT in addition to
|
||||||
@b SO_REUSEADDR to be consistent with Windows.
|
@b SO_REUSEADDR to be consistent with Windows.
|
||||||
|
|
||||||
|
@@ -19,7 +19,7 @@
|
|||||||
methods.
|
methods.
|
||||||
|
|
||||||
In the description of the methods below, the example return values are given
|
In the description of the methods below, the example return values are given
|
||||||
for the Unix, Windows and OS X systems, however please note that these are
|
for the Unix, Windows and macOS systems, however please note that these are
|
||||||
just the examples and the actual values may differ. For example, under Windows:
|
just the examples and the actual values may differ. For example, under Windows:
|
||||||
the system administrator may change the standard directories locations, e.g.
|
the system administrator may change the standard directories locations, e.g.
|
||||||
the Windows directory may be named @c "W:\Win2003" instead of
|
the Windows directory may be named @c "W:\Win2003" instead of
|
||||||
@@ -310,7 +310,7 @@ public:
|
|||||||
specified category for the given language.
|
specified category for the given language.
|
||||||
|
|
||||||
In general this is just the same as @a lang subdirectory of GetResourcesDir()
|
In general this is just the same as @a lang subdirectory of GetResourcesDir()
|
||||||
(or @c lang.lproj under OS X) but is something quite different for
|
(or @c lang.lproj under macOS) but is something quite different for
|
||||||
message catalog category under Unix where it returns the standard
|
message catalog category under Unix where it returns the standard
|
||||||
@c prefix/share/locale/lang/LC_MESSAGES directory.
|
@c prefix/share/locale/lang/LC_MESSAGES directory.
|
||||||
|
|
||||||
@@ -337,7 +337,7 @@ public:
|
|||||||
The resources are the auxiliary data files needed for the application to run
|
The resources are the auxiliary data files needed for the application to run
|
||||||
and include, for example, image and sound files it might use.
|
and include, for example, image and sound files it might use.
|
||||||
|
|
||||||
This function is the same as GetDataDir() for all platforms except OS X.
|
This function is the same as GetDataDir() for all platforms except macOS.
|
||||||
Example return values:
|
Example return values:
|
||||||
- Unix: @c prefix/share/appinfo
|
- Unix: @c prefix/share/appinfo
|
||||||
- Windows: the directory where the executable file is located
|
- Windows: the directory where the executable file is located
|
||||||
|
@@ -681,7 +681,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Converts the strings contents to the wide character representation
|
Converts the strings contents to the wide character representation
|
||||||
and returns it as a temporary wxWCharBuffer object (Unix and OS X)
|
and returns it as a temporary wxWCharBuffer object (Unix and macOS)
|
||||||
or returns a pointer to the internal string contents in wide character
|
or returns a pointer to the internal string contents in wide character
|
||||||
mode (Windows).
|
mode (Windows).
|
||||||
|
|
||||||
|
@@ -111,7 +111,7 @@
|
|||||||
@flag{mac.textcontrol-use-spell-checker}
|
@flag{mac.textcontrol-use-spell-checker}
|
||||||
If 1 activates the spell checking in wxTextCtrl.
|
If 1 activates the spell checking in wxTextCtrl.
|
||||||
@flag{osx.openfiledialog.always-show-types}
|
@flag{osx.openfiledialog.always-show-types}
|
||||||
Per default a wxFileDialog with wxFD_OPEN does not show a types-popup on OS X but allows
|
Per default a wxFileDialog with wxFD_OPEN does not show a types-popup on macOS but allows
|
||||||
the selection of files from any of the supported types. Setting this to 1 shows a wxChoice
|
the selection of files from any of the supported types. Setting this to 1 shows a wxChoice
|
||||||
for selection (if there is more than one supported filetype).
|
for selection (if there is more than one supported filetype).
|
||||||
@endFlagTable
|
@endFlagTable
|
||||||
|
@@ -144,7 +144,7 @@ public:
|
|||||||
Returns true if system tray is available in the desktop environment the
|
Returns true if system tray is available in the desktop environment the
|
||||||
app runs under.
|
app runs under.
|
||||||
|
|
||||||
On Windows and OS X, the tray is always available and this function
|
On Windows and macOS, the tray is always available and this function
|
||||||
simply returns true.
|
simply returns true.
|
||||||
|
|
||||||
On Unix, X11 environment may or may not provide the tray, depending on
|
On Unix, X11 environment may or may not provide the tray, depending on
|
||||||
|
@@ -461,10 +461,10 @@ public:
|
|||||||
controls which are initially empty.
|
controls which are initially empty.
|
||||||
|
|
||||||
Notice that hints are known as <em>cue banners</em> under MSW or
|
Notice that hints are known as <em>cue banners</em> under MSW or
|
||||||
<em>placeholder strings</em> under OS X.
|
<em>placeholder strings</em> under macOS.
|
||||||
|
|
||||||
@remarks Currently implemented natively on Windows (Vista and later
|
@remarks Currently implemented natively on Windows (Vista and later
|
||||||
only), OS X and GTK+ (3.2 and later).
|
only), macOS and GTK+ (3.2 and later).
|
||||||
|
|
||||||
For the platforms without native hints support, the implementation
|
For the platforms without native hints support, the implementation
|
||||||
has several known limitations. Notably, the hint display will not
|
has several known limitations. Notably, the hint display will not
|
||||||
|
@@ -28,7 +28,7 @@ wxEventType wxEVT_TOOLBOOK_PAGE_CHANGING;
|
|||||||
|
|
||||||
@beginStyleTable
|
@beginStyleTable
|
||||||
@style{wxTBK_BUTTONBAR}
|
@style{wxTBK_BUTTONBAR}
|
||||||
Use wxButtonToolBar-based implementation under OS X (ignored under
|
Use wxButtonToolBar-based implementation under macOS (ignored under
|
||||||
other platforms).
|
other platforms).
|
||||||
@style{wxTBK_HORZ_LAYOUT}
|
@style{wxTBK_HORZ_LAYOUT}
|
||||||
Shows the text and the icons alongside, not vertically stacked (only
|
Shows the text and the icons alongside, not vertically stacked (only
|
||||||
|
@@ -594,7 +594,7 @@ public:
|
|||||||
virtual bool ShouldPreventAppExit() const;
|
virtual bool ShouldPreventAppExit() const;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This function sets the wxTopLevelWindow's modified state on OS X,
|
This function sets the wxTopLevelWindow's modified state on macOS,
|
||||||
which currently draws a black dot in the wxTopLevelWindow's close button.
|
which currently draws a black dot in the wxTopLevelWindow's close button.
|
||||||
On other platforms, this method does nothing.
|
On other platforms, this method does nothing.
|
||||||
|
|
||||||
@@ -603,7 +603,7 @@ public:
|
|||||||
virtual void OSXSetModified(bool modified);
|
virtual void OSXSetModified(bool modified);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns the current modified state of the wxTopLevelWindow on OS X.
|
Returns the current modified state of the wxTopLevelWindow on macOS.
|
||||||
On other platforms, this method does nothing.
|
On other platforms, this method does nothing.
|
||||||
|
|
||||||
@see OSXSetModified()
|
@see OSXSetModified()
|
||||||
@@ -613,7 +613,7 @@ public:
|
|||||||
/**
|
/**
|
||||||
Sets the file name represented by this wxTopLevelWindow.
|
Sets the file name represented by this wxTopLevelWindow.
|
||||||
|
|
||||||
Under OS X, this file name is used to set the "proxy icon", which
|
Under macOS, this file name is used to set the "proxy icon", which
|
||||||
appears in the window title bar near its title, corresponding to this
|
appears in the window title bar near its title, corresponding to this
|
||||||
file name. Under other platforms it currently doesn't do anything but
|
file name. Under other platforms it currently doesn't do anything but
|
||||||
it is harmless to call it now and it might be implemented to do
|
it is harmless to call it now and it might be implemented to do
|
||||||
@@ -633,7 +633,7 @@ public:
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
Enables the maximize button to toggle full screen mode. Prior to
|
Enables the maximize button to toggle full screen mode. Prior to
|
||||||
OS X 10.10 a full screen button is added to the right upper corner
|
macOS 10.10 a full screen button is added to the right upper corner
|
||||||
of a window's title bar.
|
of a window's title bar.
|
||||||
|
|
||||||
Currently only available for wxOSX/Cocoa.
|
Currently only available for wxOSX/Cocoa.
|
||||||
|
@@ -96,7 +96,7 @@ public:
|
|||||||
list the user configured in the OS. Notice that this may or may not
|
list the user configured in the OS. Notice that this may or may not
|
||||||
correspond to the default @em locale as obtained from
|
correspond to the default @em locale as obtained from
|
||||||
wxLocale::GetSystemLanguage(); modern operation systems (Windows
|
wxLocale::GetSystemLanguage(); modern operation systems (Windows
|
||||||
Vista+, OS X) have separate language and regional (= locale) settings.
|
Vista+, macOS) have separate language and regional (= locale) settings.
|
||||||
|
|
||||||
@param domain
|
@param domain
|
||||||
The catalog domain to look for.
|
The catalog domain to look for.
|
||||||
@@ -119,7 +119,7 @@ public:
|
|||||||
list the user configured in the OS. Notice that this may or may not
|
list the user configured in the OS. Notice that this may or may not
|
||||||
correspond to the default @em locale as obtained from
|
correspond to the default @em locale as obtained from
|
||||||
wxLocale::GetSystemLanguage(); modern operation systems (Windows
|
wxLocale::GetSystemLanguage(); modern operation systems (Windows
|
||||||
Vista+, OS X) have separate language and regional (= locale) settings.
|
Vista+, macOS) have separate language and regional (= locale) settings.
|
||||||
|
|
||||||
@param domain
|
@param domain
|
||||||
The catalog domain to look for.
|
The catalog domain to look for.
|
||||||
@@ -333,7 +333,7 @@ public:
|
|||||||
|
|
||||||
Catalogs are searched for in standard places (system locales directory,
|
Catalogs are searched for in standard places (system locales directory,
|
||||||
`LC_PATH` on Unix systems, Resources subdirectory of the application bundle
|
`LC_PATH` on Unix systems, Resources subdirectory of the application bundle
|
||||||
on OS X, executable's directory on Windows), but you may also prepend
|
on macOS, executable's directory on Windows), but you may also prepend
|
||||||
additional directories to the search path with
|
additional directories to the search path with
|
||||||
AddCatalogLookupPathPrefix().
|
AddCatalogLookupPathPrefix().
|
||||||
|
|
||||||
|
@@ -14,7 +14,7 @@
|
|||||||
wxTreeItemId handles, which may be tested for validity by calling
|
wxTreeItemId handles, which may be tested for validity by calling
|
||||||
wxTreeItemId::IsOk().
|
wxTreeItemId::IsOk().
|
||||||
|
|
||||||
A similar control with a fully native implementation for GTK+ and OS X
|
A similar control with a fully native implementation for GTK+ and macOS
|
||||||
as well is wxDataViewTreeCtrl.
|
as well is wxDataViewTreeCtrl.
|
||||||
|
|
||||||
To intercept events from a tree control, use the event table macros
|
To intercept events from a tree control, use the event table macros
|
||||||
|
@@ -109,7 +109,7 @@ public:
|
|||||||
Press a key.
|
Press a key.
|
||||||
|
|
||||||
If you are using modifiers then it needs to be paired with an identical
|
If you are using modifiers then it needs to be paired with an identical
|
||||||
KeyUp or the modifiers will not be released (MSW and OS X).
|
KeyUp or the modifiers will not be released (MSW and macOS).
|
||||||
|
|
||||||
@param keycode
|
@param keycode
|
||||||
Key to operate on, as an integer. It is interpreted as a wxKeyCode.
|
Key to operate on, as an integer. It is interpreted as a wxKeyCode.
|
||||||
|
@@ -922,9 +922,9 @@ wxString wxGetOsDescription();
|
|||||||
numbers (as returned by the 'uname -r' command); e.g. "4", "1", and "4" if
|
numbers (as returned by the 'uname -r' command); e.g. "4", "1", and "4" if
|
||||||
the machine is using kernel 4.1.4.
|
the machine is using kernel 4.1.4.
|
||||||
|
|
||||||
For OS X systems (@c wxOS_MAC) the major and minor version integers are the
|
For macOS systems (@c wxOS_MAC) the major and minor version integers are the
|
||||||
natural version numbers associated with the OS; e.g. "10", "11" and "2" if
|
natural version numbers associated with the OS; e.g. "10", "11" and "2" if
|
||||||
the machine is using OS X El Capitan 10.11.2.
|
the machine is using macOS El Capitan 10.11.2.
|
||||||
|
|
||||||
For Windows-like systems (@c wxOS_WINDOWS) the major and minor version integers will
|
For Windows-like systems (@c wxOS_WINDOWS) the major and minor version integers will
|
||||||
contain the following values:
|
contain the following values:
|
||||||
|
@@ -261,7 +261,7 @@ public:
|
|||||||
It is designed to allow the creation of multiple backends for each port,
|
It is designed to allow the creation of multiple backends for each port,
|
||||||
although currently just one is available. It differs from wxHtmlWindow in
|
although currently just one is available. It differs from wxHtmlWindow in
|
||||||
that each backend is actually a full rendering engine, Trident on MSW and
|
that each backend is actually a full rendering engine, Trident on MSW and
|
||||||
Webkit on OS X and GTK. This allows the correct viewing of complex pages with
|
Webkit on macOS and GTK. This allows the correct viewing of complex pages with
|
||||||
javascript and css.
|
javascript and css.
|
||||||
|
|
||||||
@section descriptions Backend Descriptions
|
@section descriptions Backend Descriptions
|
||||||
@@ -324,7 +324,7 @@ public:
|
|||||||
|
|
||||||
@par wxWEBVIEW_WEBKIT (OSX)
|
@par wxWEBVIEW_WEBKIT (OSX)
|
||||||
|
|
||||||
The OS X WebKit backend uses Apple's
|
The macOS WebKit backend uses Apple's
|
||||||
<a href="http://developer.apple.com/library/mac/#documentation/Cocoa/Reference/WebKit/Classes/WebView_Class/Reference/Reference.html#//apple_ref/doc/uid/20001903">WebView</a>
|
<a href="http://developer.apple.com/library/mac/#documentation/Cocoa/Reference/WebKit/Classes/WebView_Class/Reference/Reference.html#//apple_ref/doc/uid/20001903">WebView</a>
|
||||||
class. This backend has full support for custom schemes and virtual file
|
class. This backend has full support for custom schemes and virtual file
|
||||||
systems.
|
systems.
|
||||||
@@ -478,7 +478,7 @@ public:
|
|||||||
This method can be used to retrieve the pointer to the native rendering
|
This method can be used to retrieve the pointer to the native rendering
|
||||||
engine used by this control. The return value needs to be down-casted
|
engine used by this control. The return value needs to be down-casted
|
||||||
to the appropriate type depending on the platform: under Windows, it's
|
to the appropriate type depending on the platform: under Windows, it's
|
||||||
a pointer to IWebBrowser2 interface, under OS X it's a WebView pointer
|
a pointer to IWebBrowser2 interface, under macOS it's a WebView pointer
|
||||||
and under GTK it's a WebKitWebView.
|
and under GTK it's a WebKitWebView.
|
||||||
|
|
||||||
For example, you could set the WebKit options using this method:
|
For example, you could set the WebKit options using this method:
|
||||||
@@ -650,21 +650,21 @@ public:
|
|||||||
/**
|
/**
|
||||||
Returns @true if the current selection can be copied.
|
Returns @true if the current selection can be copied.
|
||||||
|
|
||||||
@note This always returns @c true on the OS X WebKit backend.
|
@note This always returns @c true on the macOS WebKit backend.
|
||||||
*/
|
*/
|
||||||
virtual bool CanCopy() const = 0;
|
virtual bool CanCopy() const = 0;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns @true if the current selection can be cut.
|
Returns @true if the current selection can be cut.
|
||||||
|
|
||||||
@note This always returns @c true on the OS X WebKit backend.
|
@note This always returns @c true on the macOS WebKit backend.
|
||||||
*/
|
*/
|
||||||
virtual bool CanCut() const = 0;
|
virtual bool CanCut() const = 0;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Returns @true if data can be pasted.
|
Returns @true if data can be pasted.
|
||||||
|
|
||||||
@note This always returns @c true on the OS X WebKit backend.
|
@note This always returns @c true on the macOS WebKit backend.
|
||||||
*/
|
*/
|
||||||
virtual bool CanPaste() const = 0;
|
virtual bool CanPaste() const = 0;
|
||||||
|
|
||||||
@@ -864,7 +864,7 @@ public:
|
|||||||
are changed, since this will require a new search. To reset the
|
are changed, since this will require a new search. To reset the
|
||||||
search, for example resetting the highlights call the function
|
search, for example resetting the highlights call the function
|
||||||
with an empty search phrase. This always returns @c wxNOT_FOUND
|
with an empty search phrase. This always returns @c wxNOT_FOUND
|
||||||
on the OS X WebKit backend.
|
on the macOS WebKit backend.
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
*/
|
*/
|
||||||
virtual long Find(const wxString& text, wxWebViewFindFlags flags = wxWEBVIEW_FIND_DEFAULT) = 0;
|
virtual long Find(const wxString& text, wxWebViewFindFlags flags = wxWEBVIEW_FIND_DEFAULT) = 0;
|
||||||
|
@@ -3237,9 +3237,9 @@ public:
|
|||||||
Chooses a different variant of the window display to use.
|
Chooses a different variant of the window display to use.
|
||||||
|
|
||||||
Window variants currently just differ in size, as can be seen from
|
Window variants currently just differ in size, as can be seen from
|
||||||
::wxWindowVariant documentation. Under all platforms but OS X, this
|
::wxWindowVariant documentation. Under all platforms but macOS, this
|
||||||
function does nothing more than change the font used by the window.
|
function does nothing more than change the font used by the window.
|
||||||
However under OS X it is implemented natively and selects the
|
However under macOS it is implemented natively and selects the
|
||||||
appropriate variant of the native widget, which has better appearance
|
appropriate variant of the native widget, which has better appearance
|
||||||
than just scaled down or up version of the normal variant, so it should
|
than just scaled down or up version of the normal variant, so it should
|
||||||
be preferred to directly tweaking the font size.
|
be preferred to directly tweaking the font size.
|
||||||
@@ -3799,7 +3799,7 @@ public:
|
|||||||
|
|
||||||
@remarks Use EVT_HOTKEY(hotkeyId, fnc) in the event table to capture the
|
@remarks Use EVT_HOTKEY(hotkeyId, fnc) in the event table to capture the
|
||||||
event. This function is currently only implemented under MSW
|
event. This function is currently only implemented under MSW
|
||||||
and OS X and always returns false in the other ports.
|
and macOS and always returns false in the other ports.
|
||||||
|
|
||||||
@see UnregisterHotKey()
|
@see UnregisterHotKey()
|
||||||
*/
|
*/
|
||||||
|
@@ -30,7 +30,7 @@
|
|||||||
|
|
||||||
This class is fully implemented only under the platforms where xlocale POSIX
|
This class is fully implemented only under the platforms where xlocale POSIX
|
||||||
API or equivalent is available. Currently the xlocale API is available under
|
API or equivalent is available. Currently the xlocale API is available under
|
||||||
most of the recent Unix systems (including Linux, various BSD and OS X) and
|
most of the recent Unix systems (including Linux, various BSD and macOS) and
|
||||||
Microsoft Visual C++ standard library provides a similar API starting from
|
Microsoft Visual C++ standard library provides a similar API starting from
|
||||||
version 8 (Visual Studio 2005).
|
version 8 (Visual Studio 2005).
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user