X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a121d7205216f5b4b144264096e07104b5ad3172..4c85ab7569677ff535c258c7f25ad428ba1ed406:/docs/latex/wx/config.tex diff --git a/docs/latex/wx/config.tex b/docs/latex/wx/config.tex index 19839abcc9..6b0a17449d 100644 --- a/docs/latex/wx/config.tex +++ b/docs/latex/wx/config.tex @@ -2,7 +2,7 @@ wxConfigBase class defines the basic interface of all config classes. It can not be used by itself (it is an abstract base class) and you will always use one -of its derivations: wxIniConfig, \helpref{wxFileConfig}{wxfileconfig}, +of its derivations: \helpref{wxFileConfig}{wxfileconfig}, wxRegConfig or any other. However, usually you don't even need to know the precise nature of the class @@ -12,7 +12,7 @@ the registry under Win32 or text-based config files under Unix (or even Windows 3.1 .INI files if you're really unlucky). To make writing the portable code even easier, wxWidgets provides a typedef wxConfig which is mapped onto the native wxConfigBase implementation on the given -platform: i.e. wxRegConfig under Win32 (optionally wxIniConfig) and +platform: i.e. wxRegConfig under Win32 and wxFileConfig otherwise. See \helpref{config overview}{wxconfigoverview} for the descriptions of all @@ -30,8 +30,7 @@ No base class (to let wxWidgets choose a wxConfig class for your platform)\\ (base config class)\\ (wxFileConfig class)\\ - (wxRegConfig class)\\ - (wxIniConfig class) + (wxRegConfig class) \wxheading{Example} @@ -108,13 +107,13 @@ of \helpref{wxFileDialog}{wxfiledialog} have ability to use wxConfig class. \helpref{DontCreateOnDemand}{wxconfigbasedontcreateondemand} -\membersection{Constructor and destructor} +\membersection{Constructor and destructor}\label{congigconstructordestructor} \helpref{wxConfigBase}{wxconfigbasector}\\ \helpref{\destruct{wxConfigBase}}{wxconfigbasedtor} -\membersection{Path management} +\membersection{Path management}\label{configpathmanagement} As explained in \helpref{config overview}{wxconfigoverview}, the config classes support a file system-like hierarchy of keys (files) and groups (directories). @@ -184,7 +183,7 @@ regardless of the platform (i.e. it is {\bf not} '$\backslash\backslash$' under \helpref{GetPath}{wxconfigbasegetpath} -\membersection{Enumeration} +\membersection{Enumeration}\label{configenumeration} The functions in this section allow to enumerate all entries and groups in the config file. All functions here return false when there are no more items. @@ -200,6 +199,7 @@ explicitly. Having said all this, enumerating the config entries/groups is very simple: \begin{verbatim} + wxConfigBase *config = ...; wxArrayString aNames; // enumeration variables @@ -239,7 +239,7 @@ actually enumerating them, but you will probably never need them. \helpref{GetNumberOfGroups}{wxconfigbasegetnumberofgroups} -\membersection{Tests of existence} +\membersection{Tests of existence}\label{configtestsofexistence} \helpref{HasGroup}{wxconfigbasehasgroup}\\ \helpref{HasEntry}{wxconfigbasehasentry}\\ @@ -247,14 +247,14 @@ actually enumerating them, but you will probably never need them. \helpref{GetEntryType}{wxconfigbasegetentrytype} -\membersection{Miscellaneous functions} +\membersection{Miscellaneous functions}\label{configmiscellaneous} \helpref{GetAppName}{wxconfigbasegetappname}\\ \helpref{GetVendorName}{wxconfigbasegetvendorname}\\ \helpref{SetUmask}{wxfileconfigsetumask} -\membersection{Key access} +\membersection{Key access}\label{configkeyaccess} These function are the core of wxConfigBase class: they allow you to read and write config file data. All {\it Read} function take a default value which @@ -281,7 +281,7 @@ arbitrary path (either relative or absolute), not just the key name. \helpref{Flush}{wxconfigbaseflush} -\membersection{Rename entries/groups} +\membersection{Rename entries/groups}\label{configrenaming} The functions in this section allow to rename entries or subgroups of the current group. They will return false on error. typically because either the @@ -293,7 +293,7 @@ wxConfig implementation. \helpref{RenameGroup}{wxconfigbaserenamegroup} -\membersection{Delete entries/groups} +\membersection{Delete entries/groups}\label{configdeleting} The functions in this section delete entries and/or groups of entries from the config file. {\it DeleteAll()} is especially useful if you want to erase all @@ -304,7 +304,7 @@ traces of your program presence: for example, when you uninstall it. \helpref{DeleteAll}{wxconfigbasedeleteall} -\membersection{Options} +\membersection{Options}\label{configoptions} Some aspects of wxConfigBase behaviour can be changed during run-time. The first of them is the expansion of environment variables in the string values @@ -395,7 +395,7 @@ your application's responsibility to ensure that there is no newline or other illegal characters in a value, before writing that value to the file.} \docparam{conv}{This parameter is only used by wxFileConfig when compiled -in Unicode mode. It specifies the encoding in what the configuration file +in Unicode mode. It specifies the encoding in which the configuration file is written.} @@ -804,3 +804,4 @@ implements the following methods:\par \twocolitem{{\bf WriteBool(key, value)}}{Writes a boolean} \end{twocollist} }} +