Debug Console Window

public void Init(bool UseDebugOutput, bool UseCrForWriteLine, string Caption){

  DebugForm.Text=Caption;

  Init (UseDebugOutput, UseCrForWriteLine);

}

// DEBUG CONSOLE EXAMPLE v1.11
// Code by Kvin Drapel - 2002
// http://www.calodox.org
//
// Thanks to Richard D for the TraceListener idea
//
// Do what you want with this source.
//


//You must have TRACE defined to enable Tracing
#define TRACE

//Defined to allow conditional inclusion depending on availablilty of this file
#if (!(TRACELISTENER))
#define TRACELISTENER
#endif

namespace PDE.Debug
{
	using System;
	using System.Drawing;
	using System.Collections;
	using System.ComponentModel;
	using System.Windows.Forms;
	using System.IO;
	using System.Text;
	using System.Diagnostics;

	
	/// 
Implementation of Debug Console

	/// 	
	/// 
	/// Implemented as Singleton
	/// 	
	/// 
	/// Authors
	/// 	
	/// 
	/// 
	/// 	
	/// 
	/// Edited by
	/// Paul Evans
	/// 
	/// 
	/// 
	/// Edited by
	/// Richard D 
	/// 
	/// 
	/// 
	/// Created by
	/// Kvin Drapel
	/// 
	/// 
	/// 
	/// 
	/// 


	/// 	
	///   Version history of this file 
	/// 
	/// 
	/// 
	/// 
	///  14May03 - PDE 
	/// 
	/// Editing, commenting, etc
	/// 
	/// 
	/// 
	/// 
	/// 

 	
	/// 
	/// 		
	sealed class DebugConsole : TraceListener
	{
		///

		/// Singleton implementation - only entry point outside class
		///

		public static readonly DebugConsole Instance = 	new DebugConsole();


		///

		/// Initialise the debug form variable
		///

		private DebugConsoleWrapper DebugForm = new DebugConsoleWrapper();
		
		 
		///

		/// If this parameter is set to true, a call to WriteLine will always create a new row
		/// (if false, it may be appended to the current buffer created with some Write calls).
		/// Set by call to Init.
		///

		private bool UseCrWl = true;
		
		
		///
Set if init'ed

		private bool m_bInit = false;


		///

		/// Constructor private to keep with Singleton pattern
		///

		private DebugConsole() 
		{
			//PDE 14May03 - Moved to Init so constructor is more lightweight
			//DebugForm.Show();
		}


		///

		/// Initalise the DebugConsole.
		///

		///Added to Debug.Listeners if true, Trace.Listeners if false.
		///If this parameter is set to true, a call to WriteLine will always create a new row
		/// (if false, it may be appended to the current buffer created with some Write calls).
		/// 
		public void Init(bool UseDebugOutput, bool UseCrForWriteLine)
		{
			if (UseDebugOutput==true)
				Debug.Listeners.Add(this);
			else
				Trace.Listeners.Add(this);

			this.UseCrWl = UseCrForWriteLine;
			
			DebugForm.Show();
			
			this.m_bInit=true;
			
			Trace.WriteLine("--- DEBUG CONSOLE LOG INITIALISED ---");			
		}
		
		
		///

		/// Initalise the DebugConsole.
		///

		/// 
		/// 
		/// UseCrForWriteLine is set to true in this version.
		/// 
		/// 
		///Added to Debug.Listeners if true, Trace.Listeners if false.		
		/// (if false, it may be appended to the current buffer created with some Write calls).
		/// 
		public void Init(bool UseDebugOutput)
		{
			Init(UseDebugOutput, true);
		}
		
		
		///

		/// Constructor private to keep with Singleton pattern
		///

