//#########################################################################################
//★★★★★★★              http://www.cnpopsoft.com [华普软件]            ★★★★★★★
//★★★★★★★           华普软件 - VB & C#.NET 专业论文与源码荟萃！       ★★★★★★★
//#########################################################################################

/*
 * Copyright ?2005, Mathew Hall
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, 
 * are permitted provided that the following conditions are met:
 *
 *    - Redistributions of source code must retain the above copyright notice, 
 *      this list of conditions and the following disclaimer.
 * 
 *    - Redistributions in binary form must reproduce the above copyright notice, 
 *      this list of conditions and the following disclaimer in the documentation 
 *      and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
 * IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY 
 * OF SUCH DAMAGE.
 */


using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

using XPTable.Models;
using XPTable.Themes;


namespace XPTable.Renderers
{
	/// <summary>
	/// Base class for Renderers
	/// </summary>
	public abstract class Renderer : IRenderer, IDisposable
	{
		#region Class Data

		/// <summary>
		/// A StringFormat object that specifies how the Renderers 
		/// contents are drawn
		/// </summary>
		private StringFormat stringFormat;

		/// <summary>
		/// The brush used to draw the Renderers background
		/// </summary>
		private SolidBrush backBrush;

		/// <summary>
		/// The brush used to draw the Renderers foreground
		/// </summary>
		private SolidBrush foreBrush;

		/// <summary>
		/// A Rectangle that specifies the size and location of the Renderer
		/// </summary>
		private Rectangle bounds;

		/// <summary>
		/// The Font of the text displayed by the Renderer
		/// </summary>
		private Font font;

		/// <summary>
		/// The width of a Cells border
		/// </summary>
		protected static int BorderWidth = 1;

		#endregion


		#region Constructor

		/// <summary>
		/// Initializes a new instance of the Renderer class with default settings
		/// </summary>
		protected Renderer()
		{
			this.bounds = Rectangle.Empty;
			this.font = null;
			
			this.stringFormat = new StringFormat();
			this.stringFormat.LineAlignment = StringAlignment.Center;
			this.stringFormat.Alignment = StringAlignment.Near;
			this.stringFormat.FormatFlags = StringFormatFlags.NoWrap;
			this.stringFormat.Trimming = StringTrimming.EllipsisCharacter;

			this.backBrush = new SolidBrush(Color.Transparent);
			this.foreBrush = new SolidBrush(Color.Black);
		}

		#endregion


		#region Methods

		/// <summary>
		/// Releases the unmanaged resources used by the Renderer and 
		/// optionally releases the managed resources
		/// </summary>
		public virtual void Dispose()
		{
			if (this.backBrush != null)
			{
				this.backBrush.Dispose();
				this.backBrush = null;
			}
				
			if (this.foreBrush != null)
			{
				this.foreBrush.Dispose();
				this.foreBrush = null;
			}
		}


		/// <summary>
		/// Sets the color of the brush used to draw the background
		/// </summary>
		/// <param name="color">The color of the brush</param>
		protected void SetBackBrushColor(Color color)
		{
			if (this.BackBrush.Color != color)
			{
				this.BackBrush.Color = color;
			}
		}


		/// <summary>
		/// Sets the color of the brush used to draw the foreground
		/// </summary>
		/// <param name="color">The color of the brush</param>
		protected void SetForeBrushColor(Color color)
		{
			if (this.ForeBrush.Color != color)
			{
				this.ForeBrush.Color = color;
			}
		}

		#endregion


		#region Properties

		/// <summary>
		/// Gets the rectangle that represents the client area of the Renderer
		/// </summary>
		[Browsable(false)]
		public abstract Rectangle ClientRectangle
		{
			get;
		}


		/// <summary>
		/// Gets or sets the size and location of the Renderer
		/// </summary>
		[Browsable(false)]
		public Rectangle Bounds
		{
			get
			{
				return this.bounds;
			}

			set
			{
				this.bounds = value;
			}
		}


