From ab48d8299099bf1979c1c797bf1cf17b086c46f2 Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Sat, 16 Nov 2013 13:28:45 +0000 Subject: [PATCH] Port OSXIsGUIApplication() documentation from trunk too. Now that it is implemented (see r75201), it should be documented as well. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_3_0_BRANCH@75203 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- interface/wx/app.h | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/interface/wx/app.h b/interface/wx/app.h index 246e9625c8..e7c10de408 100644 --- a/interface/wx/app.h +++ b/interface/wx/app.h @@ -880,6 +880,27 @@ public: */ virtual void MacReopenApp(); + /** + May be overridden to indicate that the application is not a foreground + GUI application under OS X. + + This method is called during the application startup and returns @true + by default. In this case, wxWidgets ensures that the application is ran + as a foreground, GUI application so that the user can interact with it + normally, even if it is not bundled. If this is undesired, i.e. if the + application doesn't need to be brought to the foreground, this method + can be overridden to return @false. + + Notice that overriding it doesn't make any difference for the bundled + applications which are always foreground unless @c LSBackgroundOnly key + is specified in the @c Info.plist file. + + @onlyfor{wxosx} + + @since 3.0.1 + */ + virtual bool OSXIsGUIApplication(); + //@} };