7c913512a4
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52383 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
121 lines
4.1 KiB
Objective-C
121 lines
4.1 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: apptrait.h
|
|
// Purpose: documentation for wxAppTraits class
|
|
// Author: wxWidgets team
|
|
// RCS-ID: $Id$
|
|
// Licence: wxWindows license
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxAppTraits
|
|
@wxheader{apptrait.h}
|
|
|
|
The @b wxAppTraits class defines various configurable aspects of a wxApp.
|
|
You can access it using wxApp::GetTraits function and you can
|
|
create your own wxAppTraits overriding the
|
|
wxApp::CreateTraits function.
|
|
|
|
By default, wxWidgets creates a @c wxConsoleAppTraits object for console
|
|
applications
|
|
(i.e. those applications linked against wxBase library only - see the
|
|
@ref overview_librarieslist "Libraries list" page) and a @c wxGUIAppTraits
|
|
object for GUI
|
|
applications.
|
|
|
|
@library{wxbase}
|
|
@category{FIXME}
|
|
|
|
@seealso
|
|
@ref overview_wxappoverview "wxApp overview", wxApp
|
|
*/
|
|
class wxAppTraits
|
|
{
|
|
public:
|
|
/**
|
|
Called by wxWidgets to create the default configuration object for the
|
|
application. The default version creates a registry-based
|
|
wxRegConfig class under MSW and
|
|
wxFileConfig under all other platforms. The
|
|
wxApp wxApp::GetAppName and
|
|
wxApp::GetVendorName methods are used to determine the
|
|
registry key or file name.
|
|
*/
|
|
virtual wxConfigBase * CreateConfig();
|
|
|
|
/**
|
|
Creates the global font mapper object used for encodings/charset mapping.
|
|
*/
|
|
virtual wxFontMapper * CreateFontMapper();
|
|
|
|
/**
|
|
Creates the default log target for the application.
|
|
*/
|
|
virtual wxLog * CreateLogTarget();
|
|
|
|
/**
|
|
Creates the global object used for printing out messages.
|
|
*/
|
|
virtual wxMessageOutput * CreateMessageOutput();
|
|
|
|
/**
|
|
Returns the renderer to use for drawing the generic controls (return value may
|
|
be @NULL
|
|
in which case the default renderer for the current platform is used);
|
|
this is used in GUI mode only and always returns @NULL in console.
|
|
|
|
NOTE: returned pointer will be deleted by the caller.
|
|
*/
|
|
virtual wxRendererNative * CreateRenderer();
|
|
|
|
/**
|
|
This method returns the name of the desktop environment currently
|
|
running in a Unix desktop. Currently only "KDE" or "GNOME" are
|
|
supported and the code uses the X11 session protocol vendor name
|
|
to figure out, which desktop environment is running. The method
|
|
returns an empty string otherwise and on all other platforms.
|
|
*/
|
|
virtual wxString GetDesktopEnvironment();
|
|
|
|
/**
|
|
Returns the wxStandardPaths object for the application.
|
|
It's normally the same for wxBase and wxGUI except in the case of wxMac and
|
|
wxCocoa.
|
|
*/
|
|
virtual wxStandardPaths GetStandardPaths();
|
|
|
|
/**
|
|
Returns the wxWidgets port ID used by the running program and eventually
|
|
fills the given pointers with the values of the major and minor digits
|
|
of the native toolkit currently used.
|
|
The version numbers returned are thus detected at run-time and not compile-time
|
|
(except when this is not possible e.g. wxMotif).
|
|
|
|
E.g. if your program is using wxGTK port this function will return wxPORT_GTK
|
|
and
|
|
put in given pointers the versions of the GTK library in use.
|
|
|
|
See wxPlatformInfo for more details.
|
|
*/
|
|
virtual wxPortId GetToolkitVersion(int * major = @NULL,
|
|
int * minor = @NULL);
|
|
|
|
/**
|
|
Returns @true if @c fprintf(stderr) goes somewhere, @false otherwise.
|
|
*/
|
|
virtual bool HasStderr();
|
|
|
|
/**
|
|
Returns @true if the library was built as wxUniversal. Always returns
|
|
@false for wxBase-only apps.
|
|
*/
|
|
bool IsUsingUniversalWidgets();
|
|
|
|
/**
|
|
Shows the assert dialog with the specified message in GUI mode or just prints
|
|
the string to stderr in console mode.
|
|
|
|
Returns @true to suppress subsequent asserts, @false to continue as before.
|
|
*/
|
|
virtual bool ShowAssertDialog(const wxString & msg);
|
|
};
|