XPlorerBar: A WPF Windows XP Style Explorer Bar Control

#region [       Copyright © 2008, Zona-Tools, all rights reserved.       ]
/*
 * 
    This source code is licensed under the Code Project Open License (CPOL).
    Check out http://www.codeproject.com/info/cpol10.aspx for further details.
 * 
*/
#endregion


#region [       Using namespaces       ]

using System.ComponentModel;
using System.Windows;
using System.Windows.Controls.Primitives;
using System.Windows.Media;

#endregion


namespace ZonaTools.XPlorerBar
{
    /// <summary>
    /// Represents a text associated with an image and a tag.
    /// </summary>
    public class XPlorerItem : ButtonBase
    {
        #region [       Constructor       ]

        //===========================================================================
        /// <summary>
        /// Static constructor used to override the dependency properties (if
        /// needed) and define the default style for the control.
        /// </summary>
        //===========================================================================
        static XPlorerItem()
        {
            //Provides a new default style for the XPlorerItem element
            DefaultStyleKeyProperty.OverrideMetadata(typeof(XPlorerItem), 
                new FrameworkPropertyMetadata(typeof(XPlorerItem)));
        }

        #endregion


        #region [       Dependency properties       ]

        #region ItemImage property

        //===========================================================================
        /// <summary>
        /// Gets or sets the image source of the image to associate with the text.
        /// This is a dependency property.
        /// </summary>
        /// <remarks>
        /// The default value is <c>null</c>.
        /// </remarks>
        //===========================================================================
        [Category(XPlorerBar.CATEGORYNAME), Browsable(true)]
        public ImageSource ItemImage
        {
            get { return (ImageSource)GetValue(ItemImageProperty); }
            set { SetValue(ItemImageProperty, value); }
        }

        /// <summary>
        /// Identifies the <see cref="ItemImage"/> dependency property.
        /// </summary>
        public static readonly DependencyProperty ItemImageProperty =
            DependencyProperty.Register("ItemImage",
            typeof(ImageSource), typeof(XPlorerItem),
            new PropertyMetadata(null));

        #endregion

        #region ItemText property

        //===========================================================================
        /// <summary>
        /// Gets or sets the text to display.
        /// This is a dependency property.
        /// </summary>
        /// <remarks>
        /// The default value is <c>string.Empty</c>.
        /// </remarks>
        //===========================================================================
        [Category(XPlorerBar.CATEGORYNAME), Browsable(true)]
        public string ItemText
        {
            get { return (string)GetValue(ItemTextProperty); }
            set { SetValue(ItemTextProperty, value); }
        }

        /// <summary>
        /// Identifies the <see cref="ItemText"/> dependency property.
        /// </summary>
        public static readonly DependencyProperty ItemTextProperty =
            DependencyProperty.Register("ItemText",
            typeof(string), typeof(XPlorerItem),
            new PropertyMetadata(string.Empty));

        #endregion

        #endregion
    }
}