		/// <summary>
		/// Gets or sets the font of the text displayed by the Renderer
		/// </summary>
		[Category("Appearance"),
		Description("The font used to draw the text")]
		public Font Font
		{
			get
			{
				return this.font;
			}

			set
			{
				if (value == null)
				{
					value = Control.DefaultFont;
				}
				
				if (this.font != value)
				{
					this.font = value;
				}
			}
		}

		
		/// <summary>
		/// Gets the brush used to draw the Renderers background
		/// </summary>
		protected SolidBrush BackBrush
		{
			get
			{
				return this.backBrush;
			}
		}


		/// <summary>
		/// Gets the brush used to draw the Renderers foreground
		/// </summary>
		protected SolidBrush ForeBrush
		{
			get
			{
				return this.foreBrush;
			}
		}


		/// <summary>
		/// Gets or sets the foreground Color of the Renderer
		/// </summary>
		[Category("Appearance"),
		Description("The foreground color used to display text and graphics")]
		public Color ForeColor
		{
			get
			{
				return this.ForeBrush.Color;
			}

			set
			{
				this.SetForeBrushColor(value);
			}
		}


		/// <summary>
		/// Gets or sets the background Color of the Renderer
		/// </summary>
		[Category("Appearance"),
		Description("The background color used to display text and graphics")]
		public Color BackColor
		{
			get
			{
				return this.BackBrush.Color;
			}

			set
			{
				this.SetBackBrushColor(value);
			}
		}


		/// <summary>
		/// Gets or sets a StringFormat object that specifies how the Renderers 
		/// contents are drawn
		/// </summary>
		protected StringFormat StringFormat
		{
			get
			{
				return this.stringFormat;
			}

			set
			{
				this.stringFormat = value;
			}
		}


		/// <summary>
		/// Gets or sets a StringTrimming enumeration that indicates how text that 
		/// is drawn by the Renderer is trimmed when it exceeds the edges of the 
		/// layout rectangle
		/// </summary>
		[Browsable(false)]
		public StringTrimming Trimming
		{
			get
			{
				return this.stringFormat.Trimming;
			}

			set
			{
				this.stringFormat.Trimming = value;
			}
		}


		/// <summary>
		/// Gets or sets how the Renderers contents are aligned horizontally
		/// </summary>
		[Browsable(false)]
		public ColumnAlignment Alignment
		{
			get
			{
				switch (this.stringFormat.Alignment)
				{
					case StringAlignment.Near:
						return ColumnAlignment.Left;
					
					case StringAlignment.Center:
						return ColumnAlignment.Center;

					case StringAlignment.Far:
						return ColumnAlignment.Right;
				}

				return ColumnAlignment.Left;
			}

			set
			{
				switch (value)
				{
					case ColumnAlignment.Left:
						this.stringFormat.Alignment = StringAlignment.Near;
						break;
					
					case ColumnAlignment.Center:
						this.stringFormat.Alignment = StringAlignment.Center;
						break;

					case ColumnAlignment.Right:
						this.stringFormat.Alignment = StringAlignment.Far;
						break;
				}
			}
		}


		/// <summary>
		/// Gets or sets how the Renderers contents are aligned vertically
		/// </summary>
		[Browsable(false)]
		public RowAlignment LineAlignment
		{
			get
			{
				switch (this.stringFormat.LineAlignment)
				{
					case StringAlignment.Near:
						return RowAlignment.Top;
					
					case StringAlignment.Center:
						return RowAlignment.Center;

					case StringAlignment.Far:
						return RowAlignment.Bottom;
				}

				return RowAlignment.Center;
			}

			set
			{
				switch (value)
				{
					case RowAlignment.Top:
						this.stringFormat.LineAlignment = StringAlignment.Near;
						break;
					
					case RowAlignment.Center:
						this.stringFormat.LineAlignment = StringAlignment.Center;
						break;

					case RowAlignment.Bottom:
						this.stringFormat.LineAlignment = StringAlignment.Far;
						break;
				}
			}
		}


		/// <summary>
		/// Gets whether Visual Styles are enabled for the application
		/// </summary>
		protected bool VisualStylesEnabled
		{
			get
			{
				return ThemeManager.VisualStylesEnabled;
			}
		}

		#endregion
	}
}