From afdf936cbcea4eb3370cd4a1b913c5b2e77e3c27 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Mon, 24 Jul 2006 18:20:18 +0000
Subject: [PATCH] documentation for wxAppTraits (patch 1518295 from Francesco)

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40288 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/app.tex       |  23 ++++++++
 docs/latex/wx/apptraits.tex | 109 ++++++++++++++++++++++++++++++++++++
 docs/latex/wx/classes.tex   |   1 +
 3 files changed, 133 insertions(+)
 create mode 100644 docs/latex/wx/apptraits.tex

diff --git a/docs/latex/wx/app.tex b/docs/latex/wx/app.tex
index b96f27b08d..76e50a1c1e 100644
--- a/docs/latex/wx/app.tex
+++ b/docs/latex/wx/app.tex
@@ -74,6 +74,18 @@ implementation returns a new wxLogGui class.
 \helpref{wxLog}{wxlog}
 
 
+\membersection{wxApp::CreateTraits}\label{wxappcreatetraits}
+
+\func{virtual wxAppTraits *}{CreateTraits}{\void}
+
+Creates the \helpref{wxAppTraits}{wxapptraits} object when \helpref{GetTraits}{wxappgettraits}
+needs it for the first time.
+
+\wxheading{See also}
+
+\helpref{wxAppTraits}{wxapptraits}
+
+
 \membersection{wxApp::Dispatch}\label{wxappdispatch}
 
 \func{virtual void}{Dispatch}{\void}
@@ -178,6 +190,17 @@ function will find the first top-level window (frame or dialog) and return that.
 \helpref{SetTopWindow}{wxappsettopwindow}
 
 
+
+\membersection{wxApp::GetTraits}\label{wxappgettraits}
+
+\func{wxAppTraits *}{GetTraits}{\void}
+
+Returns a pointer to the \helpref{wxAppTraits}{wxapptraits} object for the application.
+If you want to customize the \helpref{wxAppTraits}{wxapptraits} object, you must override the
+\helpref{CreateTraits}{wxappcreatetraits} function.
+
+
+
 \membersection{wxApp::GetUseBestVisual}\label{wxappgetusebestvisual}
 
 \constfunc{bool}{GetUseBestVisual}{\void}
diff --git a/docs/latex/wx/apptraits.tex b/docs/latex/wx/apptraits.tex
new file mode 100644
index 0000000000..f50a1c01d3
--- /dev/null
+++ b/docs/latex/wx/apptraits.tex
@@ -0,0 +1,109 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Name:        apptraits.tex
+%% Purpose:     wxAppTraits
+%% Author:      Francesco Montorsi
+%% Modified by:
+%% Created:     5-7-2006
+%% RCS-ID:      $Id$
+%% Copyright:   (c) wxWidgets Team
+%% License:     wxWindows license
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{\class{wxAppTraits}}\label{wxapptraits}
+
+The {\bf wxAppTraits} class defines various configurable aspects of a \helpref{wxApp}{wxapp}.
+You can access it using \helpref{wxApp::GetTraits}{wxappgettraits} function and you can
+create your own \helpref{wxAppTraits}{wxapptraits} overriding the
+\helpref{wxApp::CreateTraits}{wxappcreatetraits} function.
+
+By default, wxWidgets creates a {\tt wxConsoleAppTraits} object for console applications
+(i.e. those applications linked against wxBase library only - see the
+\helpref{Libraries list}{librarieslist} page) and a {\tt wxGUIAppTraits} object for GUI
+applications.
+
+\wxheading{Derived from}
+
+None
+
+\wxheading{Include files}
+
+<wx/apptrait.h>
+
+\wxheading{See also}
+
+\helpref{wxApp overview}{wxappoverview}, \helpref{wxApp}{wxapp}
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+
+\membersection{wxAppTraits::GetToolkitInfo}\label{wxapptraitsgettoolkitinfo}
+
+\func{virtual wxToolkitInfo \&}{GetToolkitInfo}{\void}
+
+Returns information about which toolkit is running. See \helpref{wxToolkitInfo}{wxtoolkitinfo}
+for more details.
+
+
+\membersection{wxAppTraits::HasStderr}\label{wxapptraitshasstderr}
+
+\func{virtual bool}{HasStderr}{\void}
+
+Returns \true if {\tt fprintf(stderr)} goes somewhere, \false otherwise.
+
+
+
+\membersection{wxAppTraits::ShowAssertDialog}\label{wxapptraitsshowassertdialog}
+
+\func{virtual bool}{ShowAssertDialog}{\param{const wxString \&}{ msg}}
+
+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.
+
+
+
+\membersection{wxAppTraits::GetStandardPaths}\label{wxapptraitsgetstandardpaths}
+
+\func{virtual wxStandardPaths \&}{GetStandardPaths}{\void}
+
+Returns the wxStandardPaths object for the application.
+It's normally the same for wxBase and wxGUI except in the case of wxMac and wxCocoa.
+
+
+
+\membersection{wxAppTraits::CreateRenderer}\label{wxapptraitscreaterenderer}
+
+\func{virtual wxRendererNative *}{CreateRenderer}{\void}
+
+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.
+
+
+
+\membersection{wxAppTraits::CreateLogTarget}\label{wxapptraitscreatelogtarget}
+
+\func{virtual wxLog *}{CreateLogTarget}{\void}
+
+Creates the default log target for the application.
+
+
+
+\membersection{wxAppTraits::CreateMessageOutput}\label{wxapptraitscreatemessageoutput}
+
+\func{virtual wxMessageOutput *}{CreateMessageOutput}{\void}
+
+Creates the global object used for printing out messages.
+
+
+
+\membersection{wxAppTraits::CreateFontMapper}\label{wxapptraitscreatefontmapper}
+
+\func{virtual wxFontMapper *}{CreateFontMapper}{\void}
+
+Creates the global font mapper object used for encodings/charset mapping.
+
+
diff --git a/docs/latex/wx/classes.tex b/docs/latex/wx/classes.tex
index 30138b1fb6..befff7981c 100644
--- a/docs/latex/wx/classes.tex
+++ b/docs/latex/wx/classes.tex
@@ -11,6 +11,7 @@
 \input activexcontainer.tex
 \input activexevt.tex
 \input app.tex
+\input apptraits.tex
 \input archive.tex
 \input array.tex
 \input arrstrng.tex
-- 
2.50.0