		/// 
		/// 
		/// UseCrForWriteLine is set to true in this version.
		/// 
		/// 
		/// UseDebugOutput determined using compiler macro testing for DEBUG being defined.
		/// 
		/// 		
		public void Init()
		{
			#if (DEBUG)
				// debug mode (Debug)
				Init(true,true);
				Trace.WriteLine("--- (Initialised using defaults (Debug mode, writing new lines) ---");
			#else
				// release mode (Trace)
				Init(false,true);
				Trace.WriteLine("--- (Initialised using defaults (Trace mode, writing new lines) ---");
			#endif						
		}


		///

		/// Append message to debug buffer without performing a new line.
		///

		///Message to display
		override public void Write(string message) 
		{   
			//PDE: Check to ensure everything is initalised first
			if (!m_bInit)
			{
				Init();
			}
			
			DebugForm.Buffer.Append(message);
			DebugForm.UpdateCurrentRow(false);
		}


		///

		/// Append message to debug buffer and perform a new line.
		///

		/// 
		/// 
		/// TODO: PDE: Check through buffer update strategy and optimise where appropriate
		/// 
		/// 
		///Message to display
		override public void WriteLine(string message) 
		{   
			//PDE: Check to ensure everything is initalised first
			if (!m_bInit)
			{
				Init();
			}

			if (this.UseCrWl==true) 
			{
				DebugForm.CreateEventRow();
				DebugForm.Buffer=new StringBuilder();
			}

			DebugForm.Buffer.Append(message); 
			DebugForm.UpdateCurrentRow(true);
			
			//-----
			//PDE: Added length = 0 instead of creating a new StringBuilder to keep memory wastage down...
			DebugForm.Buffer.Length = 0;
			//DebugForm.Buffer = new StringBuilder(); 
			//-----
		}
		
		
		
		/// 

		/// Implementation of Debug Console Form (Window). 
		/// 
		
		/// 	
		/// 
		/// PDE 14May03 - Moved inside class.
		/// 	
		/// 
		/// Authors
		/// 	
		/// 
		/// 
		/// 	
		/// 
		/// Edited by
		/// Paul Evans
		/// 
		/// 			
		/// 
		/// Created by
		/// Kvin Drapel
		/// 
		/// 
		/// 
		/// 
		/// 


		/// 	
		///   Version history of this file 
		/// 
		/// 
		/// 
		/// 
		///  14May03 - PDE 
		/// 
		/// Editing, commenting, etc
		/// 
		/// 
		/// 
		/// 
		/// 

 	
		/// 
		/// 		
		private class DebugConsoleWrapper : System.Windows.Forms.Form
		{
			private System.Windows.Forms.Button BtnSave;
			private System.Windows.Forms.Button BtnClear;
			private System.Windows.Forms.SaveFileDialog SaveFileDlg;
			private System.Windows.Forms.CheckBox CheckScroll;
			private System.Diagnostics.DefaultTraceListener Tracer = new System.Diagnostics.DefaultTraceListener();
			private System.Windows.Forms.ColumnHeader Col1;
			private System.Windows.Forms.ColumnHeader Col2;
			private System.Windows.Forms.ListView OutputView;
			private System.Windows.Forms.CheckBox CheckTop;
			private System.Windows.Forms.Panel panel2;
			private System.Windows.Forms.ColumnHeader Col3;
			private ListViewItem.ListViewSubItem CurrentMsgItem = null;
			private int EventCounter=0;
			public StringBuilder Buffer = new StringBuilder();
	
			/// 

			/// Required designer variable.
			/// 

			/// 
			private System.ComponentModel.Container components = null;
			
			
			/// 

			/// Initalise components on construction
			/// 

			public DebugConsoleWrapper()
			{
				InitializeComponent();
			}
			
	
			/// 

			/// Clean up any resources being used.
			/// 

			protected override void Dispose( bool disposing )
			{
				if( disposing )
				{
					if(components != null)
					{
						components.Dispose();
					}
				}
				base.Dispose( disposing );
			}
			
	
			#region Windows Form Designer generated code
			/// 

