Click here to Skip to main content
Click here to Skip to main content
Add your own
alternative version
Go to top

XPTable - .NET ListView meets Java's JTable

, 17 Sep 2005
A fully customisable ListView style control based on Java's JTable.
xptable_demo.zip
XPTableSamples
Editors
App.ico
bin
Release
Editors.exe
Editors.exe.manifest
XPTable.dll
Editors.csproj.user
Events
App.ico
bin
Release
Events.exe
Events.exe.manifest
XPTable.dll
Events.csproj.user
FirstTable
App.ico
bin
Release
FirstTable.exe
FirstTable.exe.manifest
XPTable.dll
FirstTable.csproj.user
MediaPlayerStyle
App.ico
bin
Release
MediaPlayerStyle.exe
MediaPlayerStyle.exe.manifest
XPTable.dll
MediaPlayerStyle.csproj.user
Renderers
App.ico
bin
Release
Renderers.exe
Renderers.exe.manifest
XPTable.dll
Renderers.csproj.user
Selection
App.ico
bin
Release
Selection.exe
Selection.exe.manifest
XPTable.dll
Selection.csproj.user
Sorting
App.ico
bin
Release
Sorting.exe
Sorting.exe.manifest
XPTable.dll
Sorting.csproj.user
Styles
App.ico
bin
Release
Styles.exe
Styles.exe.manifest
XPTable.dll
Styles.csproj.user
XPTableDemo.exe
XPTableDemo.exe.manifest
xptable_doc.zip
XPTableDocs
XPTable UserGuide.chm
XPTable.chm
xptable_src.zip
XPTable
bin
Release
XPTable.dll
doc
Editors
Events
Models
ColumnModel.bmp
Design
Table.bmp
TableModel.bmp
Renderers
Sorting
Themes
Win32
XPTable.csproj.user
XPTable.ndoc
XPTable.snk
/*
 * 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 XPTable.Editors;
using XPTable.Events;
using XPTable.Models.Design;
using XPTable.Renderers;
using XPTable.Sorting;


namespace XPTable.Models
{
	/// <summary>
	/// Represents a Column whose Cells are displayed as a ProgressBar
	/// </summary>
	[DesignTimeVisible(false),
	ToolboxItem(false)]
	public class ProgressBarColumn : Column
	{
		#region Class Data

		/// <summary>
		/// Specifies whether the ProgressBar's value as a string 
		/// should be displayed
		/// </summary>
		private bool drawPercentageText;

		#endregion
		
		
		#region Constructor
		
		/// <summary>
		/// Creates a new ProgressBarColumn with default values
		/// </summary>
		public ProgressBarColumn() : base()
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		public ProgressBarColumn(string text) : base(text)
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text and width
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		/// <param name="width">The column's width</param>
		public ProgressBarColumn(string text, int width) : base(text, width)
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text, width and visibility
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		/// <param name="width">The column's width</param>
		/// <param name="visible">Specifies whether the column is visible</param>
		public ProgressBarColumn(string text, int width, bool visible) : base(text, width, visible)
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text and image
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		/// <param name="image">The image displayed on the column's header</param>
		public ProgressBarColumn(string text, Image image) : base(text, image)
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text, image 
		/// and width
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		/// <param name="image">The image displayed on the column's header</param>
		/// <param name="width">The column's width</param>
		public ProgressBarColumn(string text, Image image, int width) : base(text, image, width)
		{
			this.Init();
		}


		/// <summary>
		/// Creates a new ProgressBarColumn with the specified header text, image, 
		/// width and visibility
		/// </summary>
		/// <param name="text">The text displayed in the column's header</param>
		/// <param name="image">The image displayed on the column's header</param>
		/// <param name="width">The column's width</param>
		/// <param name="visible">Specifies whether the column is visible</param>
		public ProgressBarColumn(string text, Image image, int width, bool visible) : base(text, image, width, visible)
		{
			this.Init();
		}


		/// <summary>
		/// Initializes the ProgressBarColumn with default values
		/// </summary>
		private void Init()
		{
			this.drawPercentageText = true;
			this.Editable = false;
		}

		#endregion


		#region Methods

		/// <summary>
		/// Gets a string that specifies the name of the Column's default CellRenderer
		/// </summary>
		/// <returns>A string that specifies the name of the Column's default 
		/// CellRenderer</returns>
		public override string GetDefaultRendererName()
		{
			return "PROGRESSBAR";
		}


		/// <summary>
		/// Gets the Column's default CellRenderer
		/// </summary>
		/// <returns>The Column's default CellRenderer</returns>
		public override ICellRenderer CreateDefaultRenderer()
		{
			return new ProgressBarCellRenderer();
		}


		/// <summary>
		/// Gets a string that specifies the name of the Column's default CellEditor
		/// </summary>
		/// <returns>A string that specifies the name of the Column's default 
		/// CellEditor</returns>
		public override string GetDefaultEditorName()
		{
			return null;
		}


		/// <summary>
		/// Gets the Column's default CellEditor
		/// </summary>
		/// <returns>The Column's default CellEditor</returns>
		public override ICellEditor CreateDefaultEditor()
		{
			return null;
		}

		#endregion


		#region Properties

		/// <summary>
		/// Gets or sets whether a Cell's percantage value should be drawn as a string
		/// </summary>
		[Category("Appearance"),
		DefaultValue(true),
		Description("Indicates whether a Cell's percantage value is drawn as a string")]
		public bool DrawPercentageText
		{
			get
			{
				return this.drawPercentageText;
			}

			set
			{
				if(this.drawPercentageText != value)
				{
					this.drawPercentageText = value;

					this.OnPropertyChanged(new ColumnEventArgs(this, ColumnEventType.RendererChanged, null));
				}
			}
		}


		/// <summary>
		/// Gets the Type of the Comparer used to compare the Column's Cells when 
		/// the Column is sorting
		/// </summary>
		public override Type DefaultComparerType
		{
			get
			{
				return typeof(NumberComparer);
			}
		}


		/// <summary>
		/// Gets or sets a value indicating whether the Column's Cells contents 
		/// are able to be edited
		/// </summary>
		[Category("Appearance"),
		DefaultValue(false),
		Description("Controls whether the column's cell contents are able to be changed by the user")]
		public new bool Editable
		{
			get
			{
				return base.Editable;
			}

			set
			{
				base.Editable = value;
			}
		}

		#endregion
	}
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Mathew Hall
Web Developer
Australia Australia
No Biography provided

| Advertise | Privacy | Mobile
Web01 | 2.8.140916.1 | Last Updated 17 Sep 2005
Article Copyright 2005 by Mathew Hall
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid