src/common/docview.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/common/docview.cpp
   3 // Purpose:     Document/view classes
   4 // Author:      Julian Smart
   5 // Modified by: Vadim Zeitlin
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24     #pragma hdrstop
  25 #endif
  26
  27 #if wxUSE_DOC_VIEW_ARCHITECTURE
  28
  29 #include "wx/docview.h"
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/list.h"
  33     #include "wx/string.h"
  34     #include "wx/utils.h"
  35     #include "wx/app.h"
  36     #include "wx/dc.h"
  37     #include "wx/dialog.h"
  38     #include "wx/menu.h"
  39     #include "wx/filedlg.h"
  40     #include "wx/intl.h"
  41     #include "wx/log.h"
  42     #include "wx/msgdlg.h"
  43     #include "wx/mdi.h"
  44     #include "wx/choicdlg.h"
  45 #endif
  46
  47 #if wxUSE_PRINTING_ARCHITECTURE
  48     #include "wx/prntbase.h"
  49     #include "wx/printdlg.h"
  50 #endif
  51
  52 #include "wx/confbase.h"
  53 #include "wx/filename.h"
  54 #include "wx/file.h"
  55 #include "wx/ffile.h"
  56 #include "wx/cmdproc.h"
  57 #include "wx/tokenzr.h"
  58 #include "wx/filename.h"
  59 #include "wx/stdpaths.h"
  60 #include "wx/vector.h"
  61 #include "wx/scopedarray.h"
  62 #include "wx/scopedptr.h"
  63 #include "wx/except.h"
  64
  65 #if wxUSE_STD_IOSTREAM
  66     #include "wx/ioswrap.h"
  67     #include "wx/beforestd.h"
  68     #if wxUSE_IOSTREAMH
  69         #include <fstream.h>
  70     #else
  71         #include <fstream>
  72     #endif
  73     #include "wx/afterstd.h"
  74 #else
  75     #include "wx/wfstream.h"
  76 #endif
  77
  78 typedef wxVector<wxDocTemplate *> wxDocTemplates;
  79
  80 // ----------------------------------------------------------------------------
  81 // wxWidgets macros
  82 // ----------------------------------------------------------------------------
  83
  84 IMPLEMENT_ABSTRACT_CLASS(wxDocument, wxEvtHandler)
  85 IMPLEMENT_ABSTRACT_CLASS(wxView, wxEvtHandler)
  86 IMPLEMENT_ABSTRACT_CLASS(wxDocTemplate, wxObject)
  87 IMPLEMENT_DYNAMIC_CLASS(wxDocManager, wxEvtHandler)
  88 IMPLEMENT_CLASS(wxDocChildFrame, wxFrame)
  89 IMPLEMENT_CLASS(wxDocParentFrame, wxFrame)
  90
  91 #if wxUSE_PRINTING_ARCHITECTURE
  92     IMPLEMENT_DYNAMIC_CLASS(wxDocPrintout, wxPrintout)
  93 #endif
  94
  95 IMPLEMENT_DYNAMIC_CLASS(wxFileHistory, wxObject)
  96
  97 // ============================================================================
  98 // implementation
  99 // ============================================================================
 100
 101 // ----------------------------------------------------------------------------
 102 // private helpers
 103 // ----------------------------------------------------------------------------
 104
 105 namespace
 106 {
 107
 108 wxString FindExtension(const wxString& path)
 109 {
 110     wxString ext;
 111     wxFileName::SplitPath(path, NULL, NULL, &ext);
 112
 113     // VZ: extensions are considered not case sensitive - is this really a good
 114     //     idea?
 115     return ext.MakeLower();
 116 }
 117
 118 // return the string used for the MRU list items in the menu
 119 //
 120 // NB: the index n is 0-based, as usual, but the strings start from 1
 121 wxString GetMRUEntryLabel(int n, const wxString& path)
 122 {
 123     // we need to quote '&' characters which are used for mnemonics
 124     wxString pathInMenu(path);
 125     pathInMenu.Replace("&", "&&");
 126
 127     return wxString::Format("&%d %s", n + 1, pathInMenu);
 128 }
 129
 130 } // anonymous namespace
 131
 132 // ----------------------------------------------------------------------------
 133 // Definition of wxDocument
 134 // ----------------------------------------------------------------------------
 135
 136 wxDocument::wxDocument(wxDocument *parent)
 137 {
 138     m_documentModified = false;
 139     m_documentParent = parent;
 140     m_documentTemplate = NULL;
 141     m_commandProcessor = NULL;
 142     m_savedYet = false;
 143 }
 144
 145 bool wxDocument::DeleteContents()
 146 {
 147     return true;
 148 }
 149
 150 wxDocument::~wxDocument()
 151 {
 152     DeleteContents();
 153
 154     delete m_commandProcessor;
 155
 156     if (GetDocumentManager())
 157         GetDocumentManager()->RemoveDocument(this);
 158
 159     // Not safe to do here, since it'll invoke virtual view functions
 160     // expecting to see valid derived objects: and by the time we get here,
 161     // we've called destructors higher up.
 162     //DeleteAllViews();
 163 }
 164
 165 bool wxDocument::Close()
 166 {
 167     if ( !OnSaveModified() )
 168         return false;
 169
 170     return OnCloseDocument();
 171 }
 172
 173 bool wxDocument::OnCloseDocument()
 174 {
 175     // Tell all views that we're about to close
 176     NotifyClosing();
 177     DeleteContents();
 178     Modify(false);
 179     return true;
 180 }
 181
 182 // Note that this implicitly deletes the document when the last view is
 183 // deleted.
 184 bool wxDocument::DeleteAllViews()
 185 {
 186     wxDocManager* manager = GetDocumentManager();
 187
 188     // first check if all views agree to be closed
 189     const wxList::iterator end = m_documentViews.end();
 190     for ( wxList::iterator i = m_documentViews.begin(); i != end; ++i )
 191     {
 192         wxView *view = (wxView *)*i;
 193         if ( !view->Close() )
 194             return false;
 195     }
 196
 197     // all views agreed to close, now do close them
 198     if ( m_documentViews.empty() )
 199     {
 200         // normally the document would be implicitly deleted when the last view
 201         // is, but if don't have any views, do it here instead
 202         if ( manager && manager->GetDocuments().Member(this) )
 203             delete this;
 204     }
 205     else // have views
 206     {
 207         // as we delete elements we iterate over, don't use the usual "from
 208         // begin to end" loop
 209         for ( ;; )
 210         {
 211             wxView *view = (wxView *)*m_documentViews.begin();
 212
 213             bool isLastOne = m_documentViews.size() == 1;
 214
 215             // this always deletes the node implicitly and if this is the last
 216             // view also deletes this object itself (also implicitly, great),
 217             // so we can't test for m_documentViews.empty() after calling this!
 218             delete view;
 219
 220             if ( isLastOne )
 221                 break;
 222         }
 223     }
 224
 225     return true;
 226 }
 227
 228 wxView *wxDocument::GetFirstView() const
 229 {
 230     if ( m_documentViews.empty() )
 231         return NULL;
 232
 233     return static_cast<wxView *>(m_documentViews.GetFirst()->GetData());
 234 }
 235
 236 void wxDocument::Modify(bool mod)
 237 {
 238     if (mod != m_documentModified)
 239     {
 240         m_documentModified = mod;
 241
 242         // Allow views to append asterix to the title
 243         wxView* view = GetFirstView();
 244         if (view) view->OnChangeFilename();
 245     }
 246 }
 247
 248 wxDocManager *wxDocument::GetDocumentManager() const
 249 {
 250     return m_documentTemplate ? m_documentTemplate->GetDocumentManager() : NULL;
 251 }
 252
 253 bool wxDocument::OnNewDocument()
 254 {
 255     // notice that there is no need to neither reset nor even check the
 256     // modified flag here as the document itself is a new object (this is only
 257     // called from CreateDocument()) and so it shouldn't be saved anyhow even
 258     // if it is modified -- this could happen if the user code creates
 259     // documents pre-filled with some user-entered (and which hence must not be
 260     // lost) information
 261
 262     SetDocumentSaved(false);
 263
 264     const wxString name = GetDocumentManager()->MakeNewDocumentName();
 265     SetTitle(name);
 266     SetFilename(name, true);
 267
 268     return true;
 269 }
 270
 271 bool wxDocument::Save()
 272 {
 273     if ( AlreadySaved() )
 274         return true;
 275
 276     if ( m_documentFile.empty() || !m_savedYet )
 277         return SaveAs();
 278
 279     return OnSaveDocument(m_documentFile);
 280 }
 281
 282 bool wxDocument::SaveAs()
 283 {
 284     wxDocTemplate *docTemplate = GetDocumentTemplate();
 285     if (!docTemplate)
 286         return false;
 287
 288 #ifdef wxHAS_MULTIPLE_FILEDLG_FILTERS
 289     wxString filter = docTemplate->GetDescription() + wxT(" (") +
 290         docTemplate->GetFileFilter() + wxT(")|") +
 291         docTemplate->GetFileFilter();
 292
 293     // Now see if there are some other template with identical view and document
 294     // classes, whose filters may also be used.
 295     if (docTemplate->GetViewClassInfo() && docTemplate->GetDocClassInfo())
 296     {
 297         wxList::compatibility_iterator
 298             node = docTemplate->GetDocumentManager()->GetTemplates().GetFirst();
 299         while (node)
 300         {
 301             wxDocTemplate *t = (wxDocTemplate*) node->GetData();
 302
 303             if (t->IsVisible() && t != docTemplate &&
 304                 t->GetViewClassInfo() == docTemplate->GetViewClassInfo() &&
 305                 t->GetDocClassInfo() == docTemplate->GetDocClassInfo())
 306             {
 307                 // add a '|' to separate this filter from the previous one
 308                 if ( !filter.empty() )
 309                     filter << wxT('|');
 310
 311                 filter << t->GetDescription()
 312                        << wxT(" (") << t->GetFileFilter() << wxT(") |")
 313                        << t->GetFileFilter();
 314             }
 315
 316             node = node->GetNext();
 317         }
 318     }
 319 #else
 320     wxString filter = docTemplate->GetFileFilter() ;
 321 #endif
 322
 323     wxString defaultDir = docTemplate->GetDirectory();
 324     if ( defaultDir.empty() )
 325     {
 326         defaultDir = wxPathOnly(GetFilename());
 327         if ( defaultDir.empty() )
 328             defaultDir = GetDocumentManager()->GetLastDirectory();
 329     }
 330
 331     wxString fileName = wxFileSelector(_("Save As"),
 332             defaultDir,
 333             wxFileNameFromPath(GetFilename()),
 334             docTemplate->GetDefaultExtension(),
 335             filter,
 336             wxFD_SAVE | wxFD_OVERWRITE_PROMPT,
 337             GetDocumentWindow());
 338
 339     if (fileName.empty())
 340         return false; // cancelled by user
 341
 342     wxString ext;
 343     wxFileName::SplitPath(fileName, NULL, NULL, &ext);
 344
 345     if (ext.empty())
 346     {
 347         fileName += wxT(".");
 348         fileName += docTemplate->GetDefaultExtension();
 349     }
 350
 351     // Files that were not saved correctly are not added to the FileHistory.
 352     if (!OnSaveDocument(fileName))
 353         return false;
 354
 355     SetTitle(wxFileNameFromPath(fileName));
 356     SetFilename(fileName, true);    // will call OnChangeFileName automatically
 357
 358    // A file that doesn't use the default extension of its document template
 359    // cannot be opened via the FileHistory, so we do not add it.
 360    if (docTemplate->FileMatchesTemplate(fileName))
 361    {
 362        GetDocumentManager()->AddFileToHistory(fileName);
 363    }
 364    //else: the user will probably not be able to open the file again, so we
 365    //      could warn about the wrong file-extension here
 366
 367    return true;
 368 }
 369
 370 bool wxDocument::OnSaveDocument(const wxString& file)
 371 {
 372     if ( !file )
 373         return false;
 374
 375     if ( !DoSaveDocument(file) )
 376         return false;
 377
 378     Modify(false);
 379     SetFilename(file);
 380     SetDocumentSaved(true);
 381 #if defined( __WXOSX_MAC__ ) && wxOSX_USE_CARBON
 382     wxFileName fn(file) ;
 383     fn.MacSetDefaultTypeAndCreator() ;
 384 #endif
 385     return true;
 386 }
 387
 388 bool wxDocument::OnOpenDocument(const wxString& file)
 389 {
 390     // notice that there is no need to check the modified flag here for the
 391     // reasons explained in OnNewDocument()
 392
 393     if ( !DoOpenDocument(file) )
 394         return false;
 395
 396     SetFilename(file, true);
 397
 398     // stretching the logic a little this does make sense because the document
 399     // had been saved into the file we just loaded it from, it just could have
 400     // happened during a previous program execution, it's just that the name of
 401     // this method is a bit unfortunate, it should probably have been called
 402     // HasAssociatedFileName()
 403     SetDocumentSaved(true);
 404
 405     UpdateAllViews();
 406
 407     return true;
 408 }
 409
 410 #if wxUSE_STD_IOSTREAM
 411 wxSTD istream& wxDocument::LoadObject(wxSTD istream& stream)
 412 #else
 413 wxInputStream& wxDocument::LoadObject(wxInputStream& stream)
 414 #endif
 415 {
 416     return stream;
 417 }
 418
 419 #if wxUSE_STD_IOSTREAM
 420 wxSTD ostream& wxDocument::SaveObject(wxSTD ostream& stream)
 421 #else
 422 wxOutputStream& wxDocument::SaveObject(wxOutputStream& stream)
 423 #endif
 424 {
 425     return stream;
 426 }
 427
 428 bool wxDocument::Revert()
 429 {
 430     return false;
 431 }
 432
 433
 434 // Get title, or filename if no title, else unnamed
 435 #if WXWIN_COMPATIBILITY_2_8
 436 bool wxDocument::GetPrintableName(wxString& buf) const
 437 {
 438     // this function can not only be overridden by the user code but also
 439     // called by it so we need to ensure that we return the same thing as
 440     // GetUserReadableName() but we can't call it because this would result in
 441     // an infinite recursion, hence we use the helper DoGetUserReadableName()
 442     buf = DoGetUserReadableName();
 443
 444     return true;
 445 }
 446 #endif // WXWIN_COMPATIBILITY_2_8
 447
 448 wxString wxDocument::GetUserReadableName() const
 449 {
 450 #if WXWIN_COMPATIBILITY_2_8
 451     // we need to call the old virtual function to ensure that the overridden
 452     // version of it is still called
 453     wxString name;
 454     if ( GetPrintableName(name) )
 455         return name;
 456 #endif // WXWIN_COMPATIBILITY_2_8
 457
 458     return DoGetUserReadableName();
 459 }
 460
 461 wxString wxDocument::DoGetUserReadableName() const
 462 {
 463     if ( !m_documentTitle.empty() )
 464         return m_documentTitle;
 465
 466     if ( !m_documentFile.empty() )
 467         return wxFileNameFromPath(m_documentFile);
 468
 469     return _("unnamed");
 470 }
 471
 472 wxWindow *wxDocument::GetDocumentWindow() const
 473 {
 474     wxView * const view = GetFirstView();
 475
 476     return view ? view->GetFrame() : wxTheApp->GetTopWindow();
 477 }
 478
 479 wxCommandProcessor *wxDocument::OnCreateCommandProcessor()
 480 {
 481     return new wxCommandProcessor;
 482 }
 483
 484 // true if safe to close
 485 bool wxDocument::OnSaveModified()
 486 {
 487     if ( IsModified() )
 488     {
 489         switch ( wxMessageBox
 490                  (
 491                     wxString::Format
 492                     (
 493                      _("Do you want to save changes to %s?"),
 494                      GetUserReadableName()
 495                     ),
 496                     wxTheApp->GetAppDisplayName(),
 497                     wxYES_NO | wxCANCEL | wxICON_QUESTION | wxCENTRE
 498                  ) )
 499         {
 500             case wxNO:
 501                 Modify(false);
 502                 break;
 503
 504             case wxYES:
 505                 return Save();
 506
 507             case wxCANCEL:
 508                 return false;
 509         }
 510     }
 511
 512     return true;
 513 }
 514
 515 bool wxDocument::Draw(wxDC& WXUNUSED(context))
 516 {
 517     return true;
 518 }
 519
 520 bool wxDocument::AddView(wxView *view)
 521 {
 522     if ( !m_documentViews.Member(view) )
 523     {
 524         m_documentViews.Append(view);
 525         OnChangedViewList();
 526     }
 527     return true;
 528 }
 529
 530 bool wxDocument::RemoveView(wxView *view)
 531 {
 532     (void)m_documentViews.DeleteObject(view);
 533     OnChangedViewList();
 534     return true;
 535 }
 536
 537 bool wxDocument::OnCreate(const wxString& WXUNUSED(path), long flags)
 538 {
 539     return GetDocumentTemplate()->CreateView(this, flags) != NULL;
 540 }
 541
 542 // Called after a view is added or removed.
 543 // The default implementation deletes the document if
 544 // there are no more views.
 545 void wxDocument::OnChangedViewList()
 546 {
 547     if ( m_documentViews.empty() && OnSaveModified() )
 548         delete this;
 549 }
 550
 551 void wxDocument::UpdateAllViews(wxView *sender, wxObject *hint)
 552 {
 553     wxList::compatibility_iterator node = m_documentViews.GetFirst();
 554     while (node)
 555     {
 556         wxView *view = (wxView *)node->GetData();
 557         if (view != sender)
 558             view->OnUpdate(sender, hint);
 559         node = node->GetNext();
 560     }
 561 }
 562
 563 void wxDocument::NotifyClosing()
 564 {
 565     wxList::compatibility_iterator node = m_documentViews.GetFirst();
 566     while (node)
 567     {
 568         wxView *view = (wxView *)node->GetData();
 569         view->OnClosingDocument();
 570         node = node->GetNext();
 571     }
 572 }
 573
 574 void wxDocument::SetFilename(const wxString& filename, bool notifyViews)
 575 {
 576     m_documentFile = filename;
 577     OnChangeFilename(notifyViews);
 578 }
 579
 580 void wxDocument::OnChangeFilename(bool notifyViews)
 581 {
 582     if ( notifyViews )
 583     {
 584         // Notify the views that the filename has changed
 585         wxList::compatibility_iterator node = m_documentViews.GetFirst();
 586         while (node)
 587         {
 588             wxView *view = (wxView *)node->GetData();
 589             view->OnChangeFilename();
 590             node = node->GetNext();
 591         }
 592     }
 593 }
 594
 595 bool wxDocument::DoSaveDocument(const wxString& file)
 596 {
 597 #if wxUSE_STD_IOSTREAM
 598     wxSTD ofstream store(file.mb_str(), wxSTD ios::binary);
 599     if ( !store )
 600 #else
 601     wxFileOutputStream store(file);
 602     if ( store.GetLastError() != wxSTREAM_NO_ERROR )
 603 #endif
 604     {
 605         wxLogError(_("File \"%s\" could not be opened for writing."), file);
 606         return false;
 607     }
 608
 609     if (!SaveObject(store))
 610     {
 611         wxLogError(_("Failed to save document to the file \"%s\"."), file);
 612         return false;
 613     }
 614
 615     return true;
 616 }
 617
 618 bool wxDocument::DoOpenDocument(const wxString& file)
 619 {
 620 #if wxUSE_STD_IOSTREAM
 621     wxSTD ifstream store(file.mb_str(), wxSTD ios::binary);
 622     if ( !store )
 623 #else
 624     wxFileInputStream store(file);
 625     if (store.GetLastError() != wxSTREAM_NO_ERROR || !store.IsOk())
 626 #endif
 627     {
 628         wxLogError(_("File \"%s\" could not be opened for reading."), file);
 629         return false;
 630     }
 631
 632 #if wxUSE_STD_IOSTREAM
 633     LoadObject(store);
 634     if ( !store )
 635 #else
 636     int res = LoadObject(store).GetLastError();
 637     if ( res != wxSTREAM_NO_ERROR && res != wxSTREAM_EOF )
 638 #endif
 639     {
 640         wxLogError(_("Failed to read document from the file \"%s\"."), file);
 641         return false;
 642     }
 643
 644     return true;
 645 }
 646
 647
 648 // ----------------------------------------------------------------------------
 649 // Document view
 650 // ----------------------------------------------------------------------------
 651
 652 wxView::wxView()
 653 {
 654     m_viewDocument = NULL;
 655
 656     m_viewFrame = NULL;
 657
 658     m_docChildFrame = NULL;
 659 }
 660
 661 wxView::~wxView()
 662 {
 663     GetDocumentManager()->ActivateView(this, false);
 664
 665     // reset our frame view first, before removing it from the document as
 666     // SetView(NULL) is a simple call while RemoveView() may result in user
 667     // code being executed and this user code can, for example, show a message
 668     // box which would result in an activation event for m_docChildFrame and so
 669     // could reactivate the view being destroyed -- unless we reset it first
 670     if ( m_docChildFrame && m_docChildFrame->GetView() == this )
 671     {
 672         // prevent it from doing anything with us
 673         m_docChildFrame->SetView(NULL);
 674
 675         // it doesn't make sense to leave the frame alive if its associated
 676         // view doesn't exist any more so unconditionally close it as well
 677         //
 678         // notice that we only get here if m_docChildFrame is non-NULL in the
 679         // first place and it will be always NULL if we're deleted because our
 680         // frame was closed, so this only catches the case of directly deleting
 681         // the view, as it happens if its creation fails in wxDocTemplate::
 682         // CreateView() for example
 683         m_docChildFrame->GetWindow()->Destroy();
 684     }
 685
 686     if ( m_viewDocument )
 687         m_viewDocument->RemoveView(this);
 688 }
 689
 690 void wxView::SetDocChildFrame(wxDocChildFrameAnyBase *docChildFrame)
 691 {
 692     SetFrame(docChildFrame ? docChildFrame->GetWindow() : NULL);
 693     m_docChildFrame = docChildFrame;
 694 }
 695
 696 bool wxView::TryBefore(wxEvent& event)
 697 {
 698     wxDocument * const doc = GetDocument();
 699     return doc && doc->ProcessEventHere(event);
 700 }
 701
 702 void wxView::OnActivateView(bool WXUNUSED(activate),
 703                             wxView *WXUNUSED(activeView),
 704                             wxView *WXUNUSED(deactiveView))
 705 {
 706 }
 707
 708 void wxView::OnPrint(wxDC *dc, wxObject *WXUNUSED(info))
 709 {
 710     OnDraw(dc);
 711 }
 712
 713 void wxView::OnUpdate(wxView *WXUNUSED(sender), wxObject *WXUNUSED(hint))
 714 {
 715 }
 716
 717 void wxView::OnChangeFilename()
 718 {
 719     // GetFrame can return wxWindow rather than wxTopLevelWindow due to
 720     // generic MDI implementation so use SetLabel rather than SetTitle.
 721     // It should cause SetTitle() for top level windows.
 722     wxWindow *win = GetFrame();
 723     if (!win) return;
 724
 725     wxDocument *doc = GetDocument();
 726     if (!doc) return;
 727
 728     wxString label = doc->GetUserReadableName();
 729     if (doc->IsModified())
 730     {
 731        label += "*";
 732     }
 733     win->SetLabel(label);
 734 }
 735
 736 void wxView::SetDocument(wxDocument *doc)
 737 {
 738     m_viewDocument = doc;
 739     if (doc)
 740         doc->AddView(this);
 741 }
 742
 743 bool wxView::Close(bool deleteWindow)
 744 {
 745     return OnClose(deleteWindow);
 746 }
 747
 748 void wxView::Activate(bool activate)
 749 {
 750     if (GetDocument() && GetDocumentManager())
 751     {
 752         OnActivateView(activate, this, GetDocumentManager()->GetCurrentView());
 753         GetDocumentManager()->ActivateView(this, activate);
 754     }
 755 }
 756
 757 bool wxView::OnClose(bool WXUNUSED(deleteWindow))
 758 {
 759     return GetDocument() ? GetDocument()->Close() : true;
 760 }
 761
 762 #if wxUSE_PRINTING_ARCHITECTURE
 763 wxPrintout *wxView::OnCreatePrintout()
 764 {
 765     return new wxDocPrintout(this);
 766 }
 767 #endif // wxUSE_PRINTING_ARCHITECTURE
 768
 769 // ----------------------------------------------------------------------------
 770 // wxDocTemplate
 771 // ----------------------------------------------------------------------------
 772
 773 wxDocTemplate::wxDocTemplate(wxDocManager *manager,
 774                              const wxString& descr,
 775                              const wxString& filter,
 776                              const wxString& dir,
 777                              const wxString& ext,
 778                              const wxString& docTypeName,
 779                              const wxString& viewTypeName,
 780                              wxClassInfo *docClassInfo,
 781                              wxClassInfo *viewClassInfo,
 782                              long flags)
 783 {
 784     m_documentManager = manager;
 785     m_description = descr;
 786     m_directory = dir;
 787     m_defaultExt = ext;
 788     m_fileFilter = filter;
 789     m_flags = flags;
 790     m_docTypeName = docTypeName;
 791     m_viewTypeName = viewTypeName;
 792     m_documentManager->AssociateTemplate(this);
 793
 794     m_docClassInfo = docClassInfo;
 795     m_viewClassInfo = viewClassInfo;
 796 }
 797
 798 wxDocTemplate::~wxDocTemplate()
 799 {
 800     m_documentManager->DisassociateTemplate(this);
 801 }
 802
 803 // Tries to dynamically construct an object of the right class.
 804 wxDocument *wxDocTemplate::CreateDocument(const wxString& path, long flags)
 805 {
 806     // InitDocument() is supposed to delete the document object if its
 807     // initialization fails so don't use wxScopedPtr<> here: this is fragile
 808     // but unavoidable because the default implementation uses CreateView()
 809     // which may -- or not -- create a wxView and if it does create it and its
 810     // initialization fails then the view destructor will delete the document
 811     // (via RemoveView()) and as we can't distinguish between the two cases we
 812     // just have to assume that it always deletes it in case of failure
 813     wxDocument * const doc = DoCreateDocument();
 814
 815     return doc && InitDocument(doc, path, flags) ? doc : NULL;
 816 }
 817
 818 bool
 819 wxDocTemplate::InitDocument(wxDocument* doc, const wxString& path, long flags)
 820 {
 821     doc->SetFilename(path);
 822     doc->SetDocumentTemplate(this);
 823     GetDocumentManager()->AddDocument(doc);
 824     doc->SetCommandProcessor(doc->OnCreateCommandProcessor());
 825
 826     if (doc->OnCreate(path, flags))
 827         return true;
 828
 829     if (GetDocumentManager()->GetDocuments().Member(doc))
 830         doc->DeleteAllViews();
 831     return false;
 832 }
 833
 834 wxView *wxDocTemplate::CreateView(wxDocument *doc, long flags)
 835 {
 836     wxScopedPtr<wxView> view(DoCreateView());
 837     if ( !view )
 838         return NULL;
 839
 840     view->SetDocument(doc);
 841     if ( !view->OnCreate(doc, flags) )
 842         return NULL;
 843
 844     return view.release();
 845 }
 846
 847 // The default (very primitive) format detection: check is the extension is
 848 // that of the template
 849 bool wxDocTemplate::FileMatchesTemplate(const wxString& path)
 850 {
 851     wxStringTokenizer parser (GetFileFilter(), wxT(";"));
 852     wxString anything = wxT ("*");
 853     while (parser.HasMoreTokens())
 854     {
 855         wxString filter = parser.GetNextToken();
 856         wxString filterExt = FindExtension (filter);
 857         if ( filter.IsSameAs (anything)    ||
 858              filterExt.IsSameAs (anything) ||
 859              filterExt.IsSameAs (FindExtension (path)) )
 860             return true;
 861     }
 862     return GetDefaultExtension().IsSameAs(FindExtension(path));
 863 }
 864
 865 wxDocument *wxDocTemplate::DoCreateDocument()
 866 {
 867     if (!m_docClassInfo)
 868         return NULL;
 869
 870     return static_cast<wxDocument *>(m_docClassInfo->CreateObject());
 871 }
 872
 873 wxView *wxDocTemplate::DoCreateView()
 874 {
 875     if (!m_viewClassInfo)
 876         return NULL;
 877
 878     return static_cast<wxView *>(m_viewClassInfo->CreateObject());
 879 }
 880
 881 // ----------------------------------------------------------------------------
 882 // wxDocManager
 883 // ----------------------------------------------------------------------------
 884
 885 BEGIN_EVENT_TABLE(wxDocManager, wxEvtHandler)
 886     EVT_MENU(wxID_OPEN, wxDocManager::OnFileOpen)
 887     EVT_MENU(wxID_CLOSE, wxDocManager::OnFileClose)
 888     EVT_MENU(wxID_CLOSE_ALL, wxDocManager::OnFileCloseAll)
 889     EVT_MENU(wxID_REVERT, wxDocManager::OnFileRevert)
 890     EVT_MENU(wxID_NEW, wxDocManager::OnFileNew)
 891     EVT_MENU(wxID_SAVE, wxDocManager::OnFileSave)
 892     EVT_MENU(wxID_SAVEAS, wxDocManager::OnFileSaveAs)
 893     EVT_MENU(wxID_UNDO, wxDocManager::OnUndo)
 894     EVT_MENU(wxID_REDO, wxDocManager::OnRedo)
 895
 896     EVT_UPDATE_UI(wxID_OPEN, wxDocManager::OnUpdateFileOpen)
 897     EVT_UPDATE_UI(wxID_CLOSE, wxDocManager::OnUpdateDisableIfNoDoc)
 898     EVT_UPDATE_UI(wxID_CLOSE_ALL, wxDocManager::OnUpdateDisableIfNoDoc)
 899     EVT_UPDATE_UI(wxID_REVERT, wxDocManager::OnUpdateDisableIfNoDoc)
 900     EVT_UPDATE_UI(wxID_NEW, wxDocManager::OnUpdateFileNew)
 901     EVT_UPDATE_UI(wxID_SAVE, wxDocManager::OnUpdateFileSave)
 902     EVT_UPDATE_UI(wxID_SAVEAS, wxDocManager::OnUpdateDisableIfNoDoc)
 903     EVT_UPDATE_UI(wxID_UNDO, wxDocManager::OnUpdateUndo)
 904     EVT_UPDATE_UI(wxID_REDO, wxDocManager::OnUpdateRedo)
 905
 906 #if wxUSE_PRINTING_ARCHITECTURE
 907     EVT_MENU(wxID_PRINT, wxDocManager::OnPrint)
 908     EVT_MENU(wxID_PREVIEW, wxDocManager::OnPreview)
 909
 910     EVT_UPDATE_UI(wxID_PRINT, wxDocManager::OnUpdateDisableIfNoDoc)
 911     EVT_UPDATE_UI(wxID_PREVIEW, wxDocManager::OnUpdateDisableIfNoDoc)
 912 #endif
 913 END_EVENT_TABLE()
 914
 915 wxDocManager* wxDocManager::sm_docManager = NULL;
 916
 917 wxDocManager::wxDocManager(long WXUNUSED(flags), bool initialize)
 918 {
 919     wxASSERT_MSG( !sm_docManager, "multiple wxDocManagers not allowed" );
 920
 921     sm_docManager = this;
 922
 923     m_defaultDocumentNameCounter = 1;
 924     m_currentView = NULL;
 925     m_maxDocsOpen = INT_MAX;
 926     m_fileHistory = NULL;
 927     if ( initialize )
 928         Initialize();
 929 }
 930
 931 wxDocManager::~wxDocManager()
 932 {
 933     Clear();
 934     delete m_fileHistory;
 935     sm_docManager = NULL;
 936 }
 937
 938 // closes the specified document
 939 bool wxDocManager::CloseDocument(wxDocument* doc, bool force)
 940 {
 941     if ( !doc->Close() && !force )
 942         return false;
 943
 944     // Implicitly deletes the document when
 945     // the last view is deleted
 946     doc->DeleteAllViews();
 947
 948     // Check we're really deleted
 949     if (m_docs.Member(doc))
 950         delete doc;
 951
 952     return true;
 953 }
 954
 955 bool wxDocManager::CloseDocuments(bool force)
 956 {
 957     wxList::compatibility_iterator node = m_docs.GetFirst();
 958     while (node)
 959     {
 960         wxDocument *doc = (wxDocument *)node->GetData();
 961         wxList::compatibility_iterator next = node->GetNext();
 962
 963         if (!CloseDocument(doc, force))
 964             return false;
 965
 966         // This assumes that documents are not connected in
 967         // any way, i.e. deleting one document does NOT
 968         // delete another.
 969         node = next;
 970     }
 971     return true;
 972 }
 973
 974 bool wxDocManager::Clear(bool force)
 975 {
 976     if (!CloseDocuments(force))
 977         return false;
 978
 979     m_currentView = NULL;
 980
 981     wxList::compatibility_iterator node = m_templates.GetFirst();
 982     while (node)
 983     {
 984         wxDocTemplate *templ = (wxDocTemplate*) node->GetData();
 985         wxList::compatibility_iterator next = node->GetNext();
 986         delete templ;
 987         node = next;
 988     }
 989     return true;
 990 }
 991
 992 bool wxDocManager::Initialize()
 993 {
 994     m_fileHistory = OnCreateFileHistory();
 995     return true;
 996 }
 997
 998 wxString wxDocManager::GetLastDirectory() const
 999 {
1000     // if we haven't determined the last used directory yet, do it now
1001     if ( m_lastDirectory.empty() )
1002     {
1003         // we're going to modify m_lastDirectory in this const method, so do it
1004         // via non-const self pointer instead of const this one
1005         wxDocManager * const self = const_cast<wxDocManager *>(this);
1006
1007         // first try to reuse the directory of the most recently opened file:
1008         // this ensures that if the user opens a file, closes the program and
1009         // runs it again the "Open file" dialog will open in the directory of
1010         // the last file he used
1011         if ( m_fileHistory && m_fileHistory->GetCount() )
1012         {
1013             const wxString lastOpened = m_fileHistory->GetHistoryFile(0);
1014             const wxFileName fn(lastOpened);
1015             if ( fn.DirExists() )
1016             {
1017                 self->m_lastDirectory = fn.GetPath();
1018             }
1019             //else: should we try the next one?
1020         }
1021         //else: no history yet
1022
1023         // if we don't have any files in the history (yet?), use the
1024         // system-dependent default location for the document files
1025         if ( m_lastDirectory.empty() )
1026         {
1027             self->m_lastDirectory = wxStandardPaths::Get().GetAppDocumentsDir();
1028         }
1029     }
1030
1031     return m_lastDirectory;
1032 }
1033
1034 wxFileHistory *wxDocManager::OnCreateFileHistory()
1035 {
1036     return new wxFileHistory;
1037 }
1038
1039 void wxDocManager::OnFileClose(wxCommandEvent& WXUNUSED(event))
1040 {
1041     wxDocument *doc = GetCurrentDocument();
1042     if (!doc)
1043         return;
1044     if (doc->Close())
1045     {
1046         doc->DeleteAllViews();
1047         if (m_docs.Member(doc))
1048             delete doc;
1049     }
1050 }
1051
1052 void wxDocManager::OnFileCloseAll(wxCommandEvent& WXUNUSED(event))
1053 {
1054     CloseDocuments(false);
1055 }
1056
1057 void wxDocManager::OnFileNew(wxCommandEvent& WXUNUSED(event))
1058 {
1059     CreateNewDocument();
1060 }
1061
1062 void wxDocManager::OnFileOpen(wxCommandEvent& WXUNUSED(event))
1063 {
1064     if ( !CreateDocument("") )
1065     {
1066         OnOpenFileFailure();
1067     }
1068 }
1069
1070 void wxDocManager::OnFileRevert(wxCommandEvent& WXUNUSED(event))
1071 {
1072     wxDocument *doc = GetCurrentDocument();
1073     if (!doc)
1074         return;
1075     doc->Revert();
1076 }
1077
1078 void wxDocManager::OnFileSave(wxCommandEvent& WXUNUSED(event))
1079 {
1080     wxDocument *doc = GetCurrentDocument();
1081     if (!doc)
1082         return;
1083     doc->Save();
1084 }
1085
1086 void wxDocManager::OnFileSaveAs(wxCommandEvent& WXUNUSED(event))
1087 {
1088     wxDocument *doc = GetCurrentDocument();
1089     if (!doc)
1090         return;
1091     doc->SaveAs();
1092 }
1093
1094 void wxDocManager::OnPrint(wxCommandEvent& WXUNUSED(event))
1095 {
1096 #if wxUSE_PRINTING_ARCHITECTURE
1097     wxView *view = GetActiveView();
1098     if (!view)
1099         return;
1100
1101     wxPrintout *printout = view->OnCreatePrintout();
1102     if (printout)
1103     {
1104         wxPrinter printer;
1105         printer.Print(view->GetFrame(), printout, true);
1106
1107         delete printout;
1108     }
1109 #endif // wxUSE_PRINTING_ARCHITECTURE
1110 }
1111
1112 void wxDocManager::OnPreview(wxCommandEvent& WXUNUSED(event))
1113 {
1114 #if wxUSE_PRINTING_ARCHITECTURE
1115     wxView *view = GetActiveView();
1116     if (!view)
1117         return;
1118
1119     wxPrintout *printout = view->OnCreatePrintout();
1120     if (printout)
1121     {
1122         // Pass two printout objects: for preview, and possible printing.
1123         wxPrintPreviewBase *
1124             preview = new wxPrintPreview(printout, view->OnCreatePrintout());
1125         if ( !preview->Ok() )
1126         {
1127             delete preview;
1128             wxLogError(_("Print preview creation failed."));
1129             return;
1130         }
1131
1132         wxPreviewFrame *
1133             frame = new wxPreviewFrame(preview, wxTheApp->GetTopWindow(),
1134                                        _("Print Preview"));
1135         frame->Centre(wxBOTH);
1136         frame->Initialize();
1137         frame->Show(true);
1138     }
1139 #endif // wxUSE_PRINTING_ARCHITECTURE
1140 }
1141
1142 void wxDocManager::OnUndo(wxCommandEvent& event)
1143 {
1144     wxCommandProcessor * const cmdproc = GetCurrentCommandProcessor();
1145     if ( !cmdproc )
1146     {
1147         event.Skip();
1148         return;
1149     }
1150
1151     cmdproc->Undo();
1152 }
1153
1154 void wxDocManager::OnRedo(wxCommandEvent& event)
1155 {
1156     wxCommandProcessor * const cmdproc = GetCurrentCommandProcessor();
1157     if ( !cmdproc )
1158     {
1159         event.Skip();
1160         return;
1161     }
1162
1163     cmdproc->Redo();
1164 }
1165
1166 // Handlers for UI update commands
1167
1168 void wxDocManager::OnUpdateFileOpen(wxUpdateUIEvent& event)
1169 {
1170     // CreateDocument() (which is called from OnFileOpen) may succeed
1171     // only when there is at least a template:
1172     event.Enable( GetTemplates().GetCount()>0 );
1173 }
1174
1175 void wxDocManager::OnUpdateDisableIfNoDoc(wxUpdateUIEvent& event)
1176 {
1177     event.Enable( GetCurrentDocument() != NULL );
1178 }
1179
1180 void wxDocManager::OnUpdateFileNew(wxUpdateUIEvent& event)
1181 {
1182     // CreateDocument() (which is called from OnFileNew) may succeed
1183     // only when there is at least a template:
1184     event.Enable( GetTemplates().GetCount()>0 );
1185 }
1186
1187 void wxDocManager::OnUpdateFileSave(wxUpdateUIEvent& event)
1188 {
1189     wxDocument * const doc = GetCurrentDocument();
1190     event.Enable( doc && !doc->AlreadySaved() );
1191 }
1192
1193 void wxDocManager::OnUpdateUndo(wxUpdateUIEvent& event)
1194 {
1195     wxCommandProcessor * const cmdproc = GetCurrentCommandProcessor();
1196     if ( !cmdproc )
1197     {
1198         event.Enable(false);
1199         return;
1200     }
1201
1202     event.Enable(cmdproc->CanUndo());
1203     cmdproc->SetMenuStrings();
1204 }
1205
1206 void wxDocManager::OnUpdateRedo(wxUpdateUIEvent& event)
1207 {
1208     wxCommandProcessor * const cmdproc = GetCurrentCommandProcessor();
1209     if ( !cmdproc )
1210     {
1211         event.Enable(false);
1212         return;
1213     }
1214
1215     event.Enable(cmdproc->CanRedo());
1216     cmdproc->SetMenuStrings();
1217 }
1218
1219 wxView *wxDocManager::GetActiveView() const
1220 {
1221     wxView *view = GetCurrentView();
1222
1223     if ( !view && !m_docs.empty() )
1224     {
1225         // if we have exactly one document, consider its view to be the current
1226         // one
1227         //
1228         // VZ: I'm not exactly sure why is this needed but this is how this
1229         //     code used to behave before the bug #9518 was fixed and it seems
1230         //     safer to preserve the old logic
1231         wxList::compatibility_iterator node = m_docs.GetFirst();
1232         if ( !node->GetNext() )
1233         {
1234             wxDocument *doc = static_cast<wxDocument *>(node->GetData());
1235             view = doc->GetFirstView();
1236         }
1237         //else: we have more than one document
1238     }
1239
1240     return view;
1241 }
1242
1243 bool wxDocManager::TryBefore(wxEvent& event)
1244 {
1245     wxView * const view = GetActiveView();
1246     return view && view->ProcessEventHere(event);
1247 }
1248
1249 namespace
1250 {
1251
1252 // helper function: return only the visible templates
1253 wxDocTemplates GetVisibleTemplates(const wxList& allTemplates)
1254 {
1255     // select only the visible templates
1256     const size_t totalNumTemplates = allTemplates.GetCount();
1257     wxDocTemplates templates;
1258     if ( totalNumTemplates )
1259     {
1260         templates.reserve(totalNumTemplates);
1261
1262         for ( wxList::const_iterator i = allTemplates.begin(),
1263                                    end = allTemplates.end();
1264               i != end;
1265               ++i )
1266         {
1267             wxDocTemplate * const temp = (wxDocTemplate *)*i;
1268             if ( temp->IsVisible() )
1269                 templates.push_back(temp);
1270         }
1271     }
1272
1273     return templates;
1274 }
1275
1276 } // anonymous namespace
1277
1278 wxDocument *wxDocManager::CreateDocument(const wxString& pathOrig, long flags)
1279 {
1280     // this ought to be const but SelectDocumentType/Path() are not
1281     // const-correct and can't be changed as, being virtual, this risks
1282     // breaking user code overriding them
1283     wxDocTemplates templates(GetVisibleTemplates(m_templates));
1284     const size_t numTemplates = templates.size();
1285     if ( !numTemplates )
1286     {
1287         // no templates can be used, can't create document
1288         return NULL;
1289     }
1290
1291
1292     // normally user should select the template to use but wxDOC_SILENT flag we
1293     // choose one ourselves
1294     wxString path = pathOrig;   // may be modified below
1295     wxDocTemplate *temp;
1296     if ( flags & wxDOC_SILENT )
1297     {
1298         wxASSERT_MSG( !path.empty(),
1299                       "using empty path with wxDOC_SILENT doesn't make sense" );
1300
1301         temp = FindTemplateForPath(path);
1302         if ( !temp )
1303         {
1304             wxLogWarning(_("The format of file '%s' couldn't be determined."),
1305                          path);
1306         }
1307     }
1308     else // not silent, ask the user
1309     {
1310         // for the new file we need just the template, for an existing one we
1311         // need the template and the path, unless it's already specified
1312         if ( (flags & wxDOC_NEW) || !path.empty() )
1313             temp = SelectDocumentType(&templates[0], numTemplates);
1314         else
1315             temp = SelectDocumentPath(&templates[0], numTemplates, path, flags);
1316     }
1317
1318     if ( !temp )
1319         return NULL;
1320
1321     // check whether the document with this path is already opened
1322     if ( !path.empty() )
1323     {
1324         const wxFileName fn(path);
1325         for ( wxList::const_iterator i = m_docs.begin(); i != m_docs.end(); ++i )
1326         {
1327             wxDocument * const doc = (wxDocument*)*i;
1328
1329             if ( fn == doc->GetFilename() )
1330             {
1331                 // file already open, just activate it and return
1332                 if ( doc->GetFirstView() )
1333                 {
1334                     ActivateView(doc->GetFirstView());
1335                     if ( doc->GetDocumentWindow() )
1336                         doc->GetDocumentWindow()->SetFocus();
1337                     return doc;
1338                 }
1339             }
1340         }
1341     }
1342
1343
1344     // no, we need to create a new document
1345
1346
1347     // if we've reached the max number of docs, close the first one.
1348     if ( (int)GetDocuments().GetCount() >= m_maxDocsOpen )
1349     {
1350         if ( !CloseDocument((wxDocument *)GetDocuments().GetFirst()->GetData()) )
1351         {
1352             // can't open the new document if closing the old one failed
1353             return NULL;
1354         }
1355     }
1356
1357
1358     // do create and initialize the new document finally
1359     wxDocument * const docNew = temp->CreateDocument(path, flags);
1360     if ( !docNew )
1361         return NULL;
1362
1363     docNew->SetDocumentName(temp->GetDocumentName());
1364     docNew->SetDocumentTemplate(temp);
1365
1366     wxTRY
1367     {
1368         // call the appropriate function depending on whether we're creating a
1369         // new file or opening an existing one
1370         if ( !(flags & wxDOC_NEW ? docNew->OnNewDocument()
1371                                  : docNew->OnOpenDocument(path)) )
1372         {
1373             docNew->DeleteAllViews();
1374             return NULL;
1375         }
1376     }
1377     wxCATCH_ALL( docNew->DeleteAllViews(); throw; )
1378
1379     // add the successfully opened file to MRU, but only if we're going to be
1380     // able to reopen it successfully later which requires the template for
1381     // this document to be retrievable from the file extension
1382     if ( !(flags & wxDOC_NEW) && temp->FileMatchesTemplate(path) )
1383         AddFileToHistory(path);
1384
1385     return docNew;
1386 }
1387
1388 wxView *wxDocManager::CreateView(wxDocument *doc, long flags)
1389 {
1390     wxDocTemplates templates(GetVisibleTemplates(m_templates));
1391     const size_t numTemplates = templates.size();
1392
1393     if ( numTemplates == 0 )
1394         return NULL;
1395
1396     wxDocTemplate * const
1397     temp = numTemplates == 1 ? templates[0]
1398                              : SelectViewType(&templates[0], numTemplates);
1399
1400     if ( !temp )
1401         return NULL;
1402
1403     wxView *view = temp->CreateView(doc, flags);
1404     if ( view )
1405         view->SetViewName(temp->GetViewName());
1406     return view;
1407 }
1408
1409 // Not yet implemented
1410 void
1411 wxDocManager::DeleteTemplate(wxDocTemplate *WXUNUSED(temp), long WXUNUSED(flags))
1412 {
1413 }
1414
1415 // Not yet implemented
1416 bool wxDocManager::FlushDoc(wxDocument *WXUNUSED(doc))
1417 {
1418     return false;
1419 }
1420
1421 wxDocument *wxDocManager::GetCurrentDocument() const
1422 {
1423     wxView * const view = GetActiveView();
1424     return view ? view->GetDocument() : NULL;
1425 }
1426
1427 wxCommandProcessor *wxDocManager::GetCurrentCommandProcessor() const
1428 {
1429     wxDocument * const doc = GetCurrentDocument();
1430     return doc ? doc->GetCommandProcessor() : NULL;
1431 }
1432
1433 // Make a default name for a new document
1434 #if WXWIN_COMPATIBILITY_2_8
1435 bool wxDocManager::MakeDefaultName(wxString& WXUNUSED(name))
1436 {
1437     // we consider that this function can only be overridden by the user code,
1438     // not called by it as it only makes sense to call it internally, so we
1439     // don't bother to return anything from here
1440     return false;
1441 }
1442 #endif // WXWIN_COMPATIBILITY_2_8
1443
1444 wxString wxDocManager::MakeNewDocumentName()
1445 {
1446     wxString name;
1447
1448 #if WXWIN_COMPATIBILITY_2_8
1449     if ( !MakeDefaultName(name) )
1450 #endif // WXWIN_COMPATIBILITY_2_8
1451     {
1452         name.Printf(_("unnamed%d"), m_defaultDocumentNameCounter);
1453         m_defaultDocumentNameCounter++;
1454     }
1455
1456     return name;
1457 }
1458
1459 // Make a frame title (override this to do something different)
1460 // If docName is empty, a document is not currently active.
1461 wxString wxDocManager::MakeFrameTitle(wxDocument* doc)
1462 {
1463     wxString appName = wxTheApp->GetAppDisplayName();
1464     wxString title;
1465     if (!doc)
1466         title = appName;
1467     else
1468     {
1469         wxString docName = doc->GetUserReadableName();
1470         title = docName + wxString(_(" - ")) + appName;
1471     }
1472     return title;
1473 }
1474
1475
1476 // Not yet implemented
1477 wxDocTemplate *wxDocManager::MatchTemplate(const wxString& WXUNUSED(path))
1478 {
1479     return NULL;
1480 }
1481
1482 // File history management
1483 void wxDocManager::AddFileToHistory(const wxString& file)
1484 {
1485     if (m_fileHistory)
1486         m_fileHistory->AddFileToHistory(file);
1487 }
1488
1489 void wxDocManager::RemoveFileFromHistory(size_t i)
1490 {
1491     if (m_fileHistory)
1492         m_fileHistory->RemoveFileFromHistory(i);
1493 }
1494
1495 wxString wxDocManager::GetHistoryFile(size_t i) const
1496 {
1497     wxString histFile;
1498
1499     if (m_fileHistory)
1500         histFile = m_fileHistory->GetHistoryFile(i);
1501
1502     return histFile;
1503 }
1504
1505 void wxDocManager::FileHistoryUseMenu(wxMenu *menu)
1506 {
1507     if (m_fileHistory)
1508         m_fileHistory->UseMenu(menu);
1509 }
1510
1511 void wxDocManager::FileHistoryRemoveMenu(wxMenu *menu)
1512 {
1513     if (m_fileHistory)
1514         m_fileHistory->RemoveMenu(menu);
1515 }
1516
1517 #if wxUSE_CONFIG
1518 void wxDocManager::FileHistoryLoad(const wxConfigBase& config)
1519 {
1520     if (m_fileHistory)
1521         m_fileHistory->Load(config);
1522 }
1523
1524 void wxDocManager::FileHistorySave(wxConfigBase& config)
1525 {
1526     if (m_fileHistory)
1527         m_fileHistory->Save(config);
1528 }
1529 #endif
1530
1531 void wxDocManager::FileHistoryAddFilesToMenu(wxMenu* menu)
1532 {
1533     if (m_fileHistory)
1534         m_fileHistory->AddFilesToMenu(menu);
1535 }
1536
1537 void wxDocManager::FileHistoryAddFilesToMenu()
1538 {
1539     if (m_fileHistory)
1540         m_fileHistory->AddFilesToMenu();
1541 }
1542
1543 size_t wxDocManager::GetHistoryFilesCount() const
1544 {
1545     return m_fileHistory ? m_fileHistory->GetCount() : 0;
1546 }
1547
1548
1549 // Find out the document template via matching in the document file format
1550 // against that of the template
1551 wxDocTemplate *wxDocManager::FindTemplateForPath(const wxString& path)
1552 {
1553     wxDocTemplate *theTemplate = NULL;
1554
1555     // Find the template which this extension corresponds to
1556     for (size_t i = 0; i < m_templates.GetCount(); i++)
1557     {
1558         wxDocTemplate *temp = (wxDocTemplate *)m_templates.Item(i)->GetData();
1559         if ( temp->FileMatchesTemplate(path) )
1560         {
1561             theTemplate = temp;
1562             break;
1563         }
1564     }
1565     return theTemplate;
1566 }
1567
1568 // Prompts user to open a file, using file specs in templates.
1569 // Must extend the file selector dialog or implement own; OR
1570 // match the extension to the template extension.
1571
1572 wxDocTemplate *wxDocManager::SelectDocumentPath(wxDocTemplate **templates,
1573                                                 int noTemplates,
1574                                                 wxString& path,
1575                                                 long WXUNUSED(flags),
1576                                                 bool WXUNUSED(save))
1577 {
1578 #ifdef wxHAS_MULTIPLE_FILEDLG_FILTERS
1579     wxString descrBuf;
1580
1581     for (int i = 0; i < noTemplates; i++)
1582     {
1583         if (templates[i]->IsVisible())
1584         {
1585             // add a '|' to separate this filter from the previous one
1586             if ( !descrBuf.empty() )
1587                 descrBuf << wxT('|');
1588
1589             descrBuf << templates[i]->GetDescription()
1590                 << wxT(" (") << templates[i]->GetFileFilter() << wxT(") |")
1591                 << templates[i]->GetFileFilter();
1592         }
1593     }
1594 #else
1595     wxString descrBuf = wxT("*.*");
1596     wxUnusedVar(noTemplates);
1597 #endif
1598
1599     int FilterIndex = -1;
1600
1601     wxString pathTmp = wxFileSelectorEx(_("Open File"),
1602                                         GetLastDirectory(),
1603                                         wxEmptyString,
1604                                         &FilterIndex,
1605                                         descrBuf);
1606
1607     wxDocTemplate *theTemplate = NULL;
1608     if (!pathTmp.empty())
1609     {
1610         if (!wxFileExists(pathTmp))
1611         {
1612             wxString msgTitle;
1613             if (!wxTheApp->GetAppDisplayName().empty())
1614                 msgTitle = wxTheApp->GetAppDisplayName();
1615             else
1616                 msgTitle = wxString(_("File error"));
1617
1618             wxMessageBox(_("Sorry, could not open this file."),
1619                          msgTitle,
1620                          wxOK | wxICON_EXCLAMATION | wxCENTRE);
1621
1622             path = wxEmptyString;
1623             return NULL;
1624         }
1625
1626         SetLastDirectory(wxPathOnly(pathTmp));
1627
1628         path = pathTmp;
1629
1630         // first choose the template using the extension, if this fails (i.e.
1631         // wxFileSelectorEx() didn't fill it), then use the path
1632         if ( FilterIndex != -1 )
1633             theTemplate = templates[FilterIndex];
1634         if ( !theTemplate )
1635             theTemplate = FindTemplateForPath(path);
1636         if ( !theTemplate )
1637         {
1638             // Since we do not add files with non-default extensions to the
1639             // file history this can only happen if the application changes the
1640             // allowed templates in runtime.
1641             wxMessageBox(_("Sorry, the format for this file is unknown."),
1642                          _("Open File"),
1643                          wxOK | wxICON_EXCLAMATION | wxCENTRE);
1644         }
1645     }
1646     else
1647     {
1648         path.clear();
1649     }
1650
1651     return theTemplate;
1652 }
1653
1654 wxDocTemplate *wxDocManager::SelectDocumentType(wxDocTemplate **templates,
1655                                                 int noTemplates, bool sort)
1656 {
1657     wxArrayString strings;
1658     wxScopedArray<wxDocTemplate *> data(new wxDocTemplate *[noTemplates]);
1659     int i;
1660     int n = 0;
1661
1662     for (i = 0; i < noTemplates; i++)
1663     {
1664         if (templates[i]->IsVisible())
1665         {
1666             int j;
1667             bool want = true;
1668             for (j = 0; j < n; j++)
1669             {
1670                 //filter out NOT unique documents + view combinations
1671                 if ( templates[i]->m_docTypeName == data[j]->m_docTypeName &&
1672                      templates[i]->m_viewTypeName == data[j]->m_viewTypeName
1673                    )
1674                     want = false;
1675             }
1676
1677             if ( want )
1678             {
1679                 strings.Add(templates[i]->m_description);
1680
1681                 data[n] = templates[i];
1682                 n ++;
1683             }
1684         }
1685     }  // for
1686
1687     if (sort)
1688     {
1689         strings.Sort(); // ascending sort
1690         // Yes, this will be slow, but template lists
1691         // are typically short.
1692         int j;
1693         n = strings.Count();
1694         for (i = 0; i < n; i++)
1695         {
1696             for (j = 0; j < noTemplates; j++)
1697             {
1698                 if (strings[i] == templates[j]->m_description)
1699                     data[i] = templates[j];
1700             }
1701         }
1702     }
1703
1704     wxDocTemplate *theTemplate;
1705
1706     switch ( n )
1707     {
1708         case 0:
1709             // no visible templates, hence nothing to choose from
1710             theTemplate = NULL;
1711             break;
1712
1713         case 1:
1714             // don't propose the user to choose if he has no choice
1715             theTemplate = data[0];
1716             break;
1717
1718         default:
1719             // propose the user to choose one of several
1720             theTemplate = (wxDocTemplate *)wxGetSingleChoiceData
1721                           (
1722                             _("Select a document template"),
1723                             _("Templates"),
1724                             strings,
1725                             (void **)data.get()
1726                           );
1727     }
1728
1729     return theTemplate;
1730 }
1731
1732 wxDocTemplate *wxDocManager::SelectViewType(wxDocTemplate **templates,
1733                                             int noTemplates, bool sort)
1734 {
1735     wxArrayString strings;
1736     wxScopedArray<wxDocTemplate *> data(new wxDocTemplate *[noTemplates]);
1737     int i;
1738     int n = 0;
1739
1740     for (i = 0; i < noTemplates; i++)
1741     {
1742         wxDocTemplate *templ = templates[i];
1743         if ( templ->IsVisible() && !templ->GetViewName().empty() )
1744         {
1745             int j;
1746             bool want = true;
1747             for (j = 0; j < n; j++)
1748             {
1749                 //filter out NOT unique views
1750                 if ( templates[i]->m_viewTypeName == data[j]->m_viewTypeName )
1751                     want = false;
1752             }
1753
1754             if ( want )
1755             {
1756                 strings.Add(templ->m_viewTypeName);
1757                 data[n] = templ;
1758                 n ++;
1759             }
1760         }
1761     }
1762
1763     if (sort)
1764     {
1765         strings.Sort(); // ascending sort
1766         // Yes, this will be slow, but template lists
1767         // are typically short.
1768         int j;
1769         n = strings.Count();
1770         for (i = 0; i < n; i++)
1771         {
1772             for (j = 0; j < noTemplates; j++)
1773             {
1774                 if (strings[i] == templates[j]->m_viewTypeName)
1775                     data[i] = templates[j];
1776             }
1777         }
1778     }
1779
1780     wxDocTemplate *theTemplate;
1781
1782     // the same logic as above
1783     switch ( n )
1784     {
1785         case 0:
1786             theTemplate = NULL;
1787             break;
1788
1789         case 1:
1790             theTemplate = data[0];
1791             break;
1792
1793         default:
1794             theTemplate = (wxDocTemplate *)wxGetSingleChoiceData
1795                           (
1796                             _("Select a document view"),
1797                             _("Views"),
1798                             strings,
1799                             (void **)data.get()
1800                           );
1801
1802     }
1803
1804     return theTemplate;
1805 }
1806
1807 void wxDocManager::AssociateTemplate(wxDocTemplate *temp)
1808 {
1809     if (!m_templates.Member(temp))
1810         m_templates.Append(temp);
1811 }
1812
1813 void wxDocManager::DisassociateTemplate(wxDocTemplate *temp)
1814 {
1815     m_templates.DeleteObject(temp);
1816 }
1817
1818 // Add and remove a document from the manager's list
1819 void wxDocManager::AddDocument(wxDocument *doc)
1820 {
1821     if (!m_docs.Member(doc))
1822         m_docs.Append(doc);
1823 }
1824
1825 void wxDocManager::RemoveDocument(wxDocument *doc)
1826 {
1827     m_docs.DeleteObject(doc);
1828 }
1829
1830 // Views or windows should inform the document manager
1831 // when a view is going in or out of focus
1832 void wxDocManager::ActivateView(wxView *view, bool activate)
1833 {
1834     if ( activate )
1835     {
1836         m_currentView = view;
1837     }
1838     else // deactivate
1839     {
1840         if ( m_currentView == view )
1841         {
1842             // don't keep stale pointer
1843             m_currentView = NULL;
1844         }
1845     }
1846 }
1847
1848 // ----------------------------------------------------------------------------
1849 // wxDocChildFrameAnyBase
1850 // ----------------------------------------------------------------------------
1851
1852 bool wxDocChildFrameAnyBase::CloseView(wxCloseEvent& event)
1853 {
1854     if ( m_childView )
1855     {
1856         if ( event.CanVeto() && !m_childView->Close(false) )
1857         {
1858             event.Veto();
1859             return false;
1860         }
1861
1862         m_childView->Activate(false);
1863
1864         // it is important to reset m_childView frame pointer to NULL before
1865         // deleting it because while normally it is the frame which deletes the
1866         // view when it's closed, the view also closes the frame if it is
1867         // deleted directly not by us as indicated by its doc child frame
1868         // pointer still being set
1869         m_childView->SetDocChildFrame(NULL);
1870         delete m_childView;
1871         m_childView = NULL;
1872     }
1873
1874     m_childDocument = NULL;
1875
1876     return true;
1877 }
1878
1879 // ----------------------------------------------------------------------------
1880 // Default parent frame
1881 // ----------------------------------------------------------------------------
1882
1883 BEGIN_EVENT_TABLE(wxDocParentFrame, wxFrame)
1884     EVT_MENU(wxID_EXIT, wxDocParentFrame::OnExit)
1885     EVT_MENU_RANGE(wxID_FILE1, wxID_FILE9, wxDocParentFrame::OnMRUFile)
1886     EVT_CLOSE(wxDocParentFrame::OnCloseWindow)
1887 END_EVENT_TABLE()
1888
1889 wxDocParentFrame::wxDocParentFrame()
1890 {
1891     m_docManager = NULL;
1892 }
1893
1894 wxDocParentFrame::wxDocParentFrame(wxDocManager *manager,
1895                                    wxFrame *frame,
1896                                    wxWindowID id,
1897                                    const wxString& title,
1898                                    const wxPoint& pos,
1899                                    const wxSize& size,
1900                                    long style,
1901                                    const wxString& name)
1902                 : wxFrame(frame, id, title, pos, size, style, name)
1903 {
1904     m_docManager = manager;
1905 }
1906
1907 bool wxDocParentFrame::Create(wxDocManager *manager,
1908                               wxFrame *frame,
1909                               wxWindowID id,
1910                               const wxString& title,
1911                               const wxPoint& pos,
1912                               const wxSize& size,
1913                               long style,
1914                               const wxString& name)
1915 {
1916     m_docManager = manager;
1917     return base_type::Create(frame, id, title, pos, size, style, name);
1918 }
1919
1920 void wxDocParentFrame::OnExit(wxCommandEvent& WXUNUSED(event))
1921 {
1922     Close();
1923 }
1924
1925 void wxDocParentFrame::OnMRUFile(wxCommandEvent& event)
1926 {
1927     int n = event.GetId() - wxID_FILE1;  // the index in MRU list
1928     wxString filename(m_docManager->GetHistoryFile(n));
1929     if ( filename.empty() )
1930         return;
1931
1932     wxString errMsg; // must contain exactly one "%s" if non-empty
1933     if ( wxFile::Exists(filename) )
1934     {
1935         // try to open it
1936         if ( m_docManager->CreateDocument(filename, wxDOC_SILENT) )
1937             return;
1938
1939         errMsg = _("The file '%s' couldn't be opened.");
1940     }
1941     else // file doesn't exist
1942     {
1943         errMsg = _("The file '%s' doesn't exist and couldn't be opened.");
1944     }
1945
1946
1947     wxASSERT_MSG( !errMsg.empty(), "should have an error message" );
1948
1949     // remove the file which we can't open from the MRU list
1950     m_docManager->RemoveFileFromHistory(n);
1951
1952     // and tell the user about it
1953     wxLogError(errMsg + '\n' +
1954                _("It has been removed from the most recently used files list."),
1955                filename);
1956 }
1957
1958 // Extend event processing to search the view's event table
1959 bool wxDocParentFrame::TryBefore(wxEvent& event)
1960 {
1961     if ( m_docManager && m_docManager->ProcessEventHere(event) )
1962         return true;
1963
1964     return wxFrame::TryBefore(event);
1965 }
1966
1967 // Define the behaviour for the frame closing
1968 // - must delete all frames except for the main one.
1969 void wxDocParentFrame::OnCloseWindow(wxCloseEvent& event)
1970 {
1971     if (m_docManager->Clear(!event.CanVeto()))
1972     {
1973         Destroy();
1974     }
1975     else
1976         event.Veto();
1977 }
1978
1979 #if wxUSE_PRINTING_ARCHITECTURE
1980
1981 wxDocPrintout::wxDocPrintout(wxView *view, const wxString& title)
1982              : wxPrintout(title)
1983 {
1984     m_printoutView = view;
1985 }
1986
1987 bool wxDocPrintout::OnPrintPage(int WXUNUSED(page))
1988 {
1989     wxDC *dc = GetDC();
1990
1991     // Get the logical pixels per inch of screen and printer
1992     int ppiScreenX, ppiScreenY;
1993     GetPPIScreen(&ppiScreenX, &ppiScreenY);
1994     wxUnusedVar(ppiScreenY);
1995     int ppiPrinterX, ppiPrinterY;
1996     GetPPIPrinter(&ppiPrinterX, &ppiPrinterY);
1997     wxUnusedVar(ppiPrinterY);
1998
1999     // This scales the DC so that the printout roughly represents the
2000     // the screen scaling. The text point size _should_ be the right size
2001     // but in fact is too small for some reason. This is a detail that will
2002     // need to be addressed at some point but can be fudged for the
2003     // moment.
2004     float scale = (float)((float)ppiPrinterX/(float)ppiScreenX);
2005
2006     // Now we have to check in case our real page size is reduced
2007     // (e.g. because we're drawing to a print preview memory DC)
2008     int pageWidth, pageHeight;
2009     int w, h;
2010     dc->GetSize(&w, &h);
2011     GetPageSizePixels(&pageWidth, &pageHeight);
2012     wxUnusedVar(pageHeight);
2013
2014     // If printer pageWidth == current DC width, then this doesn't
2015     // change. But w might be the preview bitmap width, so scale down.
2016     float overallScale = scale * (float)(w/(float)pageWidth);
2017     dc->SetUserScale(overallScale, overallScale);
2018
2019     if (m_printoutView)
2020     {
2021         m_printoutView->OnDraw(dc);
2022     }
2023     return true;
2024 }
2025
2026 bool wxDocPrintout::HasPage(int pageNum)
2027 {
2028     return (pageNum == 1);
2029 }
2030
2031 bool wxDocPrintout::OnBeginDocument(int startPage, int endPage)
2032 {
2033     if (!wxPrintout::OnBeginDocument(startPage, endPage))
2034         return false;
2035
2036     return true;
2037 }
2038
2039 void wxDocPrintout::GetPageInfo(int *minPage, int *maxPage,
2040                                 int *selPageFrom, int *selPageTo)
2041 {
2042     *minPage = 1;
2043     *maxPage = 1;
2044     *selPageFrom = 1;
2045     *selPageTo = 1;
2046 }
2047
2048 #endif // wxUSE_PRINTING_ARCHITECTURE
2049
2050 // ----------------------------------------------------------------------------
2051 // File history (a.k.a. MRU, most recently used, files list)
2052 // ----------------------------------------------------------------------------
2053
2054 wxFileHistory::wxFileHistory(size_t maxFiles, wxWindowID idBase)
2055 {
2056     m_fileMaxFiles = maxFiles;
2057     m_idBase = idBase;
2058 }
2059
2060 void wxFileHistory::AddFileToHistory(const wxString& file)
2061 {
2062     // check if we don't already have this file
2063     const wxFileName fnNew(file);
2064     size_t i,
2065            numFiles = m_fileHistory.size();
2066     for ( i = 0; i < numFiles; i++ )
2067     {
2068         if ( fnNew == m_fileHistory[i] )
2069         {
2070             // we do have it, move it to the top of the history
2071             RemoveFileFromHistory(i);
2072             numFiles--;
2073             break;
2074         }
2075     }
2076
2077     // if we already have a full history, delete the one at the end
2078     if ( numFiles == m_fileMaxFiles )
2079     {
2080         RemoveFileFromHistory(--numFiles);
2081     }
2082
2083     // add a new menu item to all file menus (they will be updated below)
2084     for ( wxList::compatibility_iterator node = m_fileMenus.GetFirst();
2085         node;
2086         node = node->GetNext() )
2087     {
2088         wxMenu * const menu = (wxMenu *)node->GetData();
2089
2090         if ( !numFiles && menu->GetMenuItemCount() )
2091             menu->AppendSeparator();
2092
2093         // label doesn't matter, it will be set below anyhow, but it can't
2094         // be empty (this is supposed to indicate a stock item)
2095         menu->Append(m_idBase + numFiles, " ");
2096     }
2097
2098     // insert the new file in the beginning of the file history
2099     m_fileHistory.insert(m_fileHistory.begin(), file);
2100     numFiles++;
2101
2102     // update the labels in all menus
2103     for ( i = 0; i < numFiles; i++ )
2104     {
2105         // if in same directory just show the filename; otherwise the full path
2106         const wxFileName fnOld(m_fileHistory[i]);
2107
2108         wxString pathInMenu;
2109         if ( fnOld.GetPath() == fnNew.GetPath() )
2110         {
2111             pathInMenu = fnOld.GetFullName();
2112         }
2113         else // file in different directory
2114         {
2115             // absolute path; could also set relative path
2116             pathInMenu = m_fileHistory[i];
2117         }
2118
2119         for ( wxList::compatibility_iterator node = m_fileMenus.GetFirst();
2120               node;
2121               node = node->GetNext() )
2122         {
2123             wxMenu * const menu = (wxMenu *)node->GetData();
2124
2125             menu->SetLabel(m_idBase + i, GetMRUEntryLabel(i, pathInMenu));
2126         }
2127     }
2128 }
2129
2130 void wxFileHistory::RemoveFileFromHistory(size_t i)
2131 {
2132     size_t numFiles = m_fileHistory.size();
2133     wxCHECK_RET( i < numFiles,
2134                  wxT("invalid index in wxFileHistory::RemoveFileFromHistory") );
2135
2136     // delete the element from the array
2137     m_fileHistory.RemoveAt(i);
2138     numFiles--;
2139
2140     for ( wxList::compatibility_iterator node = m_fileMenus.GetFirst();
2141           node;
2142           node = node->GetNext() )
2143     {
2144         wxMenu * const menu = (wxMenu *) node->GetData();
2145
2146         // shift filenames up
2147         for ( size_t j = i; j < numFiles; j++ )
2148         {
2149             menu->SetLabel(m_idBase + j, GetMRUEntryLabel(j, m_fileHistory[j]));
2150         }
2151
2152         // delete the last menu item which is unused now
2153         const wxWindowID lastItemId = m_idBase + numFiles;
2154         if ( menu->FindItem(lastItemId) )
2155             menu->Delete(lastItemId);
2156
2157         // delete the last separator too if no more files are left
2158         if ( m_fileHistory.empty() )
2159         {
2160             const wxMenuItemList::compatibility_iterator
2161                 nodeLast = menu->GetMenuItems().GetLast();
2162             if ( nodeLast )
2163             {
2164                 wxMenuItem * const lastMenuItem = nodeLast->GetData();
2165                 if ( lastMenuItem->IsSeparator() )
2166                     menu->Delete(lastMenuItem);
2167             }
2168             //else: menu is empty somehow
2169         }
2170     }
2171 }
2172
2173 void wxFileHistory::UseMenu(wxMenu *menu)
2174 {
2175     if ( !m_fileMenus.Member(menu) )
2176         m_fileMenus.Append(menu);
2177 }
2178
2179 void wxFileHistory::RemoveMenu(wxMenu *menu)
2180 {
2181     m_fileMenus.DeleteObject(menu);
2182 }
2183
2184 #if wxUSE_CONFIG
2185 void wxFileHistory::Load(const wxConfigBase& config)
2186 {
2187     m_fileHistory.Clear();
2188
2189     wxString buf;
2190     buf.Printf(wxT("file%d"), 1);
2191
2192     wxString historyFile;
2193     while ((m_fileHistory.GetCount() < m_fileMaxFiles) &&
2194            config.Read(buf, &historyFile) && !historyFile.empty())
2195     {
2196         m_fileHistory.Add(historyFile);
2197
2198         buf.Printf(wxT("file%d"), (int)m_fileHistory.GetCount()+1);
2199         historyFile = wxEmptyString;
2200     }
2201
2202     AddFilesToMenu();
2203 }
2204
2205 void wxFileHistory::Save(wxConfigBase& config)
2206 {
2207     size_t i;
2208     for (i = 0; i < m_fileMaxFiles; i++)
2209     {
2210         wxString buf;
2211         buf.Printf(wxT("file%d"), (int)i+1);
2212         if (i < m_fileHistory.GetCount())
2213             config.Write(buf, wxString(m_fileHistory[i]));
2214         else
2215             config.Write(buf, wxEmptyString);
2216     }
2217 }
2218 #endif // wxUSE_CONFIG
2219
2220 void wxFileHistory::AddFilesToMenu()
2221 {
2222     if ( m_fileHistory.empty() )
2223         return;
2224
2225     for ( wxList::compatibility_iterator node = m_fileMenus.GetFirst();
2226           node;
2227           node = node->GetNext() )
2228     {
2229         AddFilesToMenu((wxMenu *) node->GetData());
2230     }
2231 }
2232
2233 void wxFileHistory::AddFilesToMenu(wxMenu* menu)
2234 {
2235     if ( m_fileHistory.empty() )
2236         return;
2237
2238     if ( menu->GetMenuItemCount() )
2239         menu->AppendSeparator();
2240
2241     for ( size_t i = 0; i < m_fileHistory.GetCount(); i++ )
2242     {
2243         menu->Append(m_idBase + i, GetMRUEntryLabel(i, m_fileHistory[i]));
2244     }
2245 }
2246
2247 // ----------------------------------------------------------------------------
2248 // Permits compatibility with existing file formats and functions that
2249 // manipulate files directly
2250 // ----------------------------------------------------------------------------
2251
2252 #if wxUSE_STD_IOSTREAM
2253
2254 bool wxTransferFileToStream(const wxString& filename, wxSTD ostream& stream)
2255 {
2256 #if wxUSE_FFILE
2257     wxFFile file(filename, wxT("rb"));
2258 #elif wxUSE_FILE
2259     wxFile file(filename, wxFile::read);
2260 #endif
2261     if ( !file.IsOpened() )
2262         return false;
2263
2264     char buf[4096];
2265
2266     size_t nRead;
2267     do
2268     {
2269         nRead = file.Read(buf, WXSIZEOF(buf));
2270         if ( file.Error() )
2271             return false;
2272
2273         stream.write(buf, nRead);
2274         if ( !stream )
2275             return false;
2276     }
2277     while ( !file.Eof() );
2278
2279     return true;
2280 }
2281
2282 bool wxTransferStreamToFile(wxSTD istream& stream, const wxString& filename)
2283 {
2284 #if wxUSE_FFILE
2285     wxFFile file(filename, wxT("wb"));
2286 #elif wxUSE_FILE
2287     wxFile file(filename, wxFile::write);
2288 #endif
2289     if ( !file.IsOpened() )
2290         return false;
2291
2292     char buf[4096];
2293     do
2294     {
2295         stream.read(buf, WXSIZEOF(buf));
2296         if ( !stream.bad() ) // fail may be set on EOF, don't use operator!()
2297         {
2298             if ( !file.Write(buf, stream.gcount()) )
2299                 return false;
2300         }
2301     }
2302     while ( !stream.eof() );
2303
2304     return true;
2305 }
2306
2307 #else // !wxUSE_STD_IOSTREAM
2308
2309 bool wxTransferFileToStream(const wxString& filename, wxOutputStream& stream)
2310 {
2311 #if wxUSE_FFILE
2312     wxFFile file(filename, wxT("rb"));
2313 #elif wxUSE_FILE
2314     wxFile file(filename, wxFile::read);
2315 #endif
2316     if ( !file.IsOpened() )
2317         return false;
2318
2319     char buf[4096];
2320
2321     size_t nRead;
2322     do
2323     {
2324         nRead = file.Read(buf, WXSIZEOF(buf));
2325         if ( file.Error() )
2326             return false;
2327
2328         stream.Write(buf, nRead);
2329         if ( !stream )
2330             return false;
2331     }
2332     while ( !file.Eof() );
2333
2334     return true;
2335 }
2336
2337 bool wxTransferStreamToFile(wxInputStream& stream, const wxString& filename)
2338 {
2339 #if wxUSE_FFILE
2340     wxFFile file(filename, wxT("wb"));
2341 #elif wxUSE_FILE
2342     wxFile file(filename, wxFile::write);
2343 #endif
2344     if ( !file.IsOpened() )
2345         return false;
2346
2347     char buf[4096];
2348     for ( ;; )
2349     {
2350         stream.Read(buf, WXSIZEOF(buf));
2351
2352         const size_t nRead = stream.LastRead();
2353         if ( !nRead )
2354         {
2355             if ( stream.Eof() )
2356                 break;
2357
2358             return false;
2359         }
2360
2361         if ( !file.Write(buf, nRead) )
2362             return false;
2363     }
2364
2365     return true;
2366 }
2367
2368 #endif // wxUSE_STD_IOSTREAM/!wxUSE_STD_IOSTREAM
2369
2370 #endif // wxUSE_DOC_VIEW_ARCHITECTURE