			/// Required method for Designer support - do not modify
			/// the contents of this method with the code editor.
			/// 

			private void InitializeComponent()
			{
				this.BtnSave = new System.Windows.Forms.Button();
				this.BtnClear = new System.Windows.Forms.Button();
				this.SaveFileDlg = new System.Windows.Forms.SaveFileDialog();
				this.CheckScroll = new System.Windows.Forms.CheckBox();
				this.OutputView = new System.Windows.Forms.ListView();
				this.Col1 = new System.Windows.Forms.ColumnHeader();
				this.Col2 = new System.Windows.Forms.ColumnHeader();
				this.Col3 = new System.Windows.Forms.ColumnHeader();
				this.CheckTop = new System.Windows.Forms.CheckBox();
				this.panel2 = new System.Windows.Forms.Panel();
				this.panel2.SuspendLayout();
				this.SuspendLayout();
								
				// 
				// BtnSave
				// 
				this.BtnSave.Location = new System.Drawing.Point(8, 16);
				this.BtnSave.Name = "BtnSave";
				this.BtnSave.Size = new System.Drawing.Size(64, 24);
				this.BtnSave.TabIndex = 8;
				this.BtnSave.Text = "Save";
				this.BtnSave.Click += new System.EventHandler(this.BtnSave_Click);
				// 
				// BtnClear
				// 
				this.BtnClear.Location = new System.Drawing.Point(80, 16);
				this.BtnClear.Name = "BtnClear";
				this.BtnClear.Size = new System.Drawing.Size(64, 24);
				this.BtnClear.TabIndex = 8;
				this.BtnClear.Text = "Clear";
				this.BtnClear.Click += new System.EventHandler(this.BtnClear_Click);
				// 
				// CheckScroll
				// 
				this.CheckScroll.Checked = true;
				this.CheckScroll.CheckState = System.Windows.Forms.CheckState.Checked;
				this.CheckScroll.Location = new System.Drawing.Point(152, 16);
				this.CheckScroll.Name = "CheckScroll";
				this.CheckScroll.Size = new System.Drawing.Size(80, 16);
				this.CheckScroll.TabIndex = 8;
				this.CheckScroll.Text = "autoscroll";
				this.CheckScroll.CheckedChanged += new System.EventHandler(this.CheckScroll_CheckedChanged);
				// 
				// OutputView
				// 
				this.OutputView.AutoArrange = false;
				this.OutputView.BackColor = System.Drawing.Color.MediumAquamarine;
				this.OutputView.Columns.AddRange(new System.Windows.Forms.ColumnHeader[] {
																							 this.Col1,
																							 this.Col2,
																							 this.Col3});
				this.OutputView.Dock = System.Windows.Forms.DockStyle.Fill;
				this.OutputView.Font = new System.Drawing.Font("Courier New", 8.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((System.Byte)(0)));
				this.OutputView.ForeColor = System.Drawing.Color.Black;
				this.OutputView.Name = "OutputView";
				this.OutputView.Size = new System.Drawing.Size(400, 200);
				this.OutputView.TabIndex = 7;
				this.OutputView.View = System.Windows.Forms.View.Details;
				// 
				// Col1
				// 
				this.Col1.Text = "#";
				this.Col1.Width = 40;
				//this.Col1.Width = 30;
				// 
				// Col2
				// 
				this.Col2.Text = "Time";
				this.Col2.Width = 100;
				//this.Col2.Width = 70;
				// 
				// Col3
				// 
				this.Col3.Text = "Message";
				this.Col3.Width = 400;
				//this.Col3.Width = 270;
				// 
				// CheckTop
				// 
				this.CheckTop.Location = new System.Drawing.Point(240, 16);
				this.CheckTop.Name = "CheckTop";
				this.CheckTop.Size = new System.Drawing.Size(96, 16);
				this.CheckTop.TabIndex = 8;
				this.CheckTop.Text = "always on top";
				this.CheckTop.CheckedChanged += new System.EventHandler(this.CheckTop_CheckedChanged);
				// 
				// panel2
				// 
				this.panel2.Controls.AddRange(new System.Windows.Forms.Control[] {
																					 this.BtnSave,
																					 this.BtnClear,
																					 this.CheckScroll,
																					 this.CheckTop});
				this.panel2.Dock = System.Windows.Forms.DockStyle.Bottom;
				this.panel2.Location = new System.Drawing.Point(0, 200);
				this.panel2.Name = "panel2";
				this.panel2.Size = new System.Drawing.Size(400, 48);
				this.panel2.TabIndex = 8;
				// 
				// DebugConsoleWrapper
				// 
				this.AutoScaleBaseSize = new System.Drawing.Size(5, 13);
				this.ClientSize = new System.Drawing.Size(400, 248);
				this.Controls.AddRange(new System.Windows.Forms.Control[] {
																			  this.OutputView,
																			  this.panel2});
				this.FormBorderStyle = System.Windows.Forms.FormBorderStyle.SizableToolWindow;
				//this.MinimumSize = new System.Drawing.Size(390, 160);
				this.MinimumSize = new System.Drawing.Size(450, 160);
				this.Name = "DebugConsoleWrapper";
				this.StartPosition = System.Windows.Forms.FormStartPosition.Manual;
				this.Text = "Debug Console";
				
				
				this.panel2.ResumeLayout(false);
				this.ResumeLayout(false);
	
			}
			#endregion
	
	
			
