X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a7af285d1ab87e908454bfabbbe063ab1756912b..c266eff98c5e44012647f54f38a1e29ecabd8759:/docs/latex/wx/app.tex diff --git a/docs/latex/wx/app.tex b/docs/latex/wx/app.tex index b9ac70ab28..4707e63d7f 100644 --- a/docs/latex/wx/app.tex +++ b/docs/latex/wx/app.tex @@ -129,6 +129,21 @@ had been already processed (for the former return value) or that it is not going to be processed at all (for the latter one). +\membersection{wxApp::GetAppDisplayName}\label{wxappgetappdisplayname} + +\constfunc{wxString}{GetAppDisplayName}{\void} + +Returns the user-readable application name. The difference between this string +and the one returned by \helpref{GetAppName}{wxappgetappname} is that this one +is meant to be shown to the user and so should be used for the window titles, +page headers and so on while the other one should be only used internally, e.g. +for the file names or configuration file keys. + +By default, returns the same string as \helpref{GetAppName}{wxappgetappname}. + +\newsince{3.0} + + \membersection{wxApp::GetAppName}\label{wxappgetappname} \constfunc{wxString}{GetAppName}{\void} @@ -140,6 +155,10 @@ Returns the application name. wxWidgets sets this to a reasonable default before calling \helpref{wxApp::OnInit}{wxapponinit}, but the application can reset it at will. +\wxheading{See also} + +\helpref{GetAppDisplayName}{wxappgetappdisplayname} + \membersection{wxApp::GetClassName}\label{wxappgetclassname} @@ -587,13 +606,25 @@ If true is returned, more OnIdle processing is requested by one or more window. \helpref{wxIdleEvent}{wxidleevent} +\membersection{wxApp::SetAppDisplayName}\label{wxappsetappdisplayname} + +\func{void}{SetAppDisplayName}{\param{const wxString\& }{name}} + +Set the application name to be used in the user-visible places such as window +titles. See \helpref{GetAppDisplayName}{wxappgetappdisplayname} for more about +the differences between the display name and name. + + \membersection{wxApp::SetAppName}\label{wxappsetappname} \func{void}{SetAppName}{\param{const wxString\& }{name}} -Sets the name of the application. The name may be used in dialogs -(for example by the document/view framework). A default name is set by -wxWidgets. +Sets the name of the application. This name should be used for file names, +configuration file entries and other internal strings. For the user-visible +strings, such as the window titles, the application display name set by +\helpref{SetAppDisplayName}{wxappsetappdisplayname} is used instead. + +By default the application name is set to the name of its executable file. \wxheading{See also}