]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/generic/logg.cpp
moving embedding to common API
[wxWidgets.git] / src / generic / logg.cpp
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: src/generic/logg.cpp
3// Purpose: wxLog-derived classes which need GUI support (the rest is in
4// src/common/log.cpp)
5// Author: Vadim Zeitlin
6// Modified by:
7// Created: 20.09.99 (extracted from src/common/log.cpp)
8// RCS-ID: $Id$
9// Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
10// Licence: wxWindows licence
11/////////////////////////////////////////////////////////////////////////////
12
13// ============================================================================
14// declarations
15// ============================================================================
16
17// ----------------------------------------------------------------------------
18// headers
19// ----------------------------------------------------------------------------
20
21// For compilers that support precompilation, includes "wx.h".
22#include "wx/wxprec.h"
23
24#ifdef __BORLANDC__
25 #pragma hdrstop
26#endif
27
28#ifndef WX_PRECOMP
29 #include "wx/app.h"
30 #include "wx/button.h"
31 #include "wx/intl.h"
32 #include "wx/log.h"
33 #include "wx/menu.h"
34 #include "wx/frame.h"
35 #include "wx/filedlg.h"
36 #include "wx/msgdlg.h"
37 #include "wx/textctrl.h"
38 #include "wx/sizer.h"
39 #include "wx/statbmp.h"
40 #include "wx/settings.h"
41 #include "wx/wxcrtvararg.h"
42#endif // WX_PRECOMP
43
44#if wxUSE_LOGGUI || wxUSE_LOGWINDOW
45
46#include "wx/file.h"
47#include "wx/clipbrd.h"
48#include "wx/dataobj.h"
49#include "wx/textfile.h"
50#include "wx/statline.h"
51#include "wx/artprov.h"
52#include "wx/collpane.h"
53#include "wx/arrstr.h"
54
55#if wxUSE_THREADS
56 #include "wx/thread.h"
57#endif // wxUSE_THREADS
58
59#ifdef __WXMSW__
60 // for OutputDebugString()
61 #include "wx/msw/private.h"
62#endif // Windows
63
64
65#ifdef __WXPM__
66 #include <time.h>
67#endif
68
69#if wxUSE_LOG_DIALOG
70 #include "wx/listctrl.h"
71 #include "wx/imaglist.h"
72 #include "wx/image.h"
73#endif // wxUSE_LOG_DIALOG/!wxUSE_LOG_DIALOG
74
75#if defined(__MWERKS__) && wxUSE_UNICODE
76 #include <wtime.h>
77#endif
78
79#include "wx/datetime.h"
80
81// the suffix we add to the button to show that the dialog can be expanded
82#define EXPAND_SUFFIX _T(" >>")
83
84#define CAN_SAVE_FILES (wxUSE_FILE && wxUSE_FILEDLG)
85
86// ----------------------------------------------------------------------------
87// private classes
88// ----------------------------------------------------------------------------
89
90#if wxUSE_LOG_DIALOG
91
92// this function is a wrapper around strftime(3)
93// allows to exclude the usage of wxDateTime
94static wxString TimeStamp(const wxString& format, time_t t)
95{
96#if wxUSE_DATETIME
97 wxChar buf[4096];
98 struct tm tm;
99 if ( !wxStrftime(buf, WXSIZEOF(buf), format, wxLocaltime_r(&t, &tm)) )
100 {
101 // buffer is too small?
102 wxFAIL_MSG(_T("strftime() failed"));
103 }
104 return wxString(buf);
105#else // !wxUSE_DATETIME
106 return wxEmptyString;
107#endif // wxUSE_DATETIME/!wxUSE_DATETIME
108}
109
110
111class wxLogDialog : public wxDialog
112{
113public:
114 wxLogDialog(wxWindow *parent,
115 const wxArrayString& messages,
116 const wxArrayInt& severity,
117 const wxArrayLong& timess,
118 const wxString& caption,
119 long style);
120 virtual ~wxLogDialog();
121
122 // event handlers
123 void OnOk(wxCommandEvent& event);
124#if wxUSE_CLIPBOARD
125 void OnCopy(wxCommandEvent& event);
126#endif // wxUSE_CLIPBOARD
127#if CAN_SAVE_FILES
128 void OnSave(wxCommandEvent& event);
129#endif // CAN_SAVE_FILES
130 void OnListSelect(wxListEvent& event);
131 void OnListItemActivated(wxListEvent& event);
132
133private:
134 // create controls needed for the details display
135 void CreateDetailsControls(wxWindow *);
136
137 // if necessary truncates the given string and adds an ellipsis
138 wxString EllipsizeString(const wxString &text)
139 {
140 if (ms_maxLength > 0 &&
141 text.length() > ms_maxLength)
142 {
143 wxString ret(text);
144 ret.Truncate(ms_maxLength);
145 ret << "...";
146 return ret;
147 }
148
149 return text;
150 }
151
152#if CAN_SAVE_FILES || wxUSE_CLIPBOARD
153 // return the contents of the dialog as a multiline string
154 wxString GetLogMessages() const;
155#endif // CAN_SAVE_FILES || wxUSE_CLIPBOARD
156
157
158 // the data for the listctrl
159 wxArrayString m_messages;
160 wxArrayInt m_severity;
161 wxArrayLong m_times;
162
163 // the controls which are not shown initially (but only when details
164 // button is pressed)
165 wxListCtrl *m_listctrl;
166
167 // the translated "Details" string
168 static wxString ms_details;
169
170 // the maximum length of the log message
171 static size_t ms_maxLength;
172
173 DECLARE_EVENT_TABLE()
174 DECLARE_NO_COPY_CLASS(wxLogDialog)
175};
176
177BEGIN_EVENT_TABLE(wxLogDialog, wxDialog)
178 EVT_BUTTON(wxID_OK, wxLogDialog::OnOk)
179#if wxUSE_CLIPBOARD
180 EVT_BUTTON(wxID_COPY, wxLogDialog::OnCopy)
181#endif // wxUSE_CLIPBOARD
182#if CAN_SAVE_FILES
183 EVT_BUTTON(wxID_SAVE, wxLogDialog::OnSave)
184#endif // CAN_SAVE_FILES
185 EVT_LIST_ITEM_SELECTED(wxID_ANY, wxLogDialog::OnListSelect)
186 EVT_LIST_ITEM_ACTIVATED(wxID_ANY, wxLogDialog::OnListItemActivated)
187END_EVENT_TABLE()
188
189#endif // wxUSE_LOG_DIALOG
190
191// ----------------------------------------------------------------------------
192// private functions
193// ----------------------------------------------------------------------------
194
195#if CAN_SAVE_FILES
196
197// pass an uninitialized file object, the function will ask the user for the
198// filename and try to open it, returns true on success (file was opened),
199// false if file couldn't be opened/created and -1 if the file selection
200// dialog was cancelled
201static int OpenLogFile(wxFile& file, wxString *filename = NULL, wxWindow *parent = NULL);
202
203#endif // CAN_SAVE_FILES
204
205// ----------------------------------------------------------------------------
206// global variables
207// ----------------------------------------------------------------------------
208
209// we use a global variable to store the frame pointer for wxLogStatus - bad,
210// but it's the easiest way
211static wxFrame *gs_pFrame = NULL; // FIXME MT-unsafe
212
213// ============================================================================
214// implementation
215// ============================================================================
216
217// ----------------------------------------------------------------------------
218// global functions
219// ----------------------------------------------------------------------------
220
221// accepts an additional argument which tells to which frame the output should
222// be directed
223void wxVLogStatus(wxFrame *pFrame, const wxString& format, va_list argptr)
224{
225 wxString msg;
226
227 wxLog *pLog = wxLog::GetActiveTarget();
228 if ( pLog != NULL ) {
229 msg.PrintfV(format, argptr);
230
231 wxASSERT( gs_pFrame == NULL ); // should be reset!
232 gs_pFrame = pFrame;
233#ifdef __WXWINCE__
234 wxLog::OnLog(wxLOG_Status, msg, 0);
235#else
236 wxLog::OnLog(wxLOG_Status, msg, time(NULL));
237#endif
238 gs_pFrame = (wxFrame *) NULL;
239 }
240}
241
242#if !wxUSE_UTF8_LOCALE_ONLY
243void wxDoLogStatusWchar(wxFrame *pFrame, const wxChar *format, ...)
244{
245 va_list argptr;
246 va_start(argptr, format);
247 wxVLogStatus(pFrame, format, argptr);
248 va_end(argptr);
249}
250#endif // !wxUSE_UTF8_LOCALE_ONLY
251
252#if wxUSE_UNICODE_UTF8
253void wxDoLogStatusUtf8(wxFrame *pFrame, const char *format, ...)
254{
255 va_list argptr;
256 va_start(argptr, format);
257 wxVLogStatus(pFrame, format, argptr);
258 va_end(argptr);
259}
260#endif // wxUSE_UNICODE_UTF8
261
262// ----------------------------------------------------------------------------
263// wxLogGui implementation (FIXME MT-unsafe)
264// ----------------------------------------------------------------------------
265
266#if wxUSE_LOGGUI
267
268wxLogGui::wxLogGui()
269{
270 Clear();
271}
272
273void wxLogGui::Clear()
274{
275 m_bErrors =
276 m_bWarnings =
277 m_bHasMessages = false;
278
279 m_aMessages.Empty();
280 m_aSeverity.Empty();
281 m_aTimes.Empty();
282}
283
284int wxLogGui::GetSeverityIcon() const
285{
286 return m_bErrors ? wxICON_STOP
287 : m_bWarnings ? wxICON_EXCLAMATION
288 : wxICON_INFORMATION;
289}
290
291wxString wxLogGui::GetTitle() const
292{
293 wxString titleFormat;
294 switch ( GetSeverityIcon() )
295 {
296 case wxICON_STOP:
297 titleFormat = _("%s Error");
298 break;
299
300 case wxICON_EXCLAMATION:
301 titleFormat = _("%s Warning");
302 break;
303
304 default:
305 wxFAIL_MSG( "unexpected icon severity" );
306 // fall through
307
308 case wxICON_INFORMATION:
309 titleFormat = _("%s Information");
310 }
311
312 return wxString::Format(titleFormat, wxTheApp->GetAppDisplayName());
313}
314
315void
316wxLogGui::DoShowSingleLogMessage(const wxString& message,
317 const wxString& title,
318 int style)
319{
320 wxMessageBox(message, title, wxOK | style);
321}
322
323void
324wxLogGui::DoShowMultipleLogMessages(const wxArrayString& messages,
325 const wxArrayInt& severities,
326 const wxArrayLong& times,
327 const wxString& title,
328 int style)
329{
330#if wxUSE_LOG_DIALOG
331 wxLogDialog dlg(NULL,
332 messages, severities, times,
333 title, style);
334
335 // clear the message list before showing the dialog because while it's
336 // shown some new messages may appear
337 Clear();
338
339 (void)dlg.ShowModal();
340#else // !wxUSE_LOG_DIALOG
341 // start from the most recent message
342 wxString message;
343 str.reserve(nMsgCount*100);
344 for ( size_t n = nMsgCount; n > 0; n-- ) {
345 message << m_aMessages[n - 1] << wxT("\n");
346 }
347
348 DoShowSingleLogMessage(message, title, style);
349#endif // wxUSE_LOG_DIALOG/!wxUSE_LOG_DIALOG
350}
351
352void wxLogGui::Flush()
353{
354 if ( !m_bHasMessages )
355 return;
356
357 // do it right now to block any new calls to Flush() while we're here
358 m_bHasMessages = false;
359
360 // note that this must be done before examining m_aMessages as it may log
361 // yet another message
362 const unsigned repeatCount = LogLastRepeatIfNeeded();
363
364 const size_t nMsgCount = m_aMessages.size();
365
366 if ( repeatCount > 0 )
367 {
368 m_aMessages[nMsgCount - 1] << " (" << m_aMessages[nMsgCount - 2] << ")";
369 }
370
371 const wxString title = GetTitle();
372 const int style = GetSeverityIcon();
373
374 // avoid showing other log dialogs until we're done with the dialog we're
375 // showing right now: nested modal dialogs make for really bad UI!
376 Suspend();
377
378 if ( nMsgCount == 1 )
379 {
380 // make a copy before calling Clear()
381 const wxString message(m_aMessages[0]);
382 Clear();
383
384 DoShowSingleLogMessage(message, title, style);
385 }
386 else // more than one message
387 {
388 wxArrayString messages;
389 wxArrayInt severities;
390 wxArrayLong times;
391
392 messages.swap(m_aMessages);
393 severities.swap(m_aSeverity);
394 times.swap(m_aTimes);
395
396 Clear();
397
398 DoShowMultipleLogMessages(messages, severities, times, title, style);
399 }
400
401 // allow flushing the logs again
402 Resume();
403}
404
405// log all kinds of messages
406void wxLogGui::DoLog(wxLogLevel level, const wxString& szString, time_t t)
407{
408 switch ( level ) {
409 case wxLOG_Info:
410 if ( GetVerbose() )
411 case wxLOG_Message:
412 {
413 m_aMessages.Add(szString);
414 m_aSeverity.Add(wxLOG_Message);
415 m_aTimes.Add((long)t);
416 m_bHasMessages = true;
417 }
418 break;
419
420 case wxLOG_Status:
421#if wxUSE_STATUSBAR
422 {
423 // find the top window and set it's status text if it has any
424 wxFrame *pFrame = gs_pFrame;
425 if ( pFrame == NULL ) {
426 wxWindow *pWin = wxTheApp->GetTopWindow();
427 if ( pWin != NULL && pWin->IsKindOf(CLASSINFO(wxFrame)) ) {
428 pFrame = (wxFrame *)pWin;
429 }
430 }
431
432 if ( pFrame && pFrame->GetStatusBar() )
433 pFrame->SetStatusText(szString);
434 }
435#endif // wxUSE_STATUSBAR
436 break;
437
438 case wxLOG_Trace:
439 case wxLOG_Debug:
440 #ifdef __WXDEBUG__
441 {
442 wxString str;
443 TimeStamp(&str);
444 str += szString;
445
446 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
447 // don't prepend debug/trace here: it goes to the
448 // debug window anyhow
449 str += wxT("\r\n");
450 OutputDebugString(str.wx_str());
451 #else
452 // send them to stderr
453 wxFprintf(stderr, wxT("[%s] %s\n"),
454 level == wxLOG_Trace ? wxT("Trace")
455 : wxT("Debug"),
456 str.c_str());
457 fflush(stderr);
458 #endif
459 }
460 #endif // __WXDEBUG__
461
462 break;
463
464 case wxLOG_FatalError:
465 // show this one immediately
466 wxMessageBox(szString, _("Fatal error"), wxICON_HAND);
467 wxExit();
468 break;
469
470 case wxLOG_Error:
471 if ( !m_bErrors ) {
472#if !wxUSE_LOG_DIALOG
473 // discard earlier informational messages if this is the 1st
474 // error because they might not make sense any more and showing
475 // them in a message box might be confusing
476 m_aMessages.Empty();
477 m_aSeverity.Empty();
478 m_aTimes.Empty();
479#endif // wxUSE_LOG_DIALOG
480 m_bErrors = true;
481 }
482 // fall through
483
484 case wxLOG_Warning:
485 if ( !m_bErrors ) {
486 // for the warning we don't discard the info messages
487 m_bWarnings = true;
488 }
489
490 m_aMessages.Add(szString);
491 m_aSeverity.Add((int)level);
492 m_aTimes.Add((long)t);
493 m_bHasMessages = true;
494 break;
495 }
496}
497
498#endif // wxUSE_LOGGUI
499
500// ----------------------------------------------------------------------------
501// wxLogWindow and wxLogFrame implementation
502// ----------------------------------------------------------------------------
503
504#if wxUSE_LOGWINDOW
505
506// log frame class
507// ---------------
508class wxLogFrame : public wxFrame
509{
510public:
511 // ctor & dtor
512 wxLogFrame(wxWindow *pParent, wxLogWindow *log, const wxString& szTitle);
513 virtual ~wxLogFrame();
514
515 // menu callbacks
516 void OnClose(wxCommandEvent& event);
517 void OnCloseWindow(wxCloseEvent& event);
518#if CAN_SAVE_FILES
519 void OnSave(wxCommandEvent& event);
520#endif // CAN_SAVE_FILES
521 void OnClear(wxCommandEvent& event);
522
523 // this function is safe to call from any thread (notice that it should be
524 // also called from the main thread to ensure that the messages logged from
525 // it appear in correct order with the messages from the other threads)
526 void AddLogMessage(const wxString& message);
527
528 // actually append the messages logged from secondary threads to the text
529 // control during idle time in the main thread
530 virtual void OnInternalIdle();
531
532private:
533 // use standard ids for our commands!
534 enum
535 {
536 Menu_Close = wxID_CLOSE,
537 Menu_Save = wxID_SAVE,
538 Menu_Clear = wxID_CLEAR
539 };
540
541 // common part of OnClose() and OnCloseWindow()
542 void DoClose();
543
544 // do show the message in the text control
545 void DoShowLogMessage(const wxString& message)
546 {
547 m_pTextCtrl->AppendText(message);
548 }
549
550 wxTextCtrl *m_pTextCtrl;
551 wxLogWindow *m_log;
552
553 // queue of messages logged from other threads which need to be displayed
554 wxArrayString m_pendingMessages;
555
556#if wxUSE_THREADS
557 // critical section to protect access to m_pendingMessages
558 wxCriticalSection m_critSection;
559#endif // wxUSE_THREADS
560
561
562 DECLARE_EVENT_TABLE()
563 DECLARE_NO_COPY_CLASS(wxLogFrame)
564};
565
566BEGIN_EVENT_TABLE(wxLogFrame, wxFrame)
567 // wxLogWindow menu events
568 EVT_MENU(Menu_Close, wxLogFrame::OnClose)
569#if CAN_SAVE_FILES
570 EVT_MENU(Menu_Save, wxLogFrame::OnSave)
571#endif // CAN_SAVE_FILES
572 EVT_MENU(Menu_Clear, wxLogFrame::OnClear)
573
574 EVT_CLOSE(wxLogFrame::OnCloseWindow)
575END_EVENT_TABLE()
576
577wxLogFrame::wxLogFrame(wxWindow *pParent, wxLogWindow *log, const wxString& szTitle)
578 : wxFrame(pParent, wxID_ANY, szTitle)
579{
580 m_log = log;
581
582 m_pTextCtrl = new wxTextCtrl(this, wxID_ANY, wxEmptyString, wxDefaultPosition,
583 wxDefaultSize,
584 wxTE_MULTILINE |
585 wxHSCROLL |
586 // needed for Win32 to avoid 65Kb limit but it doesn't work well
587 // when using RichEdit 2.0 which we always do in the Unicode build
588#if !wxUSE_UNICODE
589 wxTE_RICH |
590#endif // !wxUSE_UNICODE
591 wxTE_READONLY);
592
593#if wxUSE_MENUS
594 // create menu
595 wxMenuBar *pMenuBar = new wxMenuBar;
596 wxMenu *pMenu = new wxMenu;
597#if CAN_SAVE_FILES
598 pMenu->Append(Menu_Save, _("&Save..."), _("Save log contents to file"));
599#endif // CAN_SAVE_FILES
600 pMenu->Append(Menu_Clear, _("C&lear"), _("Clear the log contents"));
601 pMenu->AppendSeparator();
602 pMenu->Append(Menu_Close, _("&Close"), _("Close this window"));
603 pMenuBar->Append(pMenu, _("&Log"));
604 SetMenuBar(pMenuBar);
605#endif // wxUSE_MENUS
606
607#if wxUSE_STATUSBAR
608 // status bar for menu prompts
609 CreateStatusBar();
610#endif // wxUSE_STATUSBAR
611
612 m_log->OnFrameCreate(this);
613}
614
615void wxLogFrame::DoClose()
616{
617 if ( m_log->OnFrameClose(this) )
618 {
619 // instead of closing just hide the window to be able to Show() it
620 // later
621 Show(false);
622 }
623}
624
625void wxLogFrame::OnClose(wxCommandEvent& WXUNUSED(event))
626{
627 DoClose();
628}
629
630void wxLogFrame::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
631{
632 DoClose();
633}
634
635#if CAN_SAVE_FILES
636void wxLogFrame::OnSave(wxCommandEvent& WXUNUSED(event))
637{
638 wxString filename;
639 wxFile file;
640 int rc = OpenLogFile(file, &filename, this);
641 if ( rc == -1 )
642 {
643 // cancelled
644 return;
645 }
646
647 bool bOk = rc != 0;
648
649 // retrieve text and save it
650 // -------------------------
651 int nLines = m_pTextCtrl->GetNumberOfLines();
652 for ( int nLine = 0; bOk && nLine < nLines; nLine++ ) {
653 bOk = file.Write(m_pTextCtrl->GetLineText(nLine) +
654 wxTextFile::GetEOL());
655 }
656
657 if ( bOk )
658 bOk = file.Close();
659
660 if ( !bOk ) {
661 wxLogError(_("Can't save log contents to file."));
662 }
663 else {
664 wxLogStatus((wxFrame*)this, _("Log saved to the file '%s'."), filename.c_str());
665 }
666}
667#endif // CAN_SAVE_FILES
668
669void wxLogFrame::OnClear(wxCommandEvent& WXUNUSED(event))
670{
671 m_pTextCtrl->Clear();
672}
673
674void wxLogFrame::OnInternalIdle()
675{
676 {
677 wxCRIT_SECT_LOCKER(locker, m_critSection);
678
679 const size_t count = m_pendingMessages.size();
680 for ( size_t n = 0; n < count; n++ )
681 {
682 DoShowLogMessage(m_pendingMessages[n]);
683 }
684
685 m_pendingMessages.clear();
686 } // release m_critSection
687
688 wxFrame::OnInternalIdle();
689}
690
691void wxLogFrame::AddLogMessage(const wxString& message)
692{
693 wxCRIT_SECT_LOCKER(locker, m_critSection);
694
695#if wxUSE_THREADS
696 if ( !wxThread::IsMain() || !m_pendingMessages.empty() )
697 {
698 // message needs to be queued for later showing
699 m_pendingMessages.Add(message);
700
701 wxWakeUpIdle();
702 }
703 else // we are the main thread and no messages are queued, so we can
704 // log the message directly
705#endif // wxUSE_THREADS
706 {
707 DoShowLogMessage(message);
708 }
709}
710
711wxLogFrame::~wxLogFrame()
712{
713 m_log->OnFrameDelete(this);
714}
715
716// wxLogWindow
717// -----------
718
719wxLogWindow::wxLogWindow(wxWindow *pParent,
720 const wxString& szTitle,
721 bool bShow,
722 bool bDoPass)
723{
724 PassMessages(bDoPass);
725
726 m_pLogFrame = new wxLogFrame(pParent, this, szTitle);
727
728 if ( bShow )
729 m_pLogFrame->Show();
730}
731
732void wxLogWindow::Show(bool bShow)
733{
734 m_pLogFrame->Show(bShow);
735}
736
737void wxLogWindow::DoLog(wxLogLevel level, const wxString& szString, time_t t)
738{
739 // first let the previous logger show it
740 wxLogPassThrough::DoLog(level, szString, t);
741
742 if ( m_pLogFrame ) {
743 switch ( level ) {
744 case wxLOG_Status:
745 // by default, these messages are ignored by wxLog, so process
746 // them ourselves
747 if ( !szString.empty() )
748 {
749 wxString str;
750 str << _("Status: ") << szString;
751 LogString(str, t);
752 }
753 break;
754
755 // don't put trace messages in the text window for 2 reasons:
756 // 1) there are too many of them
757 // 2) they may provoke other trace messages thus sending a program
758 // into an infinite loop
759 case wxLOG_Trace:
760 break;
761
762 default:
763 // and this will format it nicely and call our DoLogString()
764 wxLog::DoLog(level, szString, t);
765 }
766 }
767}
768
769void wxLogWindow::DoLogString(const wxString& szString, time_t WXUNUSED(t))
770{
771 wxString msg;
772
773 TimeStamp(&msg);
774 msg << szString << wxT('\n');
775
776 m_pLogFrame->AddLogMessage(msg);
777}
778
779wxFrame *wxLogWindow::GetFrame() const
780{
781 return m_pLogFrame;
782}
783
784void wxLogWindow::OnFrameCreate(wxFrame * WXUNUSED(frame))
785{
786}
787
788bool wxLogWindow::OnFrameClose(wxFrame * WXUNUSED(frame))
789{
790 // allow to close
791 return true;
792}
793
794void wxLogWindow::OnFrameDelete(wxFrame * WXUNUSED(frame))
795{
796 m_pLogFrame = (wxLogFrame *)NULL;
797}
798
799wxLogWindow::~wxLogWindow()
800{
801 // may be NULL if log frame already auto destroyed itself
802 delete m_pLogFrame;
803}
804
805#endif // wxUSE_LOGWINDOW
806
807// ----------------------------------------------------------------------------
808// wxLogDialog
809// ----------------------------------------------------------------------------
810
811#if wxUSE_LOG_DIALOG
812
813wxString wxLogDialog::ms_details;
814size_t wxLogDialog::ms_maxLength = 0;
815
816wxLogDialog::wxLogDialog(wxWindow *parent,
817 const wxArrayString& messages,
818 const wxArrayInt& severity,
819 const wxArrayLong& times,
820 const wxString& caption,
821 long style)
822 : wxDialog(parent, wxID_ANY, caption,
823 wxDefaultPosition, wxDefaultSize,
824 wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER)
825{
826 // init the static variables:
827
828 if ( ms_details.empty() )
829 {
830 // ensure that we won't loop here if wxGetTranslation()
831 // happens to pop up a Log message while translating this :-)
832 ms_details = wxTRANSLATE("&Details");
833 ms_details = wxGetTranslation(ms_details);
834#ifdef __SMARTPHONE__
835 ms_details = wxStripMenuCodes(ms_details);
836#endif
837 }
838
839 if ( ms_maxLength == 0 )
840 {
841 ms_maxLength = (2 * wxGetDisplaySize().x/3) / GetCharWidth();
842 }
843
844 size_t count = messages.GetCount();
845 m_messages.Alloc(count);
846 m_severity.Alloc(count);
847 m_times.Alloc(count);
848
849 for ( size_t n = 0; n < count; n++ )
850 {
851 m_messages.Add(messages[n]);
852 m_severity.Add(severity[n]);
853 m_times.Add(times[n]);
854 }
855
856 m_listctrl = NULL;
857
858 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
859
860 // create the controls which are always shown and layout them: we use
861 // sizers even though our window is not resizeable to calculate the size of
862 // the dialog properly
863 wxBoxSizer *sizerTop = new wxBoxSizer(wxVERTICAL);
864 wxBoxSizer *sizerAll = new wxBoxSizer(isPda ? wxVERTICAL : wxHORIZONTAL);
865
866 if (!isPda)
867 {
868 wxStaticBitmap *icon = new wxStaticBitmap
869 (
870 this,
871 wxID_ANY,
872 wxArtProvider::GetMessageBoxIcon(style)
873 );
874 sizerAll->Add(icon, wxSizerFlags().Centre());
875 }
876
877 // create the text sizer with a minimal size so that we are sure it won't be too small
878 wxString message = EllipsizeString(messages.Last());
879 wxSizer *szText = CreateTextSizer(message);
880 szText->SetMinSize(wxMin(300, wxGetDisplaySize().x / 3), -1);
881
882 sizerAll->Add(szText, wxSizerFlags(1).Centre().Border(wxLEFT | wxRIGHT));
883
884 wxButton *btnOk = new wxButton(this, wxID_OK);
885 sizerAll->Add(btnOk, wxSizerFlags().Centre());
886
887 sizerTop->Add(sizerAll, wxSizerFlags().Expand().Border());
888
889
890 // add the details pane
891#ifndef __SMARTPHONE__
892 wxCollapsiblePane * const
893 collpane = new wxCollapsiblePane(this, wxID_ANY, ms_details);
894 sizerTop->Add(collpane, wxSizerFlags(1).Expand().Border());
895
896 wxWindow *win = collpane->GetPane();
897 wxSizer * const paneSz = new wxBoxSizer(wxVERTICAL);
898
899 CreateDetailsControls(win);
900
901 paneSz->Add(m_listctrl, wxSizerFlags(1).Expand().Border(wxTOP));
902
903#if wxUSE_CLIPBOARD || CAN_SAVE_FILES
904 wxBoxSizer * const btnSizer = new wxBoxSizer(wxHORIZONTAL);
905
906 wxSizerFlags flagsBtn;
907 flagsBtn.Border(wxLEFT);
908
909#if wxUSE_CLIPBOARD
910 btnSizer->Add(new wxButton(win, wxID_COPY), flagsBtn);
911#endif // wxUSE_CLIPBOARD
912
913#if CAN_SAVE_FILES
914 btnSizer->Add(new wxButton(win, wxID_SAVE), flagsBtn);
915#endif // CAN_SAVE_FILES
916
917 paneSz->Add(btnSizer, wxSizerFlags().Right().Border(wxTOP));
918#endif // wxUSE_CLIPBOARD || CAN_SAVE_FILES
919
920 win->SetSizer(paneSz);
921 paneSz->SetSizeHints(win);
922#else // __SMARTPHONE__
923 SetLeftMenu(wxID_OK);
924 SetRightMenu(wxID_MORE, ms_details + EXPAND_SUFFIX);
925#endif // __SMARTPHONE__/!__SMARTPHONE__
926
927 SetSizerAndFit(sizerTop);
928
929 Centre();
930
931 if (isPda)
932 {
933 // Move up the screen so that when we expand the dialog,
934 // there's enough space.
935 Move(wxPoint(GetPosition().x, GetPosition().y / 2));
936 }
937}
938
939void wxLogDialog::CreateDetailsControls(wxWindow *parent)
940{
941 // create the list ctrl now
942 m_listctrl = new wxListCtrl(parent, wxID_ANY,
943 wxDefaultPosition, wxDefaultSize,
944 wxSUNKEN_BORDER |
945 wxLC_REPORT |
946 wxLC_NO_HEADER |
947 wxLC_SINGLE_SEL);
948#ifdef __WXWINCE__
949 // This makes a big aesthetic difference on WinCE but I
950 // don't want to risk problems on other platforms
951 m_listctrl->Hide();
952#endif
953
954 // no need to translate these strings as they're not shown to the
955 // user anyhow (we use wxLC_NO_HEADER style)
956 m_listctrl->InsertColumn(0, _T("Message"));
957 m_listctrl->InsertColumn(1, _T("Time"));
958
959 // prepare the imagelist
960 static const int ICON_SIZE = 16;
961 wxImageList *imageList = new wxImageList(ICON_SIZE, ICON_SIZE);
962
963 // order should be the same as in the switch below!
964 static const wxChar* icons[] =
965 {
966 wxART_ERROR,
967 wxART_WARNING,
968 wxART_INFORMATION
969 };
970
971 bool loadedIcons = true;
972
973 for ( size_t icon = 0; icon < WXSIZEOF(icons); icon++ )
974 {
975 wxBitmap bmp = wxArtProvider::GetBitmap(icons[icon], wxART_MESSAGE_BOX,
976 wxSize(ICON_SIZE, ICON_SIZE));
977
978 // This may very well fail if there are insufficient colours available.
979 // Degrade gracefully.
980 if ( !bmp.Ok() )
981 {
982 loadedIcons = false;
983
984 break;
985 }
986
987 imageList->Add(bmp);
988 }
989
990 m_listctrl->SetImageList(imageList, wxIMAGE_LIST_SMALL);
991
992 // and fill it
993 wxString fmt = wxLog::GetTimestamp();
994 if ( !fmt )
995 {
996 // default format
997 fmt = _T("%c");
998 }
999
1000 size_t count = m_messages.GetCount();
1001 for ( size_t n = 0; n < count; n++ )
1002 {
1003 int image;
1004
1005 if ( loadedIcons )
1006 {
1007 switch ( m_severity[n] )
1008 {
1009 case wxLOG_Error:
1010 image = 0;
1011 break;
1012
1013 case wxLOG_Warning:
1014 image = 1;
1015 break;
1016
1017 default:
1018 image = 2;
1019 }
1020 }
1021 else // failed to load images
1022 {
1023 image = -1;
1024 }
1025
1026 wxString msg = m_messages[n];
1027 msg.Replace(wxT("\n"), wxT(" "));
1028 msg = EllipsizeString(msg);
1029
1030 m_listctrl->InsertItem(n, msg, image);
1031 m_listctrl->SetItem(n, 1, TimeStamp(fmt, (time_t)m_times[n]));
1032 }
1033
1034 // let the columns size themselves
1035 m_listctrl->SetColumnWidth(0, wxLIST_AUTOSIZE);
1036 m_listctrl->SetColumnWidth(1, wxLIST_AUTOSIZE);
1037
1038 // calculate an approximately nice height for the listctrl
1039 int height = GetCharHeight()*(count + 4);
1040
1041 // but check that the dialog won't fall fown from the screen
1042 //
1043 // we use GetMinHeight() to get the height of the dialog part without the
1044 // details and we consider that the "Save" button below and the separator
1045 // line (and the margins around it) take about as much, hence double it
1046 int heightMax = wxGetDisplaySize().y - GetPosition().y - 2*GetMinHeight();
1047
1048 // we should leave a margin
1049 heightMax *= 9;
1050 heightMax /= 10;
1051
1052 m_listctrl->SetSize(wxDefaultCoord, wxMin(height, heightMax));
1053}
1054
1055void wxLogDialog::OnListSelect(wxListEvent& event)
1056{
1057 // we can't just disable the control because this looks ugly under Windows
1058 // (wrong bg colour, no scrolling...), but we still want to disable
1059 // selecting items - it makes no sense here
1060 m_listctrl->SetItemState(event.GetIndex(), 0, wxLIST_STATE_SELECTED);
1061}
1062
1063void wxLogDialog::OnListItemActivated(wxListEvent& event)
1064{
1065 // show the activated item in a message box
1066 // This allow the user to correctly display the logs which are longer
1067 // than the listctrl and thus gets truncated or those which contains
1068 // newlines.
1069
1070 // NB: don't do:
1071 // wxString str = m_listctrl->GetItemText(event.GetIndex());
1072 // as there's a 260 chars limit on the items inside a wxListCtrl in wxMSW.
1073 wxString str = m_messages[event.GetIndex()];
1074
1075 // wxMessageBox will nicely handle the '\n' in the string (if any)
1076 // and supports long strings
1077 wxMessageBox(str, wxT("Log message"), wxOK, this);
1078}
1079
1080void wxLogDialog::OnOk(wxCommandEvent& WXUNUSED(event))
1081{
1082 EndModal(wxID_OK);
1083}
1084
1085#if CAN_SAVE_FILES || wxUSE_CLIPBOARD
1086
1087wxString wxLogDialog::GetLogMessages() const
1088{
1089 wxString fmt = wxLog::GetTimestamp();
1090 if ( fmt.empty() )
1091 {
1092 // use the default format
1093 fmt = "%c";
1094 }
1095
1096 const size_t count = m_messages.GetCount();
1097
1098 wxString text;
1099 text.reserve(count*m_messages[0].length());
1100 for ( size_t n = 0; n < count; n++ )
1101 {
1102 text << TimeStamp(fmt, (time_t)m_times[n])
1103 << ": "
1104 << m_messages[n]
1105 << wxTextFile::GetEOL();
1106 }
1107
1108 return text;
1109}
1110
1111#endif // CAN_SAVE_FILES || wxUSE_CLIPBOARD
1112
1113#if wxUSE_CLIPBOARD
1114
1115void wxLogDialog::OnCopy(wxCommandEvent& WXUNUSED(event))
1116{
1117 wxClipboardLocker clip;
1118 if ( !clip ||
1119 !wxTheClipboard->AddData(new wxTextDataObject(GetLogMessages())) )
1120 {
1121 wxLogError(_("Failed to copy dialog contents to the clipboard."));
1122 }
1123}
1124
1125#endif // wxUSE_CLIPBOARD
1126
1127#if CAN_SAVE_FILES
1128
1129void wxLogDialog::OnSave(wxCommandEvent& WXUNUSED(event))
1130{
1131 wxFile file;
1132 int rc = OpenLogFile(file, NULL, this);
1133 if ( rc == -1 )
1134 {
1135 // cancelled
1136 return;
1137 }
1138
1139 if ( !rc || !file.Write(GetLogMessages()) || !file.Close() )
1140 wxLogError(_("Can't save log contents to file."));
1141}
1142
1143#endif // CAN_SAVE_FILES
1144
1145wxLogDialog::~wxLogDialog()
1146{
1147 if ( m_listctrl )
1148 {
1149 delete m_listctrl->GetImageList(wxIMAGE_LIST_SMALL);
1150 }
1151}
1152
1153#endif // wxUSE_LOG_DIALOG
1154
1155#if CAN_SAVE_FILES
1156
1157// pass an uninitialized file object, the function will ask the user for the
1158// filename and try to open it, returns true on success (file was opened),
1159// false if file couldn't be opened/created and -1 if the file selection
1160// dialog was cancelled
1161static int OpenLogFile(wxFile& file, wxString *pFilename, wxWindow *parent)
1162{
1163 // get the file name
1164 // -----------------
1165 wxString filename = wxSaveFileSelector(wxT("log"), wxT("txt"), wxT("log.txt"), parent);
1166 if ( !filename ) {
1167 // cancelled
1168 return -1;
1169 }
1170
1171 // open file
1172 // ---------
1173 bool bOk = false;
1174 if ( wxFile::Exists(filename) ) {
1175 bool bAppend = false;
1176 wxString strMsg;
1177 strMsg.Printf(_("Append log to file '%s' (choosing [No] will overwrite it)?"),
1178 filename.c_str());
1179 switch ( wxMessageBox(strMsg, _("Question"),
1180 wxICON_QUESTION | wxYES_NO | wxCANCEL) ) {
1181 case wxYES:
1182 bAppend = true;
1183 break;
1184
1185 case wxNO:
1186 bAppend = false;
1187 break;
1188
1189 case wxCANCEL:
1190 return -1;
1191
1192 default:
1193 wxFAIL_MSG(_("invalid message box return value"));
1194 }
1195
1196 if ( bAppend ) {
1197 bOk = file.Open(filename, wxFile::write_append);
1198 }
1199 else {
1200 bOk = file.Create(filename, true /* overwrite */);
1201 }
1202 }
1203 else {
1204 bOk = file.Create(filename);
1205 }
1206
1207 if ( pFilename )
1208 *pFilename = filename;
1209
1210 return bOk;
1211}
1212
1213#endif // CAN_SAVE_FILES
1214
1215#endif // !(wxUSE_LOGGUI || wxUSE_LOGWINDOW)
1216
1217#if wxUSE_LOG && wxUSE_TEXTCTRL
1218
1219// ----------------------------------------------------------------------------
1220// wxLogTextCtrl implementation
1221// ----------------------------------------------------------------------------
1222
1223wxLogTextCtrl::wxLogTextCtrl(wxTextCtrl *pTextCtrl)
1224{
1225 m_pTextCtrl = pTextCtrl;
1226}
1227
1228void wxLogTextCtrl::DoLogString(const wxString& szString, time_t WXUNUSED(t))
1229{
1230 wxString msg;
1231 TimeStamp(&msg);
1232
1233 msg << szString << wxT('\n');
1234 m_pTextCtrl->AppendText(msg);
1235}
1236
1237#endif // wxUSE_LOG && wxUSE_TEXTCTRL