			/// 

			/// Creates a new list view item to display the event from Write / WriteLine.
			/// 

			public void CreateEventRow()
			{
				DateTime d=DateTime.Now;
	
				// create a ListView item/subitems : [event nb] - [time] - [empty string]
				string msg1 = (++EventCounter).ToString();
				string msg2 = d.ToLongTimeString();
				ListViewItem elem = new ListViewItem(msg1);
				elem.SubItems.Add(msg2);
				elem.SubItems.Add("");
				this.OutputView.Items.Add(elem);
	
				// we save the message item for incoming text updates
				CurrentMsgItem=elem.SubItems[2];
			}
	
	
			/// 

			/// Copies the debug buffer into the current list view item.  
			/// 

			/// Cause creation of new line creation on next call to Write / WriteLine.
			public void UpdateCurrentRow(bool CreateRowNextTime)
			{
				if (CurrentMsgItem==null) CreateEventRow();
				//PDE: Copy current buffer into the current listview item (which will have already been added to the list view)
				CurrentMsgItem.Text=Buffer.ToString();
	
				// if null, a new row will be created next time this function is called
				//PDE: As there is a reference to this object in the ListView control, this nullification is safe.
				if (CreateRowNextTime==true) CurrentMsgItem=null;
	
				// this is the autoscroll, move to the last element available in the ListView
				if (this.CheckScroll.CheckState == CheckState.Checked)
				{
					this.OutputView.EnsureVisible(this.OutputView.Items.Count-1);
				}
			}
			
			
			/// 

			/// Offer option to save file on click
			/// 

