many wxItemContainer-related changes:

[wxWidgets.git] / docs / latex / wx / dirpicker.tex

diff --git a/docs/latex/wx/dirpicker.tex b/docs/latex/wx/dirpicker.tex
index f9bd32ffea47f691caa4b1fd0905a442e62ca548..2eb69132eae9e34577a800393f73d35e25150b68 100644 (file)
--- a/docs/latex/wx/dirpicker.tex
+++ b/docs/latex/wx/dirpicker.tex
@@ -32,7 +32,8 @@ It is only available if \texttt{wxUSE\_DIRPICKERCTRL} is set to $1$ (the default
 
 \twocolwidtha{5cm}%
 \begin{twocollist}\itemsep=0pt
 
 \twocolwidtha{5cm}%
 \begin{twocollist}\itemsep=0pt

-\twocolitem{\windowstyle{wxDIRP\_DEFAULT\_STYLE}}{Default style.}
+\twocolitem{\windowstyle{wxDIRP\_DEFAULT\_STYLE}}{The default style: includes
+wxDIRP\_DIR\_MUST\_EXIST and, under wxMSW only, wxDIRP\_USE\_TEXTCTRL.}

 \twocolitem{\windowstyle{wxDIRP\_USE\_TEXTCTRL}}{Creates a text control to the left of the
 picker button which is completely managed by the \helpref{wxDirPickerCtrl}{wxdirpickerctrl}
 and which can be used by the user to specify a path (see \helpref{SetPath}{wxdirpickerctrlsetpath}).
 \twocolitem{\windowstyle{wxDIRP\_USE\_TEXTCTRL}}{Creates a text control to the left of the
 picker button which is completely managed by the \helpref{wxDirPickerCtrl}{wxdirpickerctrl}
 and which can be used by the user to specify a path (see \helpref{SetPath}{wxdirpickerctrlsetpath}).


@@ -45,9 +46,15 @@ The text control is automatically synchronized with button's value. Use function
 
 \wxheading{Event handling}
 
 
 \wxheading{Event handling}
 

+To process a directory picker event, use these event handler macros to direct input to member
+functions that take a \helpref{wxFileDirPickerEvent}{wxfiledirpickerevent} argument.
+

 \twocolwidtha{7cm}%
 \begin{twocollist}\itemsep=0pt
 \twocolwidtha{7cm}%
 \begin{twocollist}\itemsep=0pt

-\twocolitem{{\bf EVT\_DIRPICKER\_CHANGED(id, func)}}{The user changed the directory selected in the control either using the button or using text control (see wxDIRP_USE_TEXTCTRL; note that in this case the event is fired only if the user's input is valid, e.g. an existing directory path).}
+\twocolitem{{\bf EVT\_DIRPICKER\_CHANGED(id, func)}}{The user changed the
+directory selected in the control either using the button or using text control
+(see wxDIRP\_USE\_TEXTCTRL; note that in this case the event is fired only if
+the user's input is valid, e.g. an existing directory path).}

 \end{twocollist}
 
 \wxheading{See also}
 \end{twocollist}
 
 \wxheading{See also}


@@ -110,19 +117,36 @@ all the parameters.
 
 \true if the control was successfully created or \false if creation failed.
 
 
 \true if the control was successfully created or \false if creation failed.
 

+ 
+\membersection{wxFilePickerCtrl::GetDirName}\label{wxfilepickerctrlgetdirname}
+
+\constfunc{wxFileName}{GetDirName}{\void}
+
+Returns the absolute path of the currently selected directory as a \helpref{wxFileName}{wxfilename} object.
+This function is equivalent to \helpref{GetPath}{wxdirpickerctrlgetpath}
+

 
 \membersection{wxDirPickerCtrl::GetPath}\label{wxdirpickerctrlgetpath}
 
 \constfunc{wxString}{GetPath}{\void}
 
 
 \membersection{wxDirPickerCtrl::GetPath}\label{wxdirpickerctrlgetpath}
 
 \constfunc{wxString}{GetPath}{\void}
 

-Returns the currently selected directory.
+Returns the absolute path of the currently selected directory.
+
+
+\membersection{wxFilePickerCtrl::SetDirName}\label{wxfilepickerctrlsetdirname}
+
+\func{void}{SetDirName}{\param{const wxFileName \&}{dirname}}
+
+Just like \helpref{SetPath}{wxdirpickerctrlsetpath} but this function takes a
+\helpref{wxFileName}{wxfilename} object.

 
 
 \membersection{wxDirPickerCtrl::SetPath}\label{wxdirpickerctrlsetpath}
 
 \func{void}{SetPath}{\param{const wxString \&}{dirname}}
 
 
 
 \membersection{wxDirPickerCtrl::SetPath}\label{wxdirpickerctrlsetpath}
 
 \func{void}{SetPath}{\param{const wxString \&}{dirname}}
 

-Sets the currently selected directory. his must be a valid directory if
+Sets the absolute path of  (the default converter uses current locale's
+charset)the currently selected directory. This must be a valid directory if

 {\tt wxDIRP\_DIR\_MUST\_EXIST} style was given.
 
 
 {\tt wxDIRP\_DIR\_MUST\_EXIST} style was given.