Change documentation references from OS X to macOS (#1927)
Since OS X 10.12 it has been named macOS so it makes sense to reference it in documentation as such, even when it sometimes refers to older versions which were called (Mac) OS X.
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.7 or later. The port can be
|
supports 32 or 64 bit Intel Macs running macOS 10.7 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 9), compilers (Borland C++
|
Other platforms (e.g. iOS - with a minimum requirement of iOS 9), 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.7 or later and fully supports 64 bit builds.
|
macOS 10.7 or later 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.7 or newer) using Cocoa (32/64 bits)
|
* macOS (10.7 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
|
||||||
|
@@ -756,7 +756,7 @@ public:
|
|||||||
@endcode
|
@endcode
|
||||||
but be warned that locale support in C++ standard library can be poor
|
but be warned that locale support in C++ standard library can be poor
|
||||||
or worse under some platforms, e.g. the above line results in an
|
or worse under some platforms, e.g. the above line results in an
|
||||||
immediate crash under OS X up to the version 10.8.2.
|
immediate crash under macOS up to the version 10.8.2.
|
||||||
|
|
||||||
@since 2.9.5
|
@since 2.9.5
|
||||||
*/
|
*/
|
||||||
@@ -772,7 +772,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.
|
||||||
@@ -1055,7 +1055,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 >= 10.7, but
|
This method is implemented efficiently on MSW and macOS >= 10.7, 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.
|
||||||
@@ -646,7 +646,7 @@ public:
|
|||||||
under another OS.
|
under another OS.
|
||||||
|
|
||||||
@note Having the button is also required to let ShowFullScreen()
|
@note Having the button is also required to let ShowFullScreen()
|
||||||
make use of the full screen API available since OS X 10.7: a full
|
make use of the full screen API available since macOS 10.7: a full
|
||||||
screen window gets its own space and entering and exiting the mode
|
screen window gets its own space and entering and exiting the mode
|
||||||
is animated.
|
is animated.
|
||||||
If the button is not present the old way of switching to full screen
|
If the button is not present the old way of switching to full screen
|
||||||
|
@@ -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