use an enum to make it easier to document the values

[wxWidgets.git] / interface / apptrait.h

diff --git a/interface/apptrait.h b/interface/apptrait.h
index 4192b220416838ad98a703f64fe631ffbfe6de76..7da10c02b965e21095364a4cc2de40a6515063d0 100644 (file)
--- a/interface/apptrait.h
+++ b/interface/apptrait.h
@@ -10,14 +10,18 @@
     @class wxAppTraits
     @wxheader{apptrait.h}
 
     @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 page_libs page) and a @c wxGUIAppTraits object for GUI
+    The 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.
+
+    Note that wxAppTraits is an abstract class since it contains many
+    pure virtual functions.
+    In fact, by default, wxWidgets creates a @c wxConsoleAppTraits object for
+    console applications (i.e. those applications linked against wxBase library
+    only - see the @ref page_libs page) and a @c wxGUIAppTraits object for GUI

     applications.
     applications.

+    Both these classes are derived by wxAppTraits and represent concrete
+    implementation of the wxAppTraits interface.

 
     @library{wxbase}
     @category{appmanagement}
 
     @library{wxbase}
     @category{appmanagement}


@@ -40,7 +44,7 @@ public:
     /**
         Creates the global font mapper object used for encodings/charset mapping.
     */
     /**
         Creates the global font mapper object used for encodings/charset mapping.
     */

-    virtual wxFontMapper* CreateFontMapper();
+    virtual wxFontMapper* CreateFontMapper() = 0;

 
     /**
         Creates a wxLog class for the application to use for logging errors.
 
     /**
         Creates a wxLog class for the application to use for logging errors.


@@ -48,12 +52,12 @@ public:
 
         @see wxLog
     */
 
         @see wxLog
     */

-    virtual wxLog* CreateLogTarget();
+    virtual wxLog* CreateLogTarget() = 0;

 
     /**
         Creates the global object used for printing out messages.
     */
 
     /**
         Creates the global object used for printing out messages.
     */

-    virtual wxMessageOutput* CreateMessageOutput();
+    virtual wxMessageOutput* CreateMessageOutput() = 0;

 
     /**
         Returns the renderer to use for drawing the generic controls (return
 
     /**
         Returns the renderer to use for drawing the generic controls (return


@@ -63,7 +67,7 @@ public:
 
         @note the returned pointer needs to be deleted by the caller.
     */
 
         @note the returned pointer needs to be deleted by the caller.
     */

-    virtual wxRendererNative* CreateRenderer();
+    virtual wxRendererNative* CreateRenderer() = 0;

 
     /**
         This method returns the name of the desktop environment currently
 
     /**
         This method returns the name of the desktop environment currently


@@ -72,7 +76,7 @@ public:
         to figure out, which desktop environment is running. The method
         returns an empty string otherwise and on all other platforms.
     */
         to figure out, which desktop environment is running. The method
         returns an empty string otherwise and on all other platforms.
     */

-    virtual wxString GetDesktopEnvironment() const;
+    virtual wxString GetDesktopEnvironment() const = 0;

 
     /**
         Returns the wxStandardPaths object for the application.
 
     /**
         Returns the wxStandardPaths object for the application.


@@ -98,24 +102,24 @@ public:
         and put in given pointers the versions of the GTK library in use.
         See wxPlatformInfo for more details.
     */
         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) const;
+    virtual wxPortId GetToolkitVersion(int* major = NULL, int* minor = NULL) const = 0;

 
     /**
         Returns @true if @c fprintf(stderr) goes somewhere, @false otherwise.
     */
 
     /**
         Returns @true if @c fprintf(stderr) goes somewhere, @false otherwise.
     */

-    virtual bool HasStderr();
+    virtual bool HasStderr() = 0;

 
     /**
         Returns @true if the library was built as wxUniversal.
         Always returns @false for wxBase-only apps.
     */
 
     /**
         Returns @true if the library was built as wxUniversal.
         Always returns @false for wxBase-only apps.
     */

-    virtual bool IsUsingUniversalWidgets() const;
+    virtual bool IsUsingUniversalWidgets() const = 0;

 
     /**
         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.
     */
 
     /**
         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);
+    virtual bool ShowAssertDialog(const wxString& msg) = 0;

 };
 
 };