			/// Object generating event.
			/// Arguments generated by event.
			private void BtnSave_Click(object sender, System.EventArgs e)
			{
				this.SaveFileDlg.Filter="Text file (*.txt)|*.txt|All files (*.*)|*.*" ;
				this.SaveFileDlg.FileName="log.txt";
				this.SaveFileDlg.ShowDialog();
	
				FileInfo  fileInfo = new FileInfo(SaveFileDlg.FileName);
	
				// create a new textfile and export all lines
				StreamWriter s = fileInfo.CreateText();
				for (int i=0;i				{
					StringBuilder sb=new StringBuilder();
					sb.Append(this.OutputView.Items[i].SubItems[0].Text);
					sb.Append("\t");
					sb.Append(this.OutputView.Items[i].SubItems[1].Text);
					sb.Append("\t");
					sb.Append(this.OutputView.Items[i].SubItems[2].Text);
					s.WriteLine(sb.ToString());
				}
	
				s.Close();
			}
	
	
			/// 

			/// Clear contents on click
			/// 

			/// Object generating event.
			/// Arguments generated by event.
			private void BtnClear_Click(object sender, System.EventArgs e)
			{
				//-----
				//PDE: Changed order of below block slightly, and set StringBuilder Length to 0 rather then expense of creating new instance
				this.EventCounter=0;
				this.CurrentMsgItem=null;
				this.OutputView.Items.Clear();				
				//this.Buffer = new StringBuilder();
				this.Buffer.Length = 0;
				//-----
			}
	
	
			/// 

			/// Always ontop checkbox status change
			/// 

			/// Object generating event.
			/// Arguments generated by event.
			private void CheckTop_CheckedChanged(object sender, System.EventArgs e)
			{
				if (this.CheckTop.CheckState == CheckState.Checked) 
					this.TopMost = true;
				else
					this.TopMost = false;
			}
	
	
			/// 

			/// Scroll visible checkbox status change
			/// 

			/// Object generating event.
			/// Arguments generated by event.
			private void CheckScroll_CheckedChanged(object sender, System.EventArgs e)
			{
				if (this.CheckScroll.CheckState == CheckState.Checked)
					this.OutputView.EnsureVisible(this.OutputView.Items.Count-1);
			}
	
		}
	}	
}
 

/**********************************
Paul Evans, Dorset, UK.
Personal Homepage "EnjoySoftware" @ 
http://www.enjoysoftware.co.uk/
**********************************/

using System.Diagnostics;
using System.Text;
...
sealed class DebugConsole : TraceListener
{
    private static readonly DebugConsole Instance;

    static DebugConsole() {
        Instance = new DebugConsole();
        Trace.Listeners.Add(Instance);
        Debug.Listeners.Add(Instance);
    }

    private DebugConsoleWrapper DebugForm = new DebugConsoleWrapper();
    private StringBuilder Buffer = new StringBuilder();

    private DebugConsole() {
        DebugForm.Show();
    }

    public void Write(string message) {
        Buffer.Append(message);
    }

    public void WriteLine(string message) {
        if (Buffer.Length == 0)
            DebugForm.WriteLine(message);
        else {
            Buffer.Append(message);
            DebugForm.WriteLine(Buffer.ToString());
            Buffer = new StringBuilder();
        }
    }

    //Add other overrides, e.g.
    //    Write(string message, string category)
    //    WriteLine(string message, string category)
    //    Write(object o)
    //    WriteLine(object o)
    //    Write(object o, string category)
    //    WriteLine(object o, string category)
    //    Fail(string message)
    //    Fail(string message, string detailMessage)
}

using System;
...
using System.Diagnostics;

namespace DebugConsoleSample 
{
    public class Form1 : System.Windows.Forms.Form
    {
        ...

        [STAThread]
        static void Main() 
        {
            Debug.WriteLine("Function call : Application.Run(new Form1())");
            Application.Run(new Form1());
        }

        // let's handle some events and send messages to the console
        private void textBox1_TextChanged(object sender, System.EventArgs e)
        {
            Debug.WriteLine("Event : textBox1_TextChanged ");
        }

        private void button1_Click(object sender, System.EventArgs e)
        {
            Debug.WriteLine("Event : button1_Click - textBox1 string :  " 
                + textBox1.Text.ToString());

            Debug.WriteLine("Start a loop...");

            for (int i=0;i<5;i++) 
                Debug.WriteLine("Loop counter : " + i.ToString());
        }

        private void trackBar1_Scroll(object sender, System.EventArgs e)
        {
            Debug.WriteLine("Event : trackBar1_Scroll : " 
                + trackBar1.Value.ToString());
        }
    }
}