/* Copyright (c) Citrix Systems Inc. * 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 HOLDER 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.Collections.Generic; using System.ComponentModel; using System.Drawing; using System.Data; using System.Text; using System.Windows.Forms; using System.Windows.Forms.VisualStyles; using XenAdmin.Core; using XenAPI; namespace XenAdmin.Controls { public partial class CustomTreeView : FlickerFreeListBox { private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); /// /// SURGEON GENERAL'S WARNING: This collection contains the infamous 'secret node'. /// To iterate only through items that you have explicity added to the treeview, use /// the Items collection instead. /// public readonly List Nodes = new List(); private VisualStyleRenderer plusRenderer; private VisualStyleRenderer minusRenderer; private CustomTreeNode lastSelected; private bool _inUpdate = false; /// /// If you want to make this into a regular listbox, set this to a smaller value, like 5 or something /// private int _nodeIndent = 19; [Browsable(true)] public int NodeIndent { get { return _nodeIndent; } set { _nodeIndent = value; } } public CustomTreeNode SecretNode = new CustomTreeNode(); private bool _showCheckboxes = true; [Browsable(true)] public bool ShowCheckboxes { get { return _showCheckboxes; } set { _showCheckboxes = value; } } private bool _showDescription = true; [Browsable(true)] public bool ShowDescription { get { return _showDescription; } set { _showDescription = value; } } private bool _showImages = false; [Browsable(true)] public bool ShowImages { get { return _showImages; } set { _showImages = value; } } /// /// The font used in descriptions. /// private Font _descriptionFont = null; public override Font Font { get { return base.Font; } set { base.Font = value; if (_descriptionFont != null) _descriptionFont.Dispose(); _descriptionFont = new Font(value.FontFamily, value.Size - 1); RecalculateWidth(); } } private bool _showRootLines = true; [Browsable(true)] public bool ShowRootLines { get { return _showRootLines; } set { _showRootLines = value; } } private bool _rootAlwaysExpanded = false; [Browsable(true)] public bool RootAlwaysExpanded { get { return _rootAlwaysExpanded; } set { _rootAlwaysExpanded = value; } } public override int ItemHeight { get { return 17; } } public CustomTreeView() { InitializeComponent(); _descriptionFont = new Font(base.Font.FontFamily, base.Font.Size - 2); if (Application.RenderWithVisualStyles) { plusRenderer = new VisualStyleRenderer(VisualStyleElement.TreeView.Glyph.Closed); minusRenderer = new VisualStyleRenderer(VisualStyleElement.TreeView.Glyph.Opened); } } public new void BeginUpdate() { _inUpdate = true; base.BeginUpdate(); } public new void EndUpdate() { _inUpdate = false; base.EndUpdate(); RecalculateWidth(); Resort(); Refresh(); } public new void Invalidate() { RecalculateWidth(); base.Invalidate(); } protected override void OnDrawItem(DrawItemEventArgs e) { base.OnDrawItem(e); if(Enabled) { using (SolidBrush backBrush = new SolidBrush(BackColor)) { e.Graphics.FillRectangle(backBrush, e.Bounds); } } else { e.Graphics.FillRectangle(SystemBrushes.Control, e.Bounds); } if (e.Index == -1 || Items.Count <= e.Index) return; CustomTreeNode node = this.Items[e.Index] as CustomTreeNode; if (node == null) return; //int indent = (node.Level + 1) * NodeIndent; int indent = node.Level * NodeIndent + (ShowRootLines ? NodeIndent : 2); int TextLength = Drawing.MeasureText(node.ToString(), e.Font).Width + 2; int TextLeft = indent + (ShowCheckboxes && !node.HideCheckbox ? ItemHeight : 0) + (ShowImages ? ItemHeight : 0); //CA-59618: add top margin to the items except the first one when rendering with //visual styles because in this case there is already one pixel of margin. int topMargin = Application.RenderWithVisualStyles && e.Index == 0 ? 0 : 1; if (Enabled && node.Selectable) { Color nodeBackColor = node.Enabled ? e.BackColor : (e.BackColor == BackColor ? BackColor : SystemColors.ControlLight); using (SolidBrush backBrush = new SolidBrush(nodeBackColor)) { e.Graphics.FillRectangle(backBrush, new Rectangle(e.Bounds.Left + TextLeft + 1, e.Bounds.Top + topMargin, TextLength - 4, e.Bounds.Height)); } } //draw expander if (node.ChildNodes.Count > 0 && (ShowRootLines || node.Level > 0)) { if (!node.Expanded) { if(Application.RenderWithVisualStyles) plusRenderer.DrawBackground(e.Graphics, new Rectangle(e.Bounds.Left + indent - ItemHeight, e.Bounds.Top + 3 + topMargin, 9, 9)); else e.Graphics.DrawImage(Properties.Resources.tree_plus, new Rectangle(e.Bounds.Left + indent - ItemHeight, e.Bounds.Top + 3 + topMargin, 9, 9)); } else { if (Application.RenderWithVisualStyles) minusRenderer.DrawBackground(e.Graphics, new Rectangle(e.Bounds.Left + indent - ItemHeight, e.Bounds.Top + 3 + topMargin, 9, 9)); else e.Graphics.DrawImage(Properties.Resources.tree_minus, new Rectangle(e.Bounds.Left + indent - ItemHeight, e.Bounds.Top + 3 + topMargin, 9, 9)); } } //draw checkboxes if (ShowCheckboxes && !node.HideCheckbox) { var checkedState = CheckBoxState.UncheckedDisabled; if (node.State == CheckState.Checked) { if (node.Enabled && Enabled) checkedState = CheckBoxState.CheckedNormal; else if (node.CheckedIfdisabled) checkedState = CheckBoxState.CheckedDisabled; } else if (node.State == CheckState.Indeterminate) { checkedState = node.Enabled && Enabled ? CheckBoxState.MixedNormal : CheckBoxState.MixedDisabled; } else if (node.State == CheckState.Unchecked) { checkedState = node.Enabled && Enabled ? CheckBoxState.UncheckedNormal : CheckBoxState.UncheckedDisabled; } CheckBoxRenderer.DrawCheckBox(e.Graphics, new Point(e.Bounds.Left + indent, e.Bounds.Top + 1 + topMargin), checkedState); indent += ItemHeight; } //draw images if (ShowImages && node.Image != null) { var rectangle = new Rectangle(e.Bounds.Left + indent, e.Bounds.Top + topMargin, node.Image.Width, node.Image.Height); if (node.Enabled && Enabled) e.Graphics.DrawImage(node.Image, rectangle); else e.Graphics.DrawImage(node.Image, rectangle, 0, 0, node.Image.Width, node.Image.Height, GraphicsUnit.Pixel, Drawing.GreyScaleAttributes); indent += ItemHeight; } //draw item's main text Color textColor = node.Enabled && Enabled ? (node.Selectable ? e.ForeColor : ForeColor) : SystemColors.GrayText; Drawing.DrawText(e.Graphics, node.ToString(), e.Font, new Point(e.Bounds.Left + indent, e.Bounds.Top + topMargin), textColor); indent += TextLength; //draw item's description if (ShowDescription) { Drawing.DrawText(e.Graphics, node.Description, _descriptionFont, new Point(e.Bounds.Left + indent, e.Bounds.Top + 1 + topMargin), SystemColors.GrayText); } } public List CheckedItems() { List nodes = new List(); foreach (CustomTreeNode node in Nodes) if (node.Level >= 0 && node.State == CheckState.Checked && node.Enabled) nodes.Add(node); return nodes; } public List CheckableItems() { List nodes = new List(); foreach (CustomTreeNode node in Nodes) if (node.Level >= 0 && node.State != CheckState.Checked && node.Enabled) nodes.Add(node); return nodes; } public void AddNode(CustomTreeNode node) { if (Nodes.Count == 0) Nodes.Add(SecretNode); SecretNode.AddChild(node); Nodes.Add(node); if (!_inUpdate) { RecalculateWidth(); Resort(); Refresh(); } } public void RemoveNode(CustomTreeNode node) { Nodes.Remove(node); if (!_inUpdate) { RecalculateWidth(); Resort(); Refresh(); } } public void AddChildNode(CustomTreeNode parent, CustomTreeNode child) { parent.AddChild(child); Nodes.Add(child); if (!_inUpdate) { RecalculateWidth(); Resort(); Refresh(); } } public void ClearAllNodes() { Nodes.Clear(); if (!_inUpdate) { RecalculateWidth(); Resort(); Refresh(); } } public void Resort() { try { lastSelected = SelectedItem as CustomTreeNode; } catch (IndexOutOfRangeException) { // Accessing ListBox.SelectedItem sometimes throws an IndexOutOfRangeException (See CA-24396) log.Warn("IndexOutOfRangeException in ListBox.SelectedItem"); lastSelected = null; } Nodes.Sort(); Items.Clear(); foreach (CustomTreeNode node in Nodes) { if (node.Level != -1 && node.ParentNode.Expanded) Items.Add(node); } SelectedItem = lastSelected; // I've yet to come across the above assignement working. If we fail to restore the selection, select something so the user can see focus feedback // (the color of the selected item is the only indication as to whether it is focused or not) // Iterating through and using CustomTreeNode.equals is useless here as it compares based on index, which I think is why the above call almost never works if (SelectedItem == null && lastSelected != null && Items.Count > 0) { SelectedItem = Items[0]; } } // Adjusts the width of the control to that of the widest row private void RecalculateWidth() { int maxWidth = 0; foreach (CustomTreeNode node in this.Nodes) { int indent = (node.Level + 1) * NodeIndent; int checkbox = ShowCheckboxes && !node.HideCheckbox ? ItemHeight : 0; int image = ShowImages ? ItemHeight : 0; int text = Drawing.MeasureText(node.ToString(), this.Font).Width + 2; int desc = ShowDescription ? Drawing.MeasureText(node.Description, _descriptionFont).Width : 0; int itemWidth = indent + checkbox + image + text + desc + 10; maxWidth = Math.Max(itemWidth, maxWidth); } // Set horizontal extent and enable scrollbar if necessary this.HorizontalExtent = maxWidth; this.HorizontalScrollbar = this.HorizontalExtent > this.Width && Enabled; } /// /// Finds next/previous node in Items collection. /// /// Node where the search for next/previous node will start. /// Determines direction of search (search for next or previous node). /// protected CustomTreeNode GetNextNode(CustomTreeNode currentNode, bool searchForward) { if (currentNode == null) return null; int index = Items.IndexOf(currentNode); if (searchForward) { index++; if (index >= Items.Count) index = -1; } else index--; if (index < 0) return null; return (CustomTreeNode)Items[index]; } /// /// Finds next/previous enabled node in Items collection. /// /// Node where the search for next/previous enabled node will start. /// Determines direction of search (search for next or previous node). /// protected CustomTreeNode GetNextEnabledNode(CustomTreeNode currentNode, bool searchForward) { if (currentNode == null) return null; CustomTreeNode nextNode = GetNextNode(currentNode, searchForward); if (nextNode == null) return null; if (nextNode.Enabled) return nextNode; return GetNextEnabledNode(nextNode, searchForward); } protected override void OnMouseUp(MouseEventArgs e) { bool anythingChanged = false; bool orderChanged = false; Point loc = this.PointToClient(MousePosition); int index = this.IndexFromPoint(loc); if (index < 0 || index > Items.Count) return; CustomTreeNode node = this.Items[index] as CustomTreeNode; if (node == null) return; int indent = node.Level * NodeIndent + (ShowRootLines ? NodeIndent : 2); if (node.ChildNodes.Count > 0 && loc.X < indent - (ItemHeight - 9) && loc.X > indent - ItemHeight && (ShowRootLines || node.Level > 0)) { node.Expanded = !node.Expanded; node.PreferredExpanded = node.Expanded; anythingChanged = true; orderChanged = true; } else if (ShowCheckboxes && !node.HideCheckbox && node.Enabled && loc.X > indent && loc.X < indent + ItemHeight) { if (node.State == CheckState.Unchecked || node.State == CheckState.Indeterminate) node.State = CheckState.Checked; else node.State = CheckState.Unchecked; anythingChanged = true; } if (orderChanged) Resort(); if (anythingChanged) { if(ItemCheckChanged != null) ItemCheckChanged(node, new EventArgs()); Refresh(); } base.OnMouseUp(e); } public event EventHandler ItemCheckChanged; protected override void OnMouseDoubleClick(MouseEventArgs e) { bool anythingChanged = false; Point loc = this.PointToClient(MousePosition); int index = this.IndexFromPoint(loc); if (index < 0 || index > Items.Count) return; CustomTreeNode node = this.Items[index] as CustomTreeNode; if (node == null) return; int indent = node.Level * NodeIndent + (ShowRootLines ? NodeIndent : 2); if (node.ChildNodes.Count > 0 && loc.X < indent - (ItemHeight - 9) && loc.X > indent - ItemHeight && (ShowRootLines || node.Level > 0)) { return; } else if (ShowCheckboxes && !node.HideCheckbox && loc.X > indent && loc.X < indent + ItemHeight) { return; } else if (node.ChildNodes.Count > 0 && (node.Level > 0 || !_rootAlwaysExpanded)) { node.Expanded = !node.Expanded; node.PreferredExpanded = node.Expanded; anythingChanged = true; } if (anythingChanged) { Resort(); Refresh(); } } protected override void OnKeyUp(KeyEventArgs e) { var node = SelectedItem as CustomTreeNode; switch (e.KeyCode) { case Keys.Space: { if (!ShowCheckboxes) break; if (node == null || node.HideCheckbox || !node.Enabled) break; //checked => uncheck it; unchecked or indeterminate => check it node.State = node.State == CheckState.Checked ? CheckState.Unchecked : CheckState.Checked; Refresh(); if (ItemCheckChanged != null) ItemCheckChanged(node, new EventArgs()); break; } } base.OnKeyUp(e); } protected override void OnKeyDown(KeyEventArgs e) { var node = SelectedItem as CustomTreeNode; switch (e.KeyCode) { case Keys.Right: { if (node != null && node.ChildNodes.Count > 0 && (node.Level > 0 || !_rootAlwaysExpanded) && !node.Expanded) { node.Expanded = true; Resort(); Refresh(); e.Handled = true; } break; } case Keys.Left: { if (node != null && node.ChildNodes.Count > 0 && (node.Level > 0 || !_rootAlwaysExpanded) && node.Expanded) { node.Expanded = false; Resort(); Refresh(); e.Handled = true; } break; } } base.OnKeyDown(e); } } }