Corrected some spacing and typo errors.

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

diff --git a/docs/latex/wx/filehist.tex b/docs/latex/wx/filehist.tex
index e136f1c6d8600cce3c8b453be27b89312082279a..9d47c7c36bc2e4edd92c5324ac06f603725e286f 100644 (file)
--- a/docs/latex/wx/filehist.tex
+++ b/docs/latex/wx/filehist.tex
@@ -3,13 +3,21 @@
 The wxFileHistory encapsulates a user interface convenience, the
 list of most recently visited files as shown on a menu (usually the File menu).
 
 The wxFileHistory encapsulates a user interface convenience, the
 list of most recently visited files as shown on a menu (usually the File menu).
 

+wxFileHistory can manage one or more file menus. More than one menu may be required
+in an MDI application, where the file history should appear on each MDI child menu
+as well as the MDI parent frame.
+

 \wxheading{Derived from}
 
 \helpref{wxObject}{wxobject}
 
 \wxheading{Derived from}
 
 \helpref{wxObject}{wxobject}
 

+\wxheading{Include files}
+
+<wx/docview.h>
+

 \wxheading{See also}
 
 \wxheading{See also}
 

-\overview{wxFileHistory overview}{wxfilehistoryoverview}
+\helpref{wxFileHistory overview}{wxfilehistoryoverview}, \helpref{wxDocManager}{wxdocmanager}

 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 


@@ -22,13 +30,13 @@ files.
 
 \membersection{wxFileHistory::m\_fileHistoryN}
 
 
 \membersection{wxFileHistory::m\_fileHistoryN}
 

-\member{int}{m\_fileHistoryN}
+\member{size\_t}{m\_fileHistoryN}

 
 The number of files stored in the history array.
 
 \membersection{wxFileHistory::m\_fileMaxFiles}
 
 
 The number of files stored in the history array.
 
 \membersection{wxFileHistory::m\_fileMaxFiles}
 

-\member{int}{m\_fileMaxFiles}
+\member{size\_t}{m\_fileMaxFiles}

 
 The maximum number of files to be stored and displayed on the menu.
 
 
 The maximum number of files to be stored and displayed on the menu.
 


@@ -40,9 +48,15 @@ The file menu used to display the file history list (if enabled).
 
 \membersection{wxFileHistory::wxFileHistory}
 
 
 \membersection{wxFileHistory::wxFileHistory}
 

-\func{}{wxFileHistory}{\param{int}{ maxFiles = 9}}
+\func{}{wxFileHistory}{\param{size\_t}{ maxFiles = 9}, \param{wxWindowID}{ idBase = wxID\_FILE1}}
+
+Constructor. Pass the maximum number of files that should be stored and
+displayed.

 
 

-Constructor. Pass the maximum number of files that should be stored and displayed.
+{\it idBase} defaults to wxID\_FILE1 and represents the id given to the first
+history menu item.  Since menu items can't share the same ID you should change
+idBase (To one of your own defined IDs) when using more than one wxFileHistory
+in your application.

 
 \membersection{wxFileHistory::\destruct{wxFileHistory}}
 
 
 \membersection{wxFileHistory::\destruct{wxFileHistory}}
 


@@ -56,38 +70,65 @@ Destructor.
 
 Adds a file to the file history list, if the object has a pointer to an appropriate file menu.
 
 
 Adds a file to the file history list, if the object has a pointer to an appropriate file menu.
 

-\membersection{wxFileHistory::FileHistoryLoad}
+\membersection{wxFileHistory::AddFilesToMenu}\label{wxfilehistoryaddfilestomenu}

 
 

-\func{void}{FileHistoryLoad}{\param{const wxString\& }{resourceFile}, \param{const wxString\& }{sectionName}}
+\func{void}{AddFilesToMenu}{\void}

 
 

-Loads the file history from a resource file, using the given section. This must be called
-explicitly by the application.
-
-\membersection{wxFileHistory::FileHistorySave}
+Appends the files in the history list, to all menus managed by the file history object.

 
 

-\func{void}{FileHistorySave}{\param{const wxString\& }{resourceFile}, \param{const wxString\& }{sectionName}}
+\func{void}{AddFilesToMenu}{\param{wxMenu*}{ menu}}

 
 

-Saves the file history into a resource file, using the given section. This must be called
-explicitly by the application.
+Appends the files in the history list, to the given menu only.

 
 

-\membersection{wxFileHistory::FileHistoryUseMenu}
+\membersection{wxFileHistory::GetHistoryFile}\label{wxfilehistorygethistoryfile}

 
 

-\func{void}{FileHistoryUseMenu}{\param{wxMenu* }{menu}}
+\constfunc{wxString}{GetHistoryFile}{\param{size\_t}{ index}}

 
 

-Use this menu for appending recently-visited document filenames, for convenient
-access. Calling this function with a valid menu pointer enables the history
-list functionality.
+Returns the file at this index (zero-based).

 
 \membersection{wxFileHistory::GetMaxFiles}
 
 
 \membersection{wxFileHistory::GetMaxFiles}
 

-\func{int}{GetMaxFiles}{\void}
+\constfunc{size\_t}{GetMaxFiles}{\void}

 
 Returns the maximum number of files that can be stored.
 
 \membersection{wxFileHistory::GetNoHistoryFiles}
 
 
 Returns the maximum number of files that can be stored.
 
 \membersection{wxFileHistory::GetNoHistoryFiles}
 

-\func{int}{GetNoHistoryFiles}{\void}
+\constfunc{size\_t}{GetNoHistoryFiles}{\void}

 
 Returns the number of files currently stored in the file history.
 
 
 Returns the number of files currently stored in the file history.
 

+\membersection{wxFileHistory::Load}
+
+\func{void}{Load}{\param{wxConfigBase\& }{config}}
+
+Loads the file history from the given config object. This function should be called explicitly by the application.
+
+\wxheading{See also}
+
+\helpref{wxConfig}{wxconfigbase}
+
+\membersection{wxFileHistory::RemoveMenu}
+
+\func{void}{RemoveMenu}{\param{wxMenu* }{menu}}
+
+Removes this menu from the list of those managed by this object.
+
+\membersection{wxFileHistory::Save}
+
+\func{void}{Save}{\param{wxConfigBase\& }{config}}
+
+Saves the file history into the given config object. This must be called
+explicitly by the application.
+
+\wxheading{See also}
+
+\helpref{wxConfig}{wxconfigbase}
+
+\membersection{wxFileHistory::UseMenu}
+
+\func{void}{UseMenu}{\param{wxMenu* }{menu}}
+
+Adds this menu to the list of those managed by this object.
+