X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/5f3cd8a22a6abe2a47985fd00d00f173ac5167fc..81108288e63c2558a3a5faf79182a46e1b42d9a6:/docs/latex/wx/config.tex diff --git a/docs/latex/wx/config.tex b/docs/latex/wx/config.tex index 2b9abf764b..a36d300cc0 100644 --- a/docs/latex/wx/config.tex +++ b/docs/latex/wx/config.tex @@ -2,9 +2,7 @@ wxConfigBase class defines the basic interface of all config classes. It can not be used by itself (it's an abstract base class) and you'll always use one -of its derivations: \helpref{wxIniConfig}{wxiniconfig}, -\helpref{wxFileConfig}{wxfileconfig}, \helpref{wxRegConfig}{wxregconfig} or -any other. +of its derivations: wxIniConfig, wxFileConfig, wxRegConfig or any other. However, usually you don't even need to know the precise nature of the class you're working with but you would just use the wxConfigBase methods. This @@ -23,6 +21,14 @@ features of this class. No base class +\wxheading{Include files} + + (to let wxWindows choose a wxConfig class for your platform)\\ + (base config class)\\ + (wxFileconfig class)\\ + (wxRegConfig class)\\ + (wxIniConfig class) + \wxheading{Example} Here is how you would typically use this class: @@ -118,7 +124,7 @@ sensible!): // create an entry in subgroup conf->Write("SubgroupEntry", 3); - + // '..' is understood conf->Write("../GroupEntry", 2); conf->SetPath(".."); @@ -152,7 +158,7 @@ doesn't save and restore the path): void bar(wxConfigBase *config) { config->Write("Test", 17); - + foo(config); // we're reading "/Foo/Data/Test" here! -1 will probably be returned... @@ -259,6 +265,17 @@ arbitrary path (either relative or absolute), not just the key name. \helpref{Write}{wxconfigbasewrite}\\ \helpref{Flush}{wxconfigbaseflush} +\membersection{Rename entries/groups} + +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 +entry/group with the original name doesn't exist, because the entry/group with +the new name already exists or because the function is not supported in this +wxConfig implementation. + +\helpref{RenameEntry}{wxconfigbaserenameentry}\\ +\helpref{RenameGroup}{wxconfigbaserenamegroup} + \membersection{Delete entries/groups} The functions in this section delete entries and/or groups of entries from the @@ -426,6 +443,10 @@ index}} Gets the first group. +\pythonnote{The wxPython version of this method returns a 3-tuple +consisting of the continue flag, the value string, and the index for +the next call.} + \membersection{wxConfigBase::GetFirstEntry}\label{wxconfigbasegetfirstentry} \constfunc{bool}{GetFirstEntry}{\param{wxString\& }{str}, \param{long\&}{ @@ -433,6 +454,10 @@ index}} Gets the first entry. +\pythonnote{The wxPython version of this method returns a 3-tuple +consisting of the continue flag, the value string, and the index for +the next call.} + \membersection{wxConfigBase::GetNextGroup}\label{wxconfigbasegetnextgroup} \constfunc{bool}{GetNextGroup}{\param{wxString\& }{str}, \param{long\&}{ @@ -440,6 +465,10 @@ index}} Gets the next group. +\pythonnote{The wxPython version of this method returns a 3-tuple +consisting of the continue flag, the value string, and the index for +the next call.} + \membersection{wxConfigBase::GetNextEntry}\label{wxconfigbasegetnextentry} \constfunc{bool}{GetNextEntry}{\param{wxString\& }{str}, \param{long\&}{ @@ -447,6 +476,10 @@ index}} Gets the next entry. +\pythonnote{The wxPython version of this method returns a 3-tuple +consisting of the continue flag, the value string, and the index for +the next call.} + \membersection{wxConfigBase::GetNumberOfEntries}\label{wxconfigbasegetnumberofentries} \constfunc{uint }{GetNumberOfEntries}{\param{bool }{bRecursive = FALSE}} @@ -547,7 +580,7 @@ Reads a double value, returning TRUE if the value was found. If the value was not found, {\it d} is not changed. \constfunc{bool}{Read}{\param{const wxString\& }{ key}, \param{double*}{ d}, -\param{double}{ defaultVal}} + \param{double}{ defaultVal}} Reads a double value, returning TRUE if the value was found. If the value was not found, {\it defaultVal} is used instead. @@ -563,6 +596,37 @@ not found, {\it b} is not changed. Reads a bool value, returning TRUE if the value was found. If the value was not found, {\it defaultVal} is used instead. +\pythonnote{In place of a single overloaded method name, wxPython +implements the following methods:\par +\indented{2cm}{\begin{twocollist} +\twocolitem{\bf{Read(key, default="")}}{Returns a string.} +\twocolitem{\bf{ReadInt(key, default=0)}}{Returns an int.} +\twocolitem{\bf{ReadFloat(key, default=0.0)}}{Returns a floating point number.} +\end{twocollist}} +} + +\membersection{wxConfigBase::RenameEntry}\label{wxconfigbaserenameentry} + +\func{bool}{RenameEntry}{\param{const wxString\& }{ oldName}, \param{const wxString\& }{ newName}} + +Renames an entry in the current group. The entries names (both the old and +the new one) shouldn't contain backslashes, i.e. only simple names and not +arbitrary paths are accepted by this function. + +Returns FALSE if the {\it oldName} doesn't exist or if {\it newName} already +exists. + +\membersection{wxConfigBase::RenameGroup}\label{wxconfigbaserenamegroup} + +\func{bool}{RenameGroup}{\param{const wxString\& }{ oldName}, \param{const wxString\& }{ newName}} + +Renames a subgroup of the current group. The subgroup names (both the old and +the new one) shouldn't contain backslashes, i.e. only simple names and not +arbitrary paths are accepted by this function. + +Returns FALSE if the {\it oldName} doesn't exist or if {\it newName} already +exists. + \membersection{wxConfigBase::Set}\label{wxconfigbaseset} \func{wxConfigBase *}{Set}{\param{wxConfigBase *}{pConfig}} @@ -620,4 +684,16 @@ value}} These functions write the specified value to the config file and return TRUE on success. +\pythonnote{In place of a single overloaded method name, wxPython +implements the following methods:\par +\indented{2cm}{\begin{twocollist} +\twocolitem{\bf{Write(key, value)}}{Writes a string.} +\twocolitem{\bf{WriteInt(key, value)}}{Writes an int.} +\twocolitem{\bf{WriteFloat(key, value)}}{Writes a floating point number.} +\end{twocollist}} +} + + + +