Finally removes occurences of OnMenuCommand and closes bug #1164678
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@36189 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -1,3 +1,14 @@
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Name: tdocview.tex
|
||||
%% Purpose: Document/view overview
|
||||
%% Author: wxWidgets Team
|
||||
%% Modified by:
|
||||
%% Created:
|
||||
%% RCS-ID: $Id$
|
||||
%% Copyright: (c) wxWidgets Team
|
||||
%% License: wxWindows license
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
|
||||
\section{Document/view overview}\label{docviewoverview}
|
||||
|
||||
Classes: \helpref{wxDocument}{wxdocument}, \helpref{wxView}{wxview}, \helpref{wxDocTemplate}{wxdoctemplate},\rtfsp
|
||||
@@ -125,8 +136,7 @@ See the example application in {\tt samples/docview}.
|
||||
|
||||
To use the abstract wxView class, you need to derive a new class and override
|
||||
at least the member functions OnCreate, OnDraw, OnUpdate and OnClose. You will probably
|
||||
want to override OnMenuCommand to respond to menu commands from the frame containing the
|
||||
view.
|
||||
want to respond to menu commands from the frame containing the view.
|
||||
|
||||
Use the macros DECLARE\_DYNAMIC\_CLASS and IMPLEMENT\_DYNAMIC\_CLASS in order
|
||||
to allow the framework to create view objects on demand. When you create
|
||||
@@ -170,7 +180,7 @@ a single document template is constructed, and dialogs will be appropriately
|
||||
simplified.
|
||||
|
||||
wxDocTemplate is part of the document/view framework supported by wxWidgets,
|
||||
and cooperates with the \helpref{wxView}{wxview}, \helpref{wxDocument}{wxdocument}
|
||||
and cooperates with the \helpref{wxView}{wxview}, \helpref{wxDocument}{wxdocument}
|
||||
and \helpref{wxDocManager}{wxdocmanager} classes.
|
||||
|
||||
See the example application in {\tt samples/docview}.
|
||||
@@ -194,7 +204,7 @@ The wxDocManager class is part of the document/view framework supported by wxWid
|
||||
and cooperates with the \helpref{wxView}{wxview}, \helpref{wxDocument}{wxdocument}\rtfsp
|
||||
and \helpref{wxDocTemplate}{wxdoctemplate} classes.
|
||||
|
||||
A wxDocManager instance coordinates documents, views and document templates. It keeps a list of document
|
||||
A wxDocManager instance coordinates documents, views and document templates. It keeps a list of document
|
||||
and template instances, and much functionality is routed through this object, such
|
||||
as providing selection and file dialogs. The application can use this class `as is' or
|
||||
derive a class and override some members to extend or change the functionality.
|
||||
@@ -260,11 +270,11 @@ associate a file menu with the file history. The menu will then be used for
|
||||
appending filenames that are added to the history. Please notice that currently
|
||||
if the history already contained filenames when UseMenu() is called (e.g. when
|
||||
initializing a second MDI child frame), the menu is not automatically
|
||||
initialized with the existing filenames in the history and so you need to call
|
||||
initialized with the existing filenames in the history and so you need to call
|
||||
\helpref{AddFilesToMenu()}{wxfilehistoryaddfilestomenu} after UseMenu()
|
||||
explicitly in order to initialize the menu with the existing list of MRU files.
|
||||
(otherwise an assertion failure is raised in debug builds).
|
||||
The filenames are appended using menu identifiers in the range
|
||||
The filenames are appended using menu identifiers in the range
|
||||
\texttt{wxID\_FILE1} to \texttt{wxID\_FILE9}.
|
||||
|
||||
In order to respond to a file load command from one of these identifiers,
|
||||
@@ -285,7 +295,7 @@ void wxDocParentFrame::OnExit(wxCommandEvent& WXUNUSED(event))
|
||||
void wxDocParentFrame::OnMRUFile(wxCommandEvent& event)
|
||||
{
|
||||
wxString f(m_docManager->GetHistoryFile(event.GetId() - wxID_FILE1));
|
||||
if (f != "")
|
||||
if (!f.empty())
|
||||
(void)m_docManager->CreateDocument(f, wxDOC_SILENT);
|
||||
}
|
||||
\end{verbatim}
|
||||
@@ -295,9 +305,7 @@ void wxDocParentFrame::OnMRUFile(wxCommandEvent& event)
|
||||
|
||||
To allow communication between the application's menus and the
|
||||
document/view framework, several command identifiers are predefined for you
|
||||
to use in menus. The framework recognizes them and processes them if you
|
||||
forward commands from wxFrame::OnMenuCommand (or perhaps from toolbars and
|
||||
other user interface constructs).
|
||||
to use in menus.
|
||||
|
||||
\begin{itemize}\itemsep=0pt
|
||||
\item wxID\_OPEN (5000)
|
||||
@@ -314,5 +322,3 @@ other user interface constructs).
|
||||
\item wxID\_PRINT\_SETUP (5011)
|
||||
\item wxID\_PREVIEW (5012)
|
||||
\end{itemize}
|
||||
|
||||
|
||||
|
@@ -1,8 +1,19 @@
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Name: view.tex
|
||||
%% Purpose: wxView documentation
|
||||
%% Author: wxWidgets Team
|
||||
%% Modified by:
|
||||
%% Created:
|
||||
%% RCS-ID: $Id$
|
||||
%% Copyright: (c) wxWidgets Team
|
||||
%% License: wxWindows license
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
|
||||
\section{\class{wxView}}\label{wxview}
|
||||
|
||||
The view class can be used to model the viewing and editing component of
|
||||
an application's file-based data. It is part of the document/view framework supported by wxWidgets,
|
||||
and cooperates with the \helpref{wxDocument}{wxdocument}, \helpref{wxDocTemplate}{wxdoctemplate}
|
||||
and cooperates with the \helpref{wxDocument}{wxdocument}, \helpref{wxDocTemplate}{wxdoctemplate}
|
||||
and \helpref{wxDocManager}{wxdocmanager} classes.
|
||||
|
||||
\wxheading{Derived from}
|
||||
@@ -60,11 +71,10 @@ Destructor. Removes itself from the document's list of views.
|
||||
|
||||
Call this from your view frame's OnActivate member to tell the framework which view is
|
||||
currently active. If your windowing system doesn't call OnActivate, you may need to
|
||||
call this function from OnMenuCommand or any place where you know the view must
|
||||
call this function from any place where you know the view must
|
||||
be active, and the framework will need to get the current view.
|
||||
|
||||
The prepackaged view frame wxDocChildFrame calls wxView::Activate from its OnActivate member
|
||||
and from its OnMenuCommand member.
|
||||
The prepackaged view frame wxDocChildFrame calls wxView::Activate from its OnActivate member.
|
||||
|
||||
This function calls wxView::OnActivateView.
|
||||
|
||||
@@ -199,5 +209,3 @@ between the ``Frame'' in the method name and the type of its parameter.
|
||||
\func{void}{SetViewName}{\param{const wxString\& }{name}}
|
||||
|
||||
Sets the view type name. Should only be called by the framework.
|
||||
|
||||
|
||||
|
@@ -138,7 +138,7 @@ Constructs a window, which can be a child of a frame, dialog or any other non-co
|
||||
|
||||
\docparam{parent}{Pointer to a parent window.}
|
||||
|
||||
\docparam{id}{Window identifier. If -1, will automatically create an identifier.}
|
||||
\docparam{id}{Window identifier. If wxID\_ANY, will automatically create an identifier.}
|
||||
|
||||
\docparam{pos}{Window position. wxDefaultPosition indicates that wxWidgets
|
||||
should generate a default position for the window. If using the wxWindow class directly, supply
|
||||
@@ -1031,7 +1031,7 @@ Returns the identifier of the window.
|
||||
\wxheading{Remarks}
|
||||
|
||||
Each window has an integer identifier. If the application has not provided one
|
||||
(or the default Id -1) an unique identifier with a negative value will be generated.
|
||||
(or the default wxID\_ANY) an unique identifier with a negative value will be generated.
|
||||
|
||||
\wxheading{See also}
|
||||
|
||||
@@ -1815,28 +1815,6 @@ and not navigate to the next control.
|
||||
%%
|
||||
%% \helpref{wxValidator}{wxvalidator}, \helpref{wxWindow::TransferDataToWindow}{wxwindowtransferdatatowindow}
|
||||
%%
|
||||
%% \membersection{wxWindow::OnMenuCommand}\label{wxwindowonmenucommand}
|
||||
%%
|
||||
%% \func{void}{OnMenuCommand}{\param{wxCommandEvent\& }{event}}
|
||||
%%
|
||||
%% Called when a menu command is received from a menu bar.
|
||||
%%
|
||||
%% \wxheading{Parameters}
|
||||
%%
|
||||
%% \docparam{event}{The menu command event. For more information, see \helpref{wxCommandEvent}{wxcommandevent}.}
|
||||
%%
|
||||
%% \wxheading{Remarks}
|
||||
%%
|
||||
%% A function with this name doesn't actually exist; you can choose any member function to receive
|
||||
%% menu command events, using the EVT\_COMMAND macro for individual commands or EVT\_COMMAND\_RANGE for
|
||||
%% a range of commands.
|
||||
%%
|
||||
%% \wxheading{See also}
|
||||
%%
|
||||
%% \helpref{wxCommandEvent}{wxcommandevent},\rtfsp
|
||||
%% \helpref{wxWindow::OnMenuHighlight}{wxwindowonmenuhighlight},\rtfsp
|
||||
%% \helpref{Event handling overview}{eventhandlingoverview}
|
||||
%%
|
||||
%% \membersection{wxWindow::OnMenuHighlight}\label{wxwindowonmenuhighlight}
|
||||
%%
|
||||
%% \func{void}{OnMenuHighlight}{\param{wxMenuEvent\& }{event}}
|
||||
@@ -1864,7 +1842,6 @@ and not navigate to the next control.
|
||||
%% \wxheading{See also}
|
||||
%%
|
||||
%% \helpref{wxMenuEvent}{wxmenuevent},\rtfsp
|
||||
%% \helpref{wxWindow::OnMenuCommand}{wxwindowonmenucommand},\rtfsp
|
||||
%% \helpref{Event handling overview}{eventhandlingoverview}
|
||||
%%
|
||||
%%
|
||||
|
Reference in New Issue
Block a user