Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / WinForms / Managed / System / WinForms / TreeView.cs / 1305376 / TreeView.cs
//------------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
/*
*/
namespace System.Windows.Forms {
using System.Runtime.Remoting;
using System.Runtime.InteropServices;
using System.Diagnostics;
using System.Diagnostics.CodeAnalysis;
using System;
using System.Security.Permissions;
using System.Security;
using System.Drawing;
using System.Windows.Forms.Internal;
using System.Drawing.Design;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Collections;
using Microsoft.Win32;
using System.Reflection;
using System.Windows.Forms.Layout;
using System.Globalization;
using System.Windows.Forms.VisualStyles;
///
///
/// Displays a hierarchical list of items, or nodes. Each
/// node includes a caption and an optional bitmap. The user can select a node. If
/// it has sub-nodes, the user can collapse or expand the node.
///
///
///
[
ComVisible(true),
ClassInterface(ClassInterfaceType.AutoDispatch),
DefaultProperty("Nodes"),
DefaultEvent("AfterSelect"),
Docking(DockingBehavior.Ask),
Designer("System.Windows.Forms.Design.TreeViewDesigner, " + AssemblyRef.SystemDesign),
SRDescription(SR.DescriptionTreeView)
]
public class TreeView : Control {
private static readonly int MaxIndent = 32000; // Maximum allowable TreeView indent
private static readonly string backSlash = "\\";
private const int DefaultTreeViewIndent = 19;
private DrawTreeNodeEventHandler onDrawNode;
private NodeLabelEditEventHandler onBeforeLabelEdit;
private NodeLabelEditEventHandler onAfterLabelEdit;
private TreeViewCancelEventHandler onBeforeCheck;
private TreeViewEventHandler onAfterCheck;
private TreeViewCancelEventHandler onBeforeCollapse;
private TreeViewEventHandler onAfterCollapse;
private TreeViewCancelEventHandler onBeforeExpand;
private TreeViewEventHandler onAfterExpand;
private TreeViewCancelEventHandler onBeforeSelect;
private TreeViewEventHandler onAfterSelect;
private ItemDragEventHandler onItemDrag;
private TreeNodeMouseHoverEventHandler onNodeMouseHover;
private EventHandler onRightToLeftLayoutChanged;
internal TreeNode selectedNode = null;
private ImageList.Indexer imageIndexer;
private ImageList.Indexer selectedImageIndexer;
private bool setOddHeight = false;
private TreeNode prevHoveredNode = null;
private bool hoveredAlready = false;
private bool rightToLeftLayout = false;
[SuppressMessage("Microsoft.Reliability", "CA2006:UseSafeHandleToEncapsulateNativeResources")]
private IntPtr hNodeMouseDown = IntPtr.Zero;//ensures we fire nodeclick on the correct node
private const int TREEVIEWSTATE_hideSelection = 0x00000001;
private const int TREEVIEWSTATE_labelEdit = 0x00000002;
private const int TREEVIEWSTATE_scrollable = 0x00000004;
private const int TREEVIEWSTATE_checkBoxes = 0x00000008;
private const int TREEVIEWSTATE_showLines = 0x00000010;
private const int TREEVIEWSTATE_showPlusMinus = 0x00000020;
private const int TREEVIEWSTATE_showRootLines = 0x00000040;
private const int TREEVIEWSTATE_sorted = 0x00000080;
private const int TREEVIEWSTATE_hotTracking = 0x00000100;
private const int TREEVIEWSTATE_fullRowSelect = 0x00000200;
private const int TREEVIEWSTATE_showNodeToolTips = 0x00000400;
private const int TREEVIEWSTATE_doubleclickFired = 0x00000800;
private const int TREEVIEWSTATE_mouseUpFired = 0x00001000;
private const int TREEVIEWSTATE_showTreeViewContextMenu = 0x00002000;
private const int TREEVIEWSTATE_lastControlValidated = 0x00004000;
private const int TREEVIEWSTATE_stopResizeWindowMsgs = 0x00008000;//VSWhidbey 466949
private const int TREEVIEWSTATE_ignoreSelects = 0x00010000;//VSWhidbey 384294, 490763.
// PERF: take all the bools and put them into a state variable
private System.Collections.Specialized.BitVector32 treeViewState; // see TREEVIEWSTATE_ consts above
///
/// Creates a TreeView control
///
public TreeView()
: base() {
this.treeViewState = new System.Collections.Specialized.BitVector32(TREEVIEWSTATE_showRootLines |
TREEVIEWSTATE_showPlusMinus |
TREEVIEWSTATE_showLines |
TREEVIEWSTATE_scrollable |
TREEVIEWSTATE_hideSelection);
root = new TreeNode(this);
// TreeView must always have an ImageIndex.
SelectedImageIndexer.Index = 0;
ImageIndexer.Index = 0;
SetStyle(ControlStyles.UserPaint, false);
SetStyle(ControlStyles.StandardClick, false);
SetStyle(ControlStyles.UseTextForAccessibility, false);
}
///
/// The background color for this control. Specifying null for
/// this parameter sets the
/// control's background color to its parent's background color.
///
public override Color BackColor {
get {
if (ShouldSerializeBackColor()) {
return base.BackColor;
}
else {
return SystemColors.Window;
}
}
set {
base.BackColor = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETBKCOLOR, 0, ColorTranslator.ToWin32(BackColor));
// This is to get around a problem in the comctl control where the lines
// connecting nodes don't get the new BackColor. This messages forces
// reconstruction of the line bitmaps without changing anything else.
SendMessage(NativeMethods.TVM_SETINDENT, Indent, 0);
}
}
}
///
/// [To be supplied.]
///
///
/// [To be supplied.]
///
///
/// The border style of the window.
///
[
SRCategory(SR.CatAppearance),
DefaultValue(BorderStyle.Fixed3D),
DispId(NativeMethods.ActiveX.DISPID_BORDERSTYLE),
SRDescription(SR.borderStyleDescr)
]
public BorderStyle BorderStyle {
get {
return borderStyle;
}
set {
if (borderStyle != value) {
//verify that 'value' is a valid enum type...
//valid values are 0x0 to 0x2
if (!ClientUtils.IsEnumValid(value, (int)value, (int)BorderStyle.None, (int)BorderStyle.Fixed3D))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(BorderStyle));
}
borderStyle = value;
UpdateStyles();
}
}
}
///
/// The value of the CheckBoxes property. The CheckBoxes
/// property determines if check boxes are shown next to node in the
/// tree view.
///
[
SRCategory(SR.CatAppearance),
DefaultValue(false),
SRDescription(SR.TreeViewCheckBoxesDescr)
]
public bool CheckBoxes {
get {
return treeViewState[TREEVIEWSTATE_checkBoxes];
}
set {
if (CheckBoxes != value) {
treeViewState[TREEVIEWSTATE_checkBoxes] = value;
if (IsHandleCreated) {
// Going from true to false requires recreation
if (CheckBoxes) {
UpdateStyles();
} else {
// Reset the Checked state after setting the checkboxes (this was Everett behavior)
// The implementation of the TreeNode.Checked property has changed in Whidbey
// So we need to explicit set the Checked state to false to keep the everett behavior.
UpdateCheckedState(root, false);
RecreateHandle();
}
}
}
}
}
///
///
///
/// Deriving classes can override this to configure a default size for their control.
/// This is more efficient than setting the size in the control's constructor.
///
protected override Size DefaultSize {
get {
return new Size(121, 97);
}
}
///
/// This property is overridden and hidden from statement completion
/// on controls that are based on Win32 Native Controls.
///
[EditorBrowsable(EditorBrowsableState.Never)]
protected override bool DoubleBuffered {
get {
return base.DoubleBuffered;
}
set {
base.DoubleBuffered = value;
}
}
///
/// The current foreground color for this control, which is the
/// color the control uses to draw its text.
///
public override Color ForeColor {
get {
if (ShouldSerializeForeColor()) {
return base.ForeColor;
}
else {
return SystemColors.WindowText;
}
}
set {
base.ForeColor = value;
if (IsHandleCreated)
SendMessage(NativeMethods.TVM_SETTEXTCOLOR, 0, ColorTranslator.ToWin32(ForeColor));
}
}
///
/// Determines whether the selection highlight spans across the width of the TreeView.
/// This property will have no effect if ShowLines is true.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewFullRowSelectDescr)
]
public bool FullRowSelect {
get { return treeViewState[TREEVIEWSTATE_fullRowSelect];}
set {
if (FullRowSelect != value) {
treeViewState[TREEVIEWSTATE_fullRowSelect] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The HideSelection property specifies whether the selected node will
/// be highlighted even when the TreeView loses focus.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewHideSelectionDescr)
]
public bool HideSelection {
get {
return treeViewState[TREEVIEWSTATE_hideSelection];
}
set {
if (HideSelection != value) {
treeViewState[TREEVIEWSTATE_hideSelection] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The value of the HotTracking property. The HotTracking
/// property determines if nodes are highlighted as the mousepointer
/// passes over them.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewHotTrackingDescr)
]
public bool HotTracking {
get {
return treeViewState[TREEVIEWSTATE_hotTracking];
}
set {
if (HotTracking != value) {
treeViewState[TREEVIEWSTATE_hotTracking] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
DefaultValue(-1),
SRCategory(SR.CatBehavior),
Localizable(true),
RefreshProperties(RefreshProperties.Repaint),
TypeConverterAttribute(typeof(NoneExcludedImageIndexConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
SRDescription(SR.TreeViewImageIndexDescr),
RelatedImageList("ImageList")
]
public int ImageIndex {
get {
if (imageList == null) {
return -1;
}
if (ImageIndexer.Index >= imageList.Images.Count) {
return Math.Max(0, imageList.Images.Count - 1);
}
return ImageIndexer.Index;
}
set {
// If (none) is selected in the image index editor, we'll just adjust this to
// mean image index 0. This is because a treeview must always have an image index -
// even if no imagelist exists we want the image index to be 0.
//
if (value == -1) {
value = 0;
}
if (value < 0) {
throw new ArgumentOutOfRangeException("ImageIndex", SR.GetString(SR.InvalidLowBoundArgumentEx, "ImageIndex", value.ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (ImageIndexer.Index != value) {
ImageIndexer.Index = value;
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
Localizable(true),
TypeConverterAttribute(typeof(ImageKeyConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
DefaultValue(""),
RefreshProperties(RefreshProperties.Repaint),
SRDescription(SR.TreeViewImageKeyDescr),
RelatedImageList("ImageList")
]
public string ImageKey {
get {
return ImageIndexer.Key;
}
set {
if (ImageIndexer.Key != value) {
ImageIndexer.Key = value;
if (String.IsNullOrEmpty(value) || value.Equals(SR.GetString(SR.toStringNone))) {
ImageIndex = (ImageList != null) ? 0:-1;
}
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// Returns the image list control that is bound to the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(null),
SRDescription(SR.TreeViewImageListDescr),
RefreshProperties(RefreshProperties.Repaint)
]
public ImageList ImageList {
get {
return imageList;
}
set {
if (value != imageList) {
DetachImageListHandlers();
imageList = value;
AttachImageListHandlers();
// Update TreeView's images
//
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETIMAGELIST, 0,
value==null? IntPtr.Zero: value.Handle);
if (StateImageList != null && StateImageList.Images.Count > 0) {
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE,
internalStateImageList.Handle);
}
}
UpdateCheckedState(root, true);
}
}
}
private void AttachImageListHandlers() {
if (imageList != null) {
//NOTE: any handlers added here should be removed in DetachImageListHandlers
imageList.RecreateHandle += new EventHandler(ImageListRecreateHandle);
imageList.Disposed += new EventHandler(DetachImageList);
imageList.ChangeHandle += new EventHandler(ImageListChangedHandle);
}
}
private void DetachImageListHandlers() {
if (imageList != null) {
imageList.RecreateHandle -= new EventHandler(ImageListRecreateHandle);
imageList.Disposed -= new EventHandler(DetachImageList);
imageList.ChangeHandle -= new EventHandler(ImageListChangedHandle);
}
}
private void AttachStateImageListHandlers() {
if (stateImageList != null) {
//NOTE: any handlers added here should be removed in DetachStateImageListHandlers
stateImageList.RecreateHandle += new EventHandler(StateImageListRecreateHandle);
stateImageList.Disposed += new EventHandler(DetachStateImageList);
stateImageList.ChangeHandle += new EventHandler(StateImageListChangedHandle);
}
}
private void DetachStateImageListHandlers() {
if (stateImageList != null) {
stateImageList.RecreateHandle -= new EventHandler(StateImageListRecreateHandle);
stateImageList.Disposed -= new EventHandler(DetachStateImageList);
stateImageList.ChangeHandle -= new EventHandler(StateImageListChangedHandle);
}
}
///
/// Returns the state image list control that is bound to the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(null),
SRDescription(SR.TreeViewStateImageListDescr)
]
public ImageList StateImageList {
get {
return stateImageList;
}
set {
if (value != stateImageList) {
DetachStateImageListHandlers();
stateImageList = value;
if (stateImageList != null && stateImageList.Images.Count > 0) {
Image[] images = new Image[stateImageList.Images.Count + 1];
images[0] = stateImageList.Images[0];
for (int i = 1; i <= stateImageList.Images.Count ; i++) {
images[i] = stateImageList.Images[i -1];
}
internalStateImageList = new ImageList();
internalStateImageList.Images.AddRange(images);
}
AttachStateImageListHandlers();
// Update TreeView's images
//
if (IsHandleCreated)
{
if (stateImageList != null && stateImageList.Images.Count > 0)
{
Debug.Assert(internalStateImageList != null, "internalStateImageList is null!!");
if (internalStateImageList != null)
{
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, internalStateImageList.Handle);
}
}
// We need to update the checks
// and stateimage value for each node.
UpdateCheckedState(root, true);
if((value == null || stateImageList.Images.Count == 0) && CheckBoxes) {
// Requires Handle Recreate to force on the checkBoxes and states..
RecreateHandle();
}
else {
// The TreeView shows up the state imageList after sending this message even if the nodes dont have any stateImageIndex set.
// In order to avoid that we refresh nodes which would "reset" the images to none.
// This causes flicker but gives us the right behavior
RefreshNodes();
}
}
}
}
}
///
/// The indentation level in pixels.
///
[
Localizable(true),
SRCategory(SR.CatBehavior),
SRDescription(SR.TreeViewIndentDescr)
]
public int Indent {
get {
if (indent != -1) {
return indent;
}
else if (IsHandleCreated) {
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETINDENT, 0, 0));
}
return DefaultTreeViewIndent;
}
set {
if (indent != value) {
if (value < 0) {
throw new ArgumentOutOfRangeException("Indent", SR.GetString(SR.InvalidLowBoundArgumentEx, "Indent", (value).ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (value > MaxIndent) {
throw new ArgumentOutOfRangeException("Indent", SR.GetString(SR.InvalidHighBoundArgumentEx, "Indent", (value).ToString(CultureInfo.CurrentCulture), (MaxIndent).ToString(CultureInfo.CurrentCulture)));
}
indent = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETINDENT, value, 0);
indent = unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETINDENT, 0, 0));
}
}
}
}
///
/// The height of every item in the tree view, in pixels.
///
[
SRCategory(SR.CatAppearance),
SRDescription(SR.TreeViewItemHeightDescr)
]
public int ItemHeight {
get {
if (itemHeight != -1) {
return itemHeight;
}
if (IsHandleCreated) {
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETITEMHEIGHT, 0, 0));
}
else {
if (CheckBoxes && (DrawMode == TreeViewDrawMode.OwnerDrawAll)) {
return Math.Max(16, FontHeight + 3);
}
return FontHeight + 3;
}
}
set {
if (itemHeight != value) {
if (value < 1) {
throw new ArgumentOutOfRangeException("ItemHeight", SR.GetString(SR.InvalidLowBoundArgumentEx, "ItemHeight", (value).ToString(CultureInfo.CurrentCulture), (1).ToString(CultureInfo.CurrentCulture)));
}
if (value >= Int16.MaxValue) {
throw new ArgumentOutOfRangeException("ItemHeight", SR.GetString(SR.InvalidHighBoundArgument, "ItemHeight", (value).ToString(CultureInfo.CurrentCulture), Int16.MaxValue.ToString(CultureInfo.CurrentCulture)));
}
itemHeight = value;
if (IsHandleCreated) {
if (itemHeight % 2 != 0) {
setOddHeight = true;
try {
RecreateHandle();
}
finally {
setOddHeight = false;
}
}
SendMessage(NativeMethods.TVM_SETITEMHEIGHT, value, 0);
itemHeight = unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETITEMHEIGHT, 0, 0));
}
}
}
}
///
/// The LabelEdit property determines if the label text
/// of nodes in the tree view is editable.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewLabelEditDescr)
]
public bool LabelEdit {
get {
return treeViewState[TREEVIEWSTATE_labelEdit];
}
set {
if (LabelEdit != value) {
treeViewState[TREEVIEWSTATE_labelEdit] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// This is the color of the lines that connect the nodes of the Treeview.
///
[
SRCategory(SR.CatBehavior),
SRDescription(SR.TreeViewLineColorDescr),
DefaultValue(typeof(Color), "Black")
]
public Color LineColor {
get {
if (IsHandleCreated) {
int intColor = unchecked((int)(long)SendMessage(NativeMethods.TVM_GETLINECOLOR, 0, 0));
return ColorTranslator.FromWin32(intColor);
}
return lineColor;
}
set {
if (lineColor != value) {
lineColor = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETLINECOLOR, 0, ColorTranslator.ToWin32(lineColor));
}
}
}
}
///
/// The collection of nodes associated with this TreeView control
///
[
SRCategory(SR.CatBehavior),
DesignerSerializationVisibility(DesignerSerializationVisibility.Content),
Localizable(true),
SRDescription(SR.TreeViewNodesDescr),
MergableProperty(false)
]
public TreeNodeCollection Nodes {
get {
if (nodes == null) {
nodes = new TreeNodeCollection(root);
}
return nodes;
}
}
///
///
/// Indicates the drawing mode for the tree view.
///
///
[
SRCategory(SR.CatBehavior),
DefaultValue(TreeViewDrawMode.Normal),
SRDescription(SR.TreeViewDrawModeDescr)
]
public TreeViewDrawMode DrawMode {
get {
return drawMode;
}
set {
//valid values are 0x0 to 0x2
if (!ClientUtils.IsEnumValid(value, (int)value, (int)TreeViewDrawMode.Normal, (int)TreeViewDrawMode.OwnerDrawAll))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(TreeViewDrawMode));
}
if (drawMode != value) {
drawMode = value;
Invalidate();
// We need to invalidate when the Control resizes when the we support custom draw.
if (DrawMode == TreeViewDrawMode.OwnerDrawAll)
{
SetStyle(ControlStyles.ResizeRedraw, true);
}
}
}
}
///
/// The delimeter string used by TreeNode.getFullPath().
///
[
SRCategory(SR.CatBehavior),
DefaultValue("\\"),
SRDescription(SR.TreeViewPathSeparatorDescr)
]
public string PathSeparator {
get {
return pathSeparator;
}
set {
pathSeparator = value;
}
}
///
///
/// [To be supplied.]
///
///
[
Browsable(false),
EditorBrowsable(EditorBrowsableState.Never),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
]
public new Padding Padding {
get { return base.Padding; }
set { base.Padding = value;}
}
[
Browsable(false),
EditorBrowsable(EditorBrowsableState.Never)
]
public new event EventHandler PaddingChanged {
add { base.PaddingChanged += value; }
remove { base.PaddingChanged -= value; }
}
///
/// This is used for international applications where the language
/// is written from RightToLeft. When this property is true,
// and the RightToLeft is true, mirroring will be turned on on the form, and
/// control placement and text will be from right to left.
///
[
SRCategory(SR.CatAppearance),
Localizable(true),
DefaultValue(false),
SRDescription(SR.ControlRightToLeftLayoutDescr)
]
public virtual bool RightToLeftLayout {
get {
return rightToLeftLayout;
}
set {
if (value != rightToLeftLayout) {
rightToLeftLayout = value;
using(new LayoutTransaction(this, this, PropertyNames.RightToLeftLayout)) {
OnRightToLeftLayoutChanged(EventArgs.Empty);
}
}
}
}
///
/// [To be supplied.]
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewScrollableDescr)
]
public bool Scrollable {
get {
return treeViewState[TREEVIEWSTATE_scrollable];
}
set {
if (Scrollable != value) {
treeViewState[TREEVIEWSTATE_scrollable] = value;
RecreateHandle();
}
}
}
///
/// The image index that a node will display when selected.
/// The index applies to the ImageList referred to by the imageList property,
///
[
DefaultValue(-1),
SRCategory(SR.CatBehavior),
TypeConverterAttribute(typeof(NoneExcludedImageIndexConverter)),
Localizable(true),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
SRDescription(SR.TreeViewSelectedImageIndexDescr),
RelatedImageList("ImageList")
]
public int SelectedImageIndex {
get {
if (imageList == null) {
return -1;
}
if (SelectedImageIndexer.Index >= imageList.Images.Count) {
return Math.Max(0, imageList.Images.Count - 1);
}
return SelectedImageIndexer.Index;
}
set {
// If (none) is selected in the image index editor, we'll just adjust this to
// mean image index 0. This is because a treeview must always have an image index -
// even if no imagelist exists we want the image index to be 0.
//
if (value == -1) {
value = 0;
}
if (value < 0) {
throw new ArgumentOutOfRangeException("SelectedImageIndex", SR.GetString(SR.InvalidLowBoundArgumentEx, "SelectedImageIndex", value.ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (SelectedImageIndexer.Index != value) {
SelectedImageIndexer.Index = value;
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
Localizable(true),
TypeConverterAttribute(typeof(ImageKeyConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
DefaultValue(""),
RefreshProperties(RefreshProperties.Repaint),
SRDescription(SR.TreeViewSelectedImageKeyDescr),
RelatedImageList("ImageList")
]
public string SelectedImageKey {
get {
return SelectedImageIndexer.Key;
}
set {
if (SelectedImageIndexer.Key != value) {
SelectedImageIndexer.Key = value;
if (String.IsNullOrEmpty(value) || value.Equals(SR.GetString(SR.toStringNone))) {
SelectedImageIndex = (ImageList != null) ? 0 : -1;
}
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The currently selected tree node, or null if nothing is selected.
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewSelectedNodeDescr)
]
public TreeNode SelectedNode {
get {
if (IsHandleCreated) {
Debug.Assert(selectedNode == null || selectedNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hItem = SendMessage(NativeMethods.TVM_GETNEXTITEM, NativeMethods.TVGN_CARET, 0);
if (hItem == IntPtr.Zero)
return null;
return NodeFromHandle(hItem);
}
else if (selectedNode != null && selectedNode.TreeView == this) {
return selectedNode;
}
else {
return null;
}
}
set {
if (IsHandleCreated && (value == null || value.TreeView == this)) {
// This class invariant is not quite correct -- if the selected node does not belong to this Treeview,
// selectedNode != null even though the handle is created. We will call set_SelectedNode
// to inform the handle that the selected node has been added to the TreeView.
Debug.Assert(selectedNode == null || selectedNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hnode = (value == null ? IntPtr.Zero : value.Handle);
SendMessage(NativeMethods.TVM_SELECTITEM, NativeMethods.TVGN_CARET, hnode);
selectedNode = null;
}
else {
selectedNode = value;
}
}
}
///
/// The ShowLines property determines if lines are drawn between
/// nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowLinesDescr)
]
public bool ShowLines {
get {
return treeViewState[TREEVIEWSTATE_showLines];
}
set {
if (ShowLines != value) {
treeViewState[TREEVIEWSTATE_showLines] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The ShowLines property determines whether or not the tooltips willbe displayed on the nodes
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewShowShowNodeToolTipsDescr)
]
public bool ShowNodeToolTips {
get {
return treeViewState[TREEVIEWSTATE_showNodeToolTips];
}
set {
if (ShowNodeToolTips != value) {
treeViewState[TREEVIEWSTATE_showNodeToolTips] = value;
if (ShowNodeToolTips)
RecreateHandle();
}
}
}
///
/// The ShowPlusMinus property determines if the "plus/minus"
/// expand button is shown next to tree nodes that have children.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowPlusMinusDescr)
]
public bool ShowPlusMinus {
get {
return treeViewState[TREEVIEWSTATE_showPlusMinus];
}
set {
if (ShowPlusMinus != value) {
treeViewState[TREEVIEWSTATE_showPlusMinus] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// Determines if lines are draw between nodes at the root of
/// the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowRootLinesDescr)
]
public bool ShowRootLines {
get { return treeViewState[TREEVIEWSTATE_showRootLines];}
set {
if (ShowRootLines != value) {
treeViewState[TREEVIEWSTATE_showRootLines] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The Sorted property determines if nodes in the tree view are sorted.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewSortedDescr),
Browsable(false), EditorBrowsable(EditorBrowsableState.Never)
]
public bool Sorted {
get {
return treeViewState[TREEVIEWSTATE_sorted];
}
set {
if (Sorted != value) {
treeViewState[TREEVIEWSTATE_sorted] = value;
if (Sorted && TreeViewNodeSorter == null && Nodes.Count >= 1) {
RefreshNodes();
}
}
}
}
///
/// The sorting comparer for this TreeView.
///
[
SRCategory(SR.CatBehavior),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewNodeSorterDescr)
]
public IComparer TreeViewNodeSorter {
get {
return treeViewNodeSorter;
}
set {
if (treeViewNodeSorter != value) {
treeViewNodeSorter = value;
if (value != null) {
Sort();
}
}
}
}
///
/// [To be supplied.]
///
[Browsable(false), EditorBrowsable(EditorBrowsableState.Never), Bindable(false)]
public override string Text {
get {
return base.Text;
}
set {
base.Text = value;
}
}
///
/// The first visible node in the TreeView. Initially
/// the first root node is at the top of the TreeView, but if the
/// contents have been scrolled another node may be at the top.
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewTopNodeDescr)
]
public TreeNode TopNode {
get {
if (IsHandleCreated) {
IntPtr hitem = SendMessage(NativeMethods.TVM_GETNEXTITEM, NativeMethods.TVGN_FIRSTVISIBLE, 0);
return(hitem == IntPtr.Zero ? null : NodeFromHandle(hitem));
}
return topNode;
}
set {
if (IsHandleCreated && (value == null || value.TreeView == this)) {
// This class invariant is not quite correct -- if the selected node does not belong to this Treeview,
// selectedNode != null even though the handle is created. We will call set_SelectedNode
// to inform the handle that the selected node has been added to the TreeView.
Debug.Assert(topNode == null || topNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hnode = (value == null ? IntPtr.Zero : value.Handle);
SendMessage(NativeMethods.TVM_SELECTITEM, NativeMethods.TVGN_FIRSTVISIBLE, hnode);
topNode = null;
}
else {
topNode = value;
}
}
}
///
/// The count of fully visible nodes in the tree view. This number
/// may be greater than the number of nodes in the control.
/// The control calculates this value by dividing the height of the
/// client window by the height of an item
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewVisibleCountDescr)
]
public int VisibleCount {
get {
if (IsHandleCreated)
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETVISIBLECOUNT, 0, 0));
return 0;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeEditDescr)]
public event NodeLabelEditEventHandler BeforeLabelEdit {
add {
onBeforeLabelEdit += value;
}
remove {
onBeforeLabelEdit -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterEditDescr)]
public event NodeLabelEditEventHandler AfterLabelEdit {
add {
onAfterLabelEdit += value;
}
remove {
onAfterLabelEdit -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeCheckDescr)]
public event TreeViewCancelEventHandler BeforeCheck {
add {
onBeforeCheck += value;
}
remove {
onBeforeCheck -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterCheckDescr)]
public event TreeViewEventHandler AfterCheck {
add {
onAfterCheck += value;
}
remove {
onAfterCheck -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeCollapseDescr)]
public event TreeViewCancelEventHandler BeforeCollapse {
add {
onBeforeCollapse += value;
}
remove {
onBeforeCollapse -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterCollapseDescr)]
public event TreeViewEventHandler AfterCollapse {
add {
onAfterCollapse += value;
}
remove {
onAfterCollapse -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeExpandDescr)]
public event TreeViewCancelEventHandler BeforeExpand {
add {
onBeforeExpand += value;
}
remove {
onBeforeExpand -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterExpandDescr)]
public event TreeViewEventHandler AfterExpand {
add {
onAfterExpand += value;
}
remove {
onAfterExpand -= value;
}
}
///
/// Fires when a TreeView node needs to be drawn.
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewDrawNodeEventDescr)]
public event DrawTreeNodeEventHandler DrawNode {
add {
onDrawNode += value;
}
remove {
onDrawNode -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatAction), SRDescription(SR.ListViewItemDragDescr)]
public event ItemDragEventHandler ItemDrag {
add {
onItemDrag += value;
}
remove {
onItemDrag -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatAction), SRDescription(SR.TreeViewNodeMouseHoverDescr)]
public event TreeNodeMouseHoverEventHandler NodeMouseHover {
add {
onNodeMouseHover += value;
}
remove {
onNodeMouseHover -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeSelectDescr)]
public event TreeViewCancelEventHandler BeforeSelect {
add {
onBeforeSelect += value;
}
remove {
onBeforeSelect -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterSelectDescr)]
public event TreeViewEventHandler AfterSelect {
add {
onAfterSelect += value;
}
remove {
onAfterSelect -= value;
}
}
///
/// TreeView Onpaint.
///
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewNodeMouseClickDescr)]
public event TreeNodeMouseClickEventHandler NodeMouseClick {
add {
onNodeMouseClick += value;
}
remove {
onNodeMouseClick -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewNodeMouseDoubleClickDescr)]
public event TreeNodeMouseClickEventHandler NodeMouseDoubleClick {
add {
onNodeMouseDoubleClick += value;
}
remove {
onNodeMouseDoubleClick -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatPropertyChanged), SRDescription(SR.ControlOnRightToLeftLayoutChangedDescr)]
public event EventHandler RightToLeftLayoutChanged {
add {
onRightToLeftLayoutChanged += value;
}
remove {
onRightToLeftLayoutChanged -= value;
}
}
///
/// Disables redrawing of the tree view. A call to beginUpdate() must be
/// balanced by a following call to endUpdate(). Following a call to
/// beginUpdate(), any redrawing caused by operations performed on the
/// tree view is deferred until the call to endUpdate().
///
public void BeginUpdate() {
BeginUpdateInternal();
}
///
/// Collapses all nodes at the root level.
///
public void CollapseAll() {
root.Collapse();
}
///
///
///
/// Resets the imageList to null. We wire this method up to the imageList's
/// Dispose event, so that we don't hang onto an imageList that's gone away.
///
///
/// Resets the stateimageList to null. We wire this method up to the stateimageList's
/// Dispose event, so that we don't hang onto an stateimageList that's gone away.
///
///
///
///
/// Reenables redrawing of the tree view. A call to beginUpdate() must be
/// balanced by a following call to endUpdate(). Following a call to
/// beginUpdate(), any redrawing caused by operations performed on the
/// combo box is deferred until the call to endUpdate().
///
public void EndUpdate() {
EndUpdateInternal();
}
///
/// Expands all nodes at the root level.
///
public void ExpandAll() {
root.ExpandAll();
}
///
/// Forces the TreeView to recalculate all its nodes widths so that it updates the
/// scrollbars as appropriate.
///
///
/// Called by ToolTip to poke in that Tooltip into this ComCtl so that the Native ChildToolTip is not exposed.
///
///
/// Gives the information about which part of the treeNode is at the given point.
///
public TreeViewHitTestInfo HitTest(Point pt) {
return HitTest(pt.X, pt.Y);
}
///
/// Gives the information about which part of the treeNode is at the given x, y.
///
public TreeViewHitTestInfo HitTest(int x, int y) {
NativeMethods.TV_HITTESTINFO tvhi = new NativeMethods.TV_HITTESTINFO();
tvhi.pt_x = x;
tvhi.pt_y = y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhi);
TreeNode node = (hnode == IntPtr.Zero ? null : NodeFromHandle(hnode));
TreeViewHitTestLocations loc = (TreeViewHitTestLocations)tvhi.flags;
return (new TreeViewHitTestInfo(node, loc));
}
///
/// Defined so that a tree node can use it
///
///
///
/// Returns count of nodes at root, optionally including all subtrees.
///
public int GetNodeCount(bool includeSubTrees) {
return root.GetNodeCount(includeSubTrees);
}
///
/// Returns the TreeNode at the given location in tree view coordinates.
///
public TreeNode GetNodeAt(Point pt) {
return GetNodeAt(pt.X, pt.Y);
}
///
/// Returns the TreeNode at the given location in tree view coordinates.
///
public TreeNode GetNodeAt(int x, int y) {
NativeMethods.TV_HITTESTINFO tvhi = new NativeMethods.TV_HITTESTINFO();
tvhi.pt_x = x;
tvhi.pt_y = y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhi);
return(hnode == IntPtr.Zero ? null : NodeFromHandle(hnode));
}
private void ImageListRecreateHandle(object sender, EventArgs e) {
if (IsHandleCreated) {
IntPtr handle = (ImageList == null) ? IntPtr.Zero : ImageList.Handle;
SendMessage(NativeMethods.TVM_SETIMAGELIST, 0, handle);
}
}
private void UpdateImagesRecursive ( TreeNode node )
{
node.UpdateImage();
// VSWhidbey 208200: Iterate only through the Nodes collection rather than the
// array since an item might have been removed from the collection, and
// correspondingly "removed" from the array, but still exist in the array
// since the array isn't actually re-dimensioned down to a smaller size.
foreach (TreeNode child in node.Nodes) {
UpdateImagesRecursive(child);
}
}
private void ImageListChangedHandle(object sender, EventArgs e) {
if ((null != sender) && (sender == imageList) && IsHandleCreated) {
BeginUpdate();
foreach (TreeNode node in Nodes) {
UpdateImagesRecursive(node);
}
EndUpdate();
}
}
private void StateImageListRecreateHandle(object sender, EventArgs e) {
if (IsHandleCreated) {
IntPtr handle = IntPtr.Zero;
if (internalStateImageList != null) {
handle = internalStateImageList.Handle;
}
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, handle);
}
}
private void StateImageListChangedHandle(object sender, EventArgs e) {
if ((null != sender) && (sender == stateImageList) && IsHandleCreated) {
// Since the native treeview requires the state imagelist to be 1-indexed we need to
// re add the images if the original collection had changed.
if (stateImageList != null && stateImageList.Images.Count > 0) {
Image[] images = new Image[stateImageList.Images.Count + 1];
images[0] = stateImageList.Images[0];
for (int i = 1; i <= stateImageList.Images.Count ; i++) {
images[i] = stateImageList.Images[i -1];
}
if (internalStateImageList != null)
{
internalStateImageList.Images.Clear();
internalStateImageList.Images.AddRange(images);
}
else
{
internalStateImageList = new ImageList();
internalStateImageList.Images.AddRange(images);
}
Debug.Assert(internalStateImageList != null, "Why are changing images when the Imagelist is null?");
if (internalStateImageList != null)
{
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, internalStateImageList.Handle);
}
}
else //stateImageList == null || stateImageList.Images.Count = 0;
{
UpdateCheckedState(root, true);
}
}
}
///
///
/// Overridden to handle RETURN key.
///
///
protected override bool IsInputKey(Keys keyData) {
// If in edit mode, treat Return as an input key, so the form doesn't grab it
// and treat it as clicking the Form.AcceptButton. Similarly for Escape
// and Form.CancelButton.
if (editNode != null && (keyData & Keys.Alt) == 0) {
switch (keyData & Keys.KeyCode) {
case Keys.Return:
case Keys.Escape:
case Keys.PageUp:
case Keys.PageDown:
case Keys.Home:
case Keys.End:
return true;
}
}
return base.IsInputKey(keyData);
}
///
/// Note this can be null - particularly if any windows messages get generated during
/// the insertion of a tree node (TVM_INSERTITEM)
///
///
/// Fires the DrawNode event.
///
protected virtual void OnDrawNode(DrawTreeNodeEventArgs e) {
if (onDrawNode != null) onDrawNode(this, e);
}
///
///
///
///
///
/// We keep track of if we've hovered already so we don't fire multiple hover events
///
///
protected override void OnMouseLeave(EventArgs e) {
hoveredAlready = false;
base.OnMouseLeave(e);
}
///
/// In order for the MouseHover event to fire for each item in a TreeView,
/// the node the mouse is hovering over is found. Each time a new node is hovered
/// over a new event is raised.
///
protected override void OnMouseHover(EventArgs e) {
/// Hover events need to be caught for each node
/// within the TreeView so the appropriate
/// NodeHovered event can be raised.
NativeMethods.TV_HITTESTINFO tvhip = new NativeMethods.TV_HITTESTINFO();
Point pos = Cursor.Position;
pos = PointToClientInternal(pos);
tvhip.pt_x = pos.X;
tvhip.pt_y = pos.Y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhip);
if (hnode != IntPtr.Zero && ((tvhip.flags & NativeMethods.TVHT_ONITEM) != 0)) {
TreeNode tn = NodeFromHandle(hnode);
if (tn != prevHoveredNode && tn != null) {
OnNodeMouseHover( new TreeNodeMouseHoverEventArgs(tn));
prevHoveredNode = tn;
}
}
if (!hoveredAlready) {
base.OnMouseHover(e);
hoveredAlready = true;
}
ResetMouseEventArgs();
}
///
/// Fires the beforeLabelEdit event.
///
protected virtual void OnBeforeLabelEdit(NodeLabelEditEventArgs e) {
if (onBeforeLabelEdit != null) onBeforeLabelEdit(this, e);
}
///
/// Fires the afterLabelEdit event.
///
protected virtual void OnAfterLabelEdit(NodeLabelEditEventArgs e) {
if (onAfterLabelEdit != null) onAfterLabelEdit(this, e);
}
///
/// Fires the beforeCheck event.
///
protected virtual void OnBeforeCheck(TreeViewCancelEventArgs e) {
if (onBeforeCheck != null) onBeforeCheck(this, e);
}
///
/// Fires the afterCheck event.
///
protected virtual void OnAfterCheck(TreeViewEventArgs e) {
if (onAfterCheck != null) onAfterCheck(this, e);
}
///
/// Fires the beforeCollapse event.
///
protected internal virtual void OnBeforeCollapse(TreeViewCancelEventArgs e) {
if (onBeforeCollapse != null) onBeforeCollapse(this, e);
}
///
/// Fires the afterCollapse event.
///
protected internal virtual void OnAfterCollapse(TreeViewEventArgs e) {
if (onAfterCollapse != null) onAfterCollapse(this, e);
}
///
/// Fires the beforeExpand event.
///
protected virtual void OnBeforeExpand(TreeViewCancelEventArgs e) {
if (onBeforeExpand != null) onBeforeExpand(this, e);
}
///
/// Fires the afterExpand event.
///
protected virtual void OnAfterExpand(TreeViewEventArgs e) {
if (onAfterExpand != null) onAfterExpand(this, e);
}
///
/// Fires the ItemDrag event.
///
protected virtual void OnItemDrag(ItemDragEventArgs e) {
if (onItemDrag != null) onItemDrag(this, e);
}
///
/// Fires the NodeMouseHover event.
///
protected virtual void OnNodeMouseHover(TreeNodeMouseHoverEventArgs e) {
if (onNodeMouseHover != null) onNodeMouseHover(this, e);
}
///
/// Fires the beforeSelect event.
///
protected virtual void OnBeforeSelect(TreeViewCancelEventArgs e) {
if (onBeforeSelect != null) onBeforeSelect(this, e);
}
///
/// Fires the afterSelect event.
///
protected virtual void OnAfterSelect(TreeViewEventArgs e) {
if (onAfterSelect != null) onAfterSelect(this, e);
}
///
/// Fires the onNodeMouseClick event.
///
protected virtual void OnNodeMouseClick(TreeNodeMouseClickEventArgs e) {
if (onNodeMouseClick != null) onNodeMouseClick(this, e);
}
///
/// Fires the onNodeMouseDoubleClick event.
///
protected virtual void OnNodeMouseDoubleClick(TreeNodeMouseClickEventArgs e) {
if (onNodeMouseDoubleClick != null) onNodeMouseDoubleClick(this, e);
}
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// [To be supplied.]
///
[EditorBrowsable(EditorBrowsableState.Advanced)]
protected virtual void OnRightToLeftLayoutChanged(EventArgs e) {
if (GetAnyDisposingInHierarchy()) {
return;
}
if (RightToLeft == RightToLeft.Yes) {
RecreateHandle();
}
if (onRightToLeftLayoutChanged != null) {
onRightToLeftLayoutChanged(this, e);
}
}
// Refresh the nodes by clearing the tree and adding the nodes back again
//
private void RefreshNodes() {
TreeNode[] nodes = new TreeNode[Nodes.Count];
Nodes.CopyTo(nodes, 0);
Nodes.Clear();
Nodes.AddRange(nodes);
}
///
/// This resets the indentation to the system default.
///
private void ResetIndent() {
indent = -1;
// is this overkill?
RecreateHandle();
}
///
/// This resets the item height to the system default.
///
private void ResetItemHeight() {
itemHeight = -1;
RecreateHandle();
}
///
/// Retrieves true if the indent should be persisted in code gen.
///
private bool ShouldSerializeIndent() {
return(indent != -1);
}
///
/// Retrieves true if the itemHeight should be persisted in code gen.
///
private bool ShouldSerializeItemHeight() {
return(itemHeight != -1);
}
private bool ShouldSerializeSelectedImageIndex() {
if (imageList != null) {
return (SelectedImageIndex != 0);
}
return (SelectedImageIndex != -1);
}
private bool ShouldSerializeImageIndex() {
if (imageList != null) {
return (ImageIndex != 0);
}
return (ImageIndex != -1);
}
///
/// Updated the sorted order
///
public void Sort() {
Sorted = true;
RefreshNodes();
}
///
/// Returns a string representation for this control.
///
///
/// Performs custom draw handling
///
///
/// Generates colors for each item. This can be overridden to provide colors on a per state/per node
/// basis, rather than using the ForeColor/BackColor/NodeFont properties on TreeNode.
///
///
///
///
///
/// Shows the context menu for the Treenode.
///
///
///
///
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
/*
*/
namespace System.Windows.Forms {
using System.Runtime.Remoting;
using System.Runtime.InteropServices;
using System.Diagnostics;
using System.Diagnostics.CodeAnalysis;
using System;
using System.Security.Permissions;
using System.Security;
using System.Drawing;
using System.Windows.Forms.Internal;
using System.Drawing.Design;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Collections;
using Microsoft.Win32;
using System.Reflection;
using System.Windows.Forms.Layout;
using System.Globalization;
using System.Windows.Forms.VisualStyles;
///
///
/// Displays a hierarchical list of items, or nodes. Each
/// node includes a caption and an optional bitmap. The user can select a node. If
/// it has sub-nodes, the user can collapse or expand the node.
///
///
///
[
ComVisible(true),
ClassInterface(ClassInterfaceType.AutoDispatch),
DefaultProperty("Nodes"),
DefaultEvent("AfterSelect"),
Docking(DockingBehavior.Ask),
Designer("System.Windows.Forms.Design.TreeViewDesigner, " + AssemblyRef.SystemDesign),
SRDescription(SR.DescriptionTreeView)
]
public class TreeView : Control {
private static readonly int MaxIndent = 32000; // Maximum allowable TreeView indent
private static readonly string backSlash = "\\";
private const int DefaultTreeViewIndent = 19;
private DrawTreeNodeEventHandler onDrawNode;
private NodeLabelEditEventHandler onBeforeLabelEdit;
private NodeLabelEditEventHandler onAfterLabelEdit;
private TreeViewCancelEventHandler onBeforeCheck;
private TreeViewEventHandler onAfterCheck;
private TreeViewCancelEventHandler onBeforeCollapse;
private TreeViewEventHandler onAfterCollapse;
private TreeViewCancelEventHandler onBeforeExpand;
private TreeViewEventHandler onAfterExpand;
private TreeViewCancelEventHandler onBeforeSelect;
private TreeViewEventHandler onAfterSelect;
private ItemDragEventHandler onItemDrag;
private TreeNodeMouseHoverEventHandler onNodeMouseHover;
private EventHandler onRightToLeftLayoutChanged;
internal TreeNode selectedNode = null;
private ImageList.Indexer imageIndexer;
private ImageList.Indexer selectedImageIndexer;
private bool setOddHeight = false;
private TreeNode prevHoveredNode = null;
private bool hoveredAlready = false;
private bool rightToLeftLayout = false;
[SuppressMessage("Microsoft.Reliability", "CA2006:UseSafeHandleToEncapsulateNativeResources")]
private IntPtr hNodeMouseDown = IntPtr.Zero;//ensures we fire nodeclick on the correct node
private const int TREEVIEWSTATE_hideSelection = 0x00000001;
private const int TREEVIEWSTATE_labelEdit = 0x00000002;
private const int TREEVIEWSTATE_scrollable = 0x00000004;
private const int TREEVIEWSTATE_checkBoxes = 0x00000008;
private const int TREEVIEWSTATE_showLines = 0x00000010;
private const int TREEVIEWSTATE_showPlusMinus = 0x00000020;
private const int TREEVIEWSTATE_showRootLines = 0x00000040;
private const int TREEVIEWSTATE_sorted = 0x00000080;
private const int TREEVIEWSTATE_hotTracking = 0x00000100;
private const int TREEVIEWSTATE_fullRowSelect = 0x00000200;
private const int TREEVIEWSTATE_showNodeToolTips = 0x00000400;
private const int TREEVIEWSTATE_doubleclickFired = 0x00000800;
private const int TREEVIEWSTATE_mouseUpFired = 0x00001000;
private const int TREEVIEWSTATE_showTreeViewContextMenu = 0x00002000;
private const int TREEVIEWSTATE_lastControlValidated = 0x00004000;
private const int TREEVIEWSTATE_stopResizeWindowMsgs = 0x00008000;//VSWhidbey 466949
private const int TREEVIEWSTATE_ignoreSelects = 0x00010000;//VSWhidbey 384294, 490763.
// PERF: take all the bools and put them into a state variable
private System.Collections.Specialized.BitVector32 treeViewState; // see TREEVIEWSTATE_ consts above
///
/// Creates a TreeView control
///
public TreeView()
: base() {
this.treeViewState = new System.Collections.Specialized.BitVector32(TREEVIEWSTATE_showRootLines |
TREEVIEWSTATE_showPlusMinus |
TREEVIEWSTATE_showLines |
TREEVIEWSTATE_scrollable |
TREEVIEWSTATE_hideSelection);
root = new TreeNode(this);
// TreeView must always have an ImageIndex.
SelectedImageIndexer.Index = 0;
ImageIndexer.Index = 0;
SetStyle(ControlStyles.UserPaint, false);
SetStyle(ControlStyles.StandardClick, false);
SetStyle(ControlStyles.UseTextForAccessibility, false);
}
///
/// The background color for this control. Specifying null for
/// this parameter sets the
/// control's background color to its parent's background color.
///
public override Color BackColor {
get {
if (ShouldSerializeBackColor()) {
return base.BackColor;
}
else {
return SystemColors.Window;
}
}
set {
base.BackColor = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETBKCOLOR, 0, ColorTranslator.ToWin32(BackColor));
// This is to get around a problem in the comctl control where the lines
// connecting nodes don't get the new BackColor. This messages forces
// reconstruction of the line bitmaps without changing anything else.
SendMessage(NativeMethods.TVM_SETINDENT, Indent, 0);
}
}
}
///
/// [To be supplied.]
///
///
/// [To be supplied.]
///
///
/// The border style of the window.
///
[
SRCategory(SR.CatAppearance),
DefaultValue(BorderStyle.Fixed3D),
DispId(NativeMethods.ActiveX.DISPID_BORDERSTYLE),
SRDescription(SR.borderStyleDescr)
]
public BorderStyle BorderStyle {
get {
return borderStyle;
}
set {
if (borderStyle != value) {
//verify that 'value' is a valid enum type...
//valid values are 0x0 to 0x2
if (!ClientUtils.IsEnumValid(value, (int)value, (int)BorderStyle.None, (int)BorderStyle.Fixed3D))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(BorderStyle));
}
borderStyle = value;
UpdateStyles();
}
}
}
///
/// The value of the CheckBoxes property. The CheckBoxes
/// property determines if check boxes are shown next to node in the
/// tree view.
///
[
SRCategory(SR.CatAppearance),
DefaultValue(false),
SRDescription(SR.TreeViewCheckBoxesDescr)
]
public bool CheckBoxes {
get {
return treeViewState[TREEVIEWSTATE_checkBoxes];
}
set {
if (CheckBoxes != value) {
treeViewState[TREEVIEWSTATE_checkBoxes] = value;
if (IsHandleCreated) {
// Going from true to false requires recreation
if (CheckBoxes) {
UpdateStyles();
} else {
// Reset the Checked state after setting the checkboxes (this was Everett behavior)
// The implementation of the TreeNode.Checked property has changed in Whidbey
// So we need to explicit set the Checked state to false to keep the everett behavior.
UpdateCheckedState(root, false);
RecreateHandle();
}
}
}
}
}
///
///
///
/// Deriving classes can override this to configure a default size for their control.
/// This is more efficient than setting the size in the control's constructor.
///
protected override Size DefaultSize {
get {
return new Size(121, 97);
}
}
///
/// This property is overridden and hidden from statement completion
/// on controls that are based on Win32 Native Controls.
///
[EditorBrowsable(EditorBrowsableState.Never)]
protected override bool DoubleBuffered {
get {
return base.DoubleBuffered;
}
set {
base.DoubleBuffered = value;
}
}
///
/// The current foreground color for this control, which is the
/// color the control uses to draw its text.
///
public override Color ForeColor {
get {
if (ShouldSerializeForeColor()) {
return base.ForeColor;
}
else {
return SystemColors.WindowText;
}
}
set {
base.ForeColor = value;
if (IsHandleCreated)
SendMessage(NativeMethods.TVM_SETTEXTCOLOR, 0, ColorTranslator.ToWin32(ForeColor));
}
}
///
/// Determines whether the selection highlight spans across the width of the TreeView.
/// This property will have no effect if ShowLines is true.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewFullRowSelectDescr)
]
public bool FullRowSelect {
get { return treeViewState[TREEVIEWSTATE_fullRowSelect];}
set {
if (FullRowSelect != value) {
treeViewState[TREEVIEWSTATE_fullRowSelect] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The HideSelection property specifies whether the selected node will
/// be highlighted even when the TreeView loses focus.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewHideSelectionDescr)
]
public bool HideSelection {
get {
return treeViewState[TREEVIEWSTATE_hideSelection];
}
set {
if (HideSelection != value) {
treeViewState[TREEVIEWSTATE_hideSelection] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The value of the HotTracking property. The HotTracking
/// property determines if nodes are highlighted as the mousepointer
/// passes over them.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewHotTrackingDescr)
]
public bool HotTracking {
get {
return treeViewState[TREEVIEWSTATE_hotTracking];
}
set {
if (HotTracking != value) {
treeViewState[TREEVIEWSTATE_hotTracking] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
DefaultValue(-1),
SRCategory(SR.CatBehavior),
Localizable(true),
RefreshProperties(RefreshProperties.Repaint),
TypeConverterAttribute(typeof(NoneExcludedImageIndexConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
SRDescription(SR.TreeViewImageIndexDescr),
RelatedImageList("ImageList")
]
public int ImageIndex {
get {
if (imageList == null) {
return -1;
}
if (ImageIndexer.Index >= imageList.Images.Count) {
return Math.Max(0, imageList.Images.Count - 1);
}
return ImageIndexer.Index;
}
set {
// If (none) is selected in the image index editor, we'll just adjust this to
// mean image index 0. This is because a treeview must always have an image index -
// even if no imagelist exists we want the image index to be 0.
//
if (value == -1) {
value = 0;
}
if (value < 0) {
throw new ArgumentOutOfRangeException("ImageIndex", SR.GetString(SR.InvalidLowBoundArgumentEx, "ImageIndex", value.ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (ImageIndexer.Index != value) {
ImageIndexer.Index = value;
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
Localizable(true),
TypeConverterAttribute(typeof(ImageKeyConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
DefaultValue(""),
RefreshProperties(RefreshProperties.Repaint),
SRDescription(SR.TreeViewImageKeyDescr),
RelatedImageList("ImageList")
]
public string ImageKey {
get {
return ImageIndexer.Key;
}
set {
if (ImageIndexer.Key != value) {
ImageIndexer.Key = value;
if (String.IsNullOrEmpty(value) || value.Equals(SR.GetString(SR.toStringNone))) {
ImageIndex = (ImageList != null) ? 0:-1;
}
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// Returns the image list control that is bound to the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(null),
SRDescription(SR.TreeViewImageListDescr),
RefreshProperties(RefreshProperties.Repaint)
]
public ImageList ImageList {
get {
return imageList;
}
set {
if (value != imageList) {
DetachImageListHandlers();
imageList = value;
AttachImageListHandlers();
// Update TreeView's images
//
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETIMAGELIST, 0,
value==null? IntPtr.Zero: value.Handle);
if (StateImageList != null && StateImageList.Images.Count > 0) {
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE,
internalStateImageList.Handle);
}
}
UpdateCheckedState(root, true);
}
}
}
private void AttachImageListHandlers() {
if (imageList != null) {
//NOTE: any handlers added here should be removed in DetachImageListHandlers
imageList.RecreateHandle += new EventHandler(ImageListRecreateHandle);
imageList.Disposed += new EventHandler(DetachImageList);
imageList.ChangeHandle += new EventHandler(ImageListChangedHandle);
}
}
private void DetachImageListHandlers() {
if (imageList != null) {
imageList.RecreateHandle -= new EventHandler(ImageListRecreateHandle);
imageList.Disposed -= new EventHandler(DetachImageList);
imageList.ChangeHandle -= new EventHandler(ImageListChangedHandle);
}
}
private void AttachStateImageListHandlers() {
if (stateImageList != null) {
//NOTE: any handlers added here should be removed in DetachStateImageListHandlers
stateImageList.RecreateHandle += new EventHandler(StateImageListRecreateHandle);
stateImageList.Disposed += new EventHandler(DetachStateImageList);
stateImageList.ChangeHandle += new EventHandler(StateImageListChangedHandle);
}
}
private void DetachStateImageListHandlers() {
if (stateImageList != null) {
stateImageList.RecreateHandle -= new EventHandler(StateImageListRecreateHandle);
stateImageList.Disposed -= new EventHandler(DetachStateImageList);
stateImageList.ChangeHandle -= new EventHandler(StateImageListChangedHandle);
}
}
///
/// Returns the state image list control that is bound to the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(null),
SRDescription(SR.TreeViewStateImageListDescr)
]
public ImageList StateImageList {
get {
return stateImageList;
}
set {
if (value != stateImageList) {
DetachStateImageListHandlers();
stateImageList = value;
if (stateImageList != null && stateImageList.Images.Count > 0) {
Image[] images = new Image[stateImageList.Images.Count + 1];
images[0] = stateImageList.Images[0];
for (int i = 1; i <= stateImageList.Images.Count ; i++) {
images[i] = stateImageList.Images[i -1];
}
internalStateImageList = new ImageList();
internalStateImageList.Images.AddRange(images);
}
AttachStateImageListHandlers();
// Update TreeView's images
//
if (IsHandleCreated)
{
if (stateImageList != null && stateImageList.Images.Count > 0)
{
Debug.Assert(internalStateImageList != null, "internalStateImageList is null!!");
if (internalStateImageList != null)
{
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, internalStateImageList.Handle);
}
}
// We need to update the checks
// and stateimage value for each node.
UpdateCheckedState(root, true);
if((value == null || stateImageList.Images.Count == 0) && CheckBoxes) {
// Requires Handle Recreate to force on the checkBoxes and states..
RecreateHandle();
}
else {
// The TreeView shows up the state imageList after sending this message even if the nodes dont have any stateImageIndex set.
// In order to avoid that we refresh nodes which would "reset" the images to none.
// This causes flicker but gives us the right behavior
RefreshNodes();
}
}
}
}
}
///
/// The indentation level in pixels.
///
[
Localizable(true),
SRCategory(SR.CatBehavior),
SRDescription(SR.TreeViewIndentDescr)
]
public int Indent {
get {
if (indent != -1) {
return indent;
}
else if (IsHandleCreated) {
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETINDENT, 0, 0));
}
return DefaultTreeViewIndent;
}
set {
if (indent != value) {
if (value < 0) {
throw new ArgumentOutOfRangeException("Indent", SR.GetString(SR.InvalidLowBoundArgumentEx, "Indent", (value).ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (value > MaxIndent) {
throw new ArgumentOutOfRangeException("Indent", SR.GetString(SR.InvalidHighBoundArgumentEx, "Indent", (value).ToString(CultureInfo.CurrentCulture), (MaxIndent).ToString(CultureInfo.CurrentCulture)));
}
indent = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETINDENT, value, 0);
indent = unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETINDENT, 0, 0));
}
}
}
}
///
/// The height of every item in the tree view, in pixels.
///
[
SRCategory(SR.CatAppearance),
SRDescription(SR.TreeViewItemHeightDescr)
]
public int ItemHeight {
get {
if (itemHeight != -1) {
return itemHeight;
}
if (IsHandleCreated) {
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETITEMHEIGHT, 0, 0));
}
else {
if (CheckBoxes && (DrawMode == TreeViewDrawMode.OwnerDrawAll)) {
return Math.Max(16, FontHeight + 3);
}
return FontHeight + 3;
}
}
set {
if (itemHeight != value) {
if (value < 1) {
throw new ArgumentOutOfRangeException("ItemHeight", SR.GetString(SR.InvalidLowBoundArgumentEx, "ItemHeight", (value).ToString(CultureInfo.CurrentCulture), (1).ToString(CultureInfo.CurrentCulture)));
}
if (value >= Int16.MaxValue) {
throw new ArgumentOutOfRangeException("ItemHeight", SR.GetString(SR.InvalidHighBoundArgument, "ItemHeight", (value).ToString(CultureInfo.CurrentCulture), Int16.MaxValue.ToString(CultureInfo.CurrentCulture)));
}
itemHeight = value;
if (IsHandleCreated) {
if (itemHeight % 2 != 0) {
setOddHeight = true;
try {
RecreateHandle();
}
finally {
setOddHeight = false;
}
}
SendMessage(NativeMethods.TVM_SETITEMHEIGHT, value, 0);
itemHeight = unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETITEMHEIGHT, 0, 0));
}
}
}
}
///
/// The LabelEdit property determines if the label text
/// of nodes in the tree view is editable.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewLabelEditDescr)
]
public bool LabelEdit {
get {
return treeViewState[TREEVIEWSTATE_labelEdit];
}
set {
if (LabelEdit != value) {
treeViewState[TREEVIEWSTATE_labelEdit] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// This is the color of the lines that connect the nodes of the Treeview.
///
[
SRCategory(SR.CatBehavior),
SRDescription(SR.TreeViewLineColorDescr),
DefaultValue(typeof(Color), "Black")
]
public Color LineColor {
get {
if (IsHandleCreated) {
int intColor = unchecked((int)(long)SendMessage(NativeMethods.TVM_GETLINECOLOR, 0, 0));
return ColorTranslator.FromWin32(intColor);
}
return lineColor;
}
set {
if (lineColor != value) {
lineColor = value;
if (IsHandleCreated) {
SendMessage(NativeMethods.TVM_SETLINECOLOR, 0, ColorTranslator.ToWin32(lineColor));
}
}
}
}
///
/// The collection of nodes associated with this TreeView control
///
[
SRCategory(SR.CatBehavior),
DesignerSerializationVisibility(DesignerSerializationVisibility.Content),
Localizable(true),
SRDescription(SR.TreeViewNodesDescr),
MergableProperty(false)
]
public TreeNodeCollection Nodes {
get {
if (nodes == null) {
nodes = new TreeNodeCollection(root);
}
return nodes;
}
}
///
///
/// Indicates the drawing mode for the tree view.
///
///
[
SRCategory(SR.CatBehavior),
DefaultValue(TreeViewDrawMode.Normal),
SRDescription(SR.TreeViewDrawModeDescr)
]
public TreeViewDrawMode DrawMode {
get {
return drawMode;
}
set {
//valid values are 0x0 to 0x2
if (!ClientUtils.IsEnumValid(value, (int)value, (int)TreeViewDrawMode.Normal, (int)TreeViewDrawMode.OwnerDrawAll))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(TreeViewDrawMode));
}
if (drawMode != value) {
drawMode = value;
Invalidate();
// We need to invalidate when the Control resizes when the we support custom draw.
if (DrawMode == TreeViewDrawMode.OwnerDrawAll)
{
SetStyle(ControlStyles.ResizeRedraw, true);
}
}
}
}
///
/// The delimeter string used by TreeNode.getFullPath().
///
[
SRCategory(SR.CatBehavior),
DefaultValue("\\"),
SRDescription(SR.TreeViewPathSeparatorDescr)
]
public string PathSeparator {
get {
return pathSeparator;
}
set {
pathSeparator = value;
}
}
///
///
/// [To be supplied.]
///
///
[
Browsable(false),
EditorBrowsable(EditorBrowsableState.Never),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
]
public new Padding Padding {
get { return base.Padding; }
set { base.Padding = value;}
}
[
Browsable(false),
EditorBrowsable(EditorBrowsableState.Never)
]
public new event EventHandler PaddingChanged {
add { base.PaddingChanged += value; }
remove { base.PaddingChanged -= value; }
}
///
/// This is used for international applications where the language
/// is written from RightToLeft. When this property is true,
// and the RightToLeft is true, mirroring will be turned on on the form, and
/// control placement and text will be from right to left.
///
[
SRCategory(SR.CatAppearance),
Localizable(true),
DefaultValue(false),
SRDescription(SR.ControlRightToLeftLayoutDescr)
]
public virtual bool RightToLeftLayout {
get {
return rightToLeftLayout;
}
set {
if (value != rightToLeftLayout) {
rightToLeftLayout = value;
using(new LayoutTransaction(this, this, PropertyNames.RightToLeftLayout)) {
OnRightToLeftLayoutChanged(EventArgs.Empty);
}
}
}
}
///
/// [To be supplied.]
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewScrollableDescr)
]
public bool Scrollable {
get {
return treeViewState[TREEVIEWSTATE_scrollable];
}
set {
if (Scrollable != value) {
treeViewState[TREEVIEWSTATE_scrollable] = value;
RecreateHandle();
}
}
}
///
/// The image index that a node will display when selected.
/// The index applies to the ImageList referred to by the imageList property,
///
[
DefaultValue(-1),
SRCategory(SR.CatBehavior),
TypeConverterAttribute(typeof(NoneExcludedImageIndexConverter)),
Localizable(true),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
SRDescription(SR.TreeViewSelectedImageIndexDescr),
RelatedImageList("ImageList")
]
public int SelectedImageIndex {
get {
if (imageList == null) {
return -1;
}
if (SelectedImageIndexer.Index >= imageList.Images.Count) {
return Math.Max(0, imageList.Images.Count - 1);
}
return SelectedImageIndexer.Index;
}
set {
// If (none) is selected in the image index editor, we'll just adjust this to
// mean image index 0. This is because a treeview must always have an image index -
// even if no imagelist exists we want the image index to be 0.
//
if (value == -1) {
value = 0;
}
if (value < 0) {
throw new ArgumentOutOfRangeException("SelectedImageIndex", SR.GetString(SR.InvalidLowBoundArgumentEx, "SelectedImageIndex", value.ToString(CultureInfo.CurrentCulture), (0).ToString(CultureInfo.CurrentCulture)));
}
if (SelectedImageIndexer.Index != value) {
SelectedImageIndexer.Index = value;
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The default image index for nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
Localizable(true),
TypeConverterAttribute(typeof(ImageKeyConverter)),
Editor("System.Windows.Forms.Design.ImageIndexEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
DefaultValue(""),
RefreshProperties(RefreshProperties.Repaint),
SRDescription(SR.TreeViewSelectedImageKeyDescr),
RelatedImageList("ImageList")
]
public string SelectedImageKey {
get {
return SelectedImageIndexer.Key;
}
set {
if (SelectedImageIndexer.Key != value) {
SelectedImageIndexer.Key = value;
if (String.IsNullOrEmpty(value) || value.Equals(SR.GetString(SR.toStringNone))) {
SelectedImageIndex = (ImageList != null) ? 0 : -1;
}
if (IsHandleCreated) {
RecreateHandle();
}
}
}
}
///
/// The currently selected tree node, or null if nothing is selected.
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewSelectedNodeDescr)
]
public TreeNode SelectedNode {
get {
if (IsHandleCreated) {
Debug.Assert(selectedNode == null || selectedNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hItem = SendMessage(NativeMethods.TVM_GETNEXTITEM, NativeMethods.TVGN_CARET, 0);
if (hItem == IntPtr.Zero)
return null;
return NodeFromHandle(hItem);
}
else if (selectedNode != null && selectedNode.TreeView == this) {
return selectedNode;
}
else {
return null;
}
}
set {
if (IsHandleCreated && (value == null || value.TreeView == this)) {
// This class invariant is not quite correct -- if the selected node does not belong to this Treeview,
// selectedNode != null even though the handle is created. We will call set_SelectedNode
// to inform the handle that the selected node has been added to the TreeView.
Debug.Assert(selectedNode == null || selectedNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hnode = (value == null ? IntPtr.Zero : value.Handle);
SendMessage(NativeMethods.TVM_SELECTITEM, NativeMethods.TVGN_CARET, hnode);
selectedNode = null;
}
else {
selectedNode = value;
}
}
}
///
/// The ShowLines property determines if lines are drawn between
/// nodes in the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowLinesDescr)
]
public bool ShowLines {
get {
return treeViewState[TREEVIEWSTATE_showLines];
}
set {
if (ShowLines != value) {
treeViewState[TREEVIEWSTATE_showLines] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The ShowLines property determines whether or not the tooltips willbe displayed on the nodes
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewShowShowNodeToolTipsDescr)
]
public bool ShowNodeToolTips {
get {
return treeViewState[TREEVIEWSTATE_showNodeToolTips];
}
set {
if (ShowNodeToolTips != value) {
treeViewState[TREEVIEWSTATE_showNodeToolTips] = value;
if (ShowNodeToolTips)
RecreateHandle();
}
}
}
///
/// The ShowPlusMinus property determines if the "plus/minus"
/// expand button is shown next to tree nodes that have children.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowPlusMinusDescr)
]
public bool ShowPlusMinus {
get {
return treeViewState[TREEVIEWSTATE_showPlusMinus];
}
set {
if (ShowPlusMinus != value) {
treeViewState[TREEVIEWSTATE_showPlusMinus] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// Determines if lines are draw between nodes at the root of
/// the tree view.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(true),
SRDescription(SR.TreeViewShowRootLinesDescr)
]
public bool ShowRootLines {
get { return treeViewState[TREEVIEWSTATE_showRootLines];}
set {
if (ShowRootLines != value) {
treeViewState[TREEVIEWSTATE_showRootLines] = value;
if (IsHandleCreated) {
UpdateStyles();
}
}
}
}
///
/// The Sorted property determines if nodes in the tree view are sorted.
///
[
SRCategory(SR.CatBehavior),
DefaultValue(false),
SRDescription(SR.TreeViewSortedDescr),
Browsable(false), EditorBrowsable(EditorBrowsableState.Never)
]
public bool Sorted {
get {
return treeViewState[TREEVIEWSTATE_sorted];
}
set {
if (Sorted != value) {
treeViewState[TREEVIEWSTATE_sorted] = value;
if (Sorted && TreeViewNodeSorter == null && Nodes.Count >= 1) {
RefreshNodes();
}
}
}
}
///
/// The sorting comparer for this TreeView.
///
[
SRCategory(SR.CatBehavior),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewNodeSorterDescr)
]
public IComparer TreeViewNodeSorter {
get {
return treeViewNodeSorter;
}
set {
if (treeViewNodeSorter != value) {
treeViewNodeSorter = value;
if (value != null) {
Sort();
}
}
}
}
///
/// [To be supplied.]
///
[Browsable(false), EditorBrowsable(EditorBrowsableState.Never), Bindable(false)]
public override string Text {
get {
return base.Text;
}
set {
base.Text = value;
}
}
///
/// The first visible node in the TreeView. Initially
/// the first root node is at the top of the TreeView, but if the
/// contents have been scrolled another node may be at the top.
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewTopNodeDescr)
]
public TreeNode TopNode {
get {
if (IsHandleCreated) {
IntPtr hitem = SendMessage(NativeMethods.TVM_GETNEXTITEM, NativeMethods.TVGN_FIRSTVISIBLE, 0);
return(hitem == IntPtr.Zero ? null : NodeFromHandle(hitem));
}
return topNode;
}
set {
if (IsHandleCreated && (value == null || value.TreeView == this)) {
// This class invariant is not quite correct -- if the selected node does not belong to this Treeview,
// selectedNode != null even though the handle is created. We will call set_SelectedNode
// to inform the handle that the selected node has been added to the TreeView.
Debug.Assert(topNode == null || topNode.TreeView != this, "handle is created, but we're still caching selectedNode");
IntPtr hnode = (value == null ? IntPtr.Zero : value.Handle);
SendMessage(NativeMethods.TVM_SELECTITEM, NativeMethods.TVGN_FIRSTVISIBLE, hnode);
topNode = null;
}
else {
topNode = value;
}
}
}
///
/// The count of fully visible nodes in the tree view. This number
/// may be greater than the number of nodes in the control.
/// The control calculates this value by dividing the height of the
/// client window by the height of an item
///
[
SRCategory(SR.CatAppearance),
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
SRDescription(SR.TreeViewVisibleCountDescr)
]
public int VisibleCount {
get {
if (IsHandleCreated)
return unchecked( (int) (long)SendMessage(NativeMethods.TVM_GETVISIBLECOUNT, 0, 0));
return 0;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeEditDescr)]
public event NodeLabelEditEventHandler BeforeLabelEdit {
add {
onBeforeLabelEdit += value;
}
remove {
onBeforeLabelEdit -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterEditDescr)]
public event NodeLabelEditEventHandler AfterLabelEdit {
add {
onAfterLabelEdit += value;
}
remove {
onAfterLabelEdit -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeCheckDescr)]
public event TreeViewCancelEventHandler BeforeCheck {
add {
onBeforeCheck += value;
}
remove {
onBeforeCheck -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterCheckDescr)]
public event TreeViewEventHandler AfterCheck {
add {
onAfterCheck += value;
}
remove {
onAfterCheck -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeCollapseDescr)]
public event TreeViewCancelEventHandler BeforeCollapse {
add {
onBeforeCollapse += value;
}
remove {
onBeforeCollapse -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterCollapseDescr)]
public event TreeViewEventHandler AfterCollapse {
add {
onAfterCollapse += value;
}
remove {
onAfterCollapse -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeExpandDescr)]
public event TreeViewCancelEventHandler BeforeExpand {
add {
onBeforeExpand += value;
}
remove {
onBeforeExpand -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterExpandDescr)]
public event TreeViewEventHandler AfterExpand {
add {
onAfterExpand += value;
}
remove {
onAfterExpand -= value;
}
}
///
/// Fires when a TreeView node needs to be drawn.
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewDrawNodeEventDescr)]
public event DrawTreeNodeEventHandler DrawNode {
add {
onDrawNode += value;
}
remove {
onDrawNode -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatAction), SRDescription(SR.ListViewItemDragDescr)]
public event ItemDragEventHandler ItemDrag {
add {
onItemDrag += value;
}
remove {
onItemDrag -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatAction), SRDescription(SR.TreeViewNodeMouseHoverDescr)]
public event TreeNodeMouseHoverEventHandler NodeMouseHover {
add {
onNodeMouseHover += value;
}
remove {
onNodeMouseHover -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewBeforeSelectDescr)]
public event TreeViewCancelEventHandler BeforeSelect {
add {
onBeforeSelect += value;
}
remove {
onBeforeSelect -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewAfterSelectDescr)]
public event TreeViewEventHandler AfterSelect {
add {
onAfterSelect += value;
}
remove {
onAfterSelect -= value;
}
}
///
/// TreeView Onpaint.
///
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewNodeMouseClickDescr)]
public event TreeNodeMouseClickEventHandler NodeMouseClick {
add {
onNodeMouseClick += value;
}
remove {
onNodeMouseClick -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatBehavior), SRDescription(SR.TreeViewNodeMouseDoubleClickDescr)]
public event TreeNodeMouseClickEventHandler NodeMouseDoubleClick {
add {
onNodeMouseDoubleClick += value;
}
remove {
onNodeMouseDoubleClick -= value;
}
}
///
/// [To be supplied.]
///
[SRCategory(SR.CatPropertyChanged), SRDescription(SR.ControlOnRightToLeftLayoutChangedDescr)]
public event EventHandler RightToLeftLayoutChanged {
add {
onRightToLeftLayoutChanged += value;
}
remove {
onRightToLeftLayoutChanged -= value;
}
}
///
/// Disables redrawing of the tree view. A call to beginUpdate() must be
/// balanced by a following call to endUpdate(). Following a call to
/// beginUpdate(), any redrawing caused by operations performed on the
/// tree view is deferred until the call to endUpdate().
///
public void BeginUpdate() {
BeginUpdateInternal();
}
///
/// Collapses all nodes at the root level.
///
public void CollapseAll() {
root.Collapse();
}
///
///
///
/// Resets the imageList to null. We wire this method up to the imageList's
/// Dispose event, so that we don't hang onto an imageList that's gone away.
///
///
/// Resets the stateimageList to null. We wire this method up to the stateimageList's
/// Dispose event, so that we don't hang onto an stateimageList that's gone away.
///
///
///
///
/// Reenables redrawing of the tree view. A call to beginUpdate() must be
/// balanced by a following call to endUpdate(). Following a call to
/// beginUpdate(), any redrawing caused by operations performed on the
/// combo box is deferred until the call to endUpdate().
///
public void EndUpdate() {
EndUpdateInternal();
}
///
/// Expands all nodes at the root level.
///
public void ExpandAll() {
root.ExpandAll();
}
///
/// Forces the TreeView to recalculate all its nodes widths so that it updates the
/// scrollbars as appropriate.
///
///
/// Called by ToolTip to poke in that Tooltip into this ComCtl so that the Native ChildToolTip is not exposed.
///
///
/// Gives the information about which part of the treeNode is at the given point.
///
public TreeViewHitTestInfo HitTest(Point pt) {
return HitTest(pt.X, pt.Y);
}
///
/// Gives the information about which part of the treeNode is at the given x, y.
///
public TreeViewHitTestInfo HitTest(int x, int y) {
NativeMethods.TV_HITTESTINFO tvhi = new NativeMethods.TV_HITTESTINFO();
tvhi.pt_x = x;
tvhi.pt_y = y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhi);
TreeNode node = (hnode == IntPtr.Zero ? null : NodeFromHandle(hnode));
TreeViewHitTestLocations loc = (TreeViewHitTestLocations)tvhi.flags;
return (new TreeViewHitTestInfo(node, loc));
}
///
/// Defined so that a tree node can use it
///
///
///
/// Returns count of nodes at root, optionally including all subtrees.
///
public int GetNodeCount(bool includeSubTrees) {
return root.GetNodeCount(includeSubTrees);
}
///
/// Returns the TreeNode at the given location in tree view coordinates.
///
public TreeNode GetNodeAt(Point pt) {
return GetNodeAt(pt.X, pt.Y);
}
///
/// Returns the TreeNode at the given location in tree view coordinates.
///
public TreeNode GetNodeAt(int x, int y) {
NativeMethods.TV_HITTESTINFO tvhi = new NativeMethods.TV_HITTESTINFO();
tvhi.pt_x = x;
tvhi.pt_y = y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhi);
return(hnode == IntPtr.Zero ? null : NodeFromHandle(hnode));
}
private void ImageListRecreateHandle(object sender, EventArgs e) {
if (IsHandleCreated) {
IntPtr handle = (ImageList == null) ? IntPtr.Zero : ImageList.Handle;
SendMessage(NativeMethods.TVM_SETIMAGELIST, 0, handle);
}
}
private void UpdateImagesRecursive ( TreeNode node )
{
node.UpdateImage();
// VSWhidbey 208200: Iterate only through the Nodes collection rather than the
// array since an item might have been removed from the collection, and
// correspondingly "removed" from the array, but still exist in the array
// since the array isn't actually re-dimensioned down to a smaller size.
foreach (TreeNode child in node.Nodes) {
UpdateImagesRecursive(child);
}
}
private void ImageListChangedHandle(object sender, EventArgs e) {
if ((null != sender) && (sender == imageList) && IsHandleCreated) {
BeginUpdate();
foreach (TreeNode node in Nodes) {
UpdateImagesRecursive(node);
}
EndUpdate();
}
}
private void StateImageListRecreateHandle(object sender, EventArgs e) {
if (IsHandleCreated) {
IntPtr handle = IntPtr.Zero;
if (internalStateImageList != null) {
handle = internalStateImageList.Handle;
}
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, handle);
}
}
private void StateImageListChangedHandle(object sender, EventArgs e) {
if ((null != sender) && (sender == stateImageList) && IsHandleCreated) {
// Since the native treeview requires the state imagelist to be 1-indexed we need to
// re add the images if the original collection had changed.
if (stateImageList != null && stateImageList.Images.Count > 0) {
Image[] images = new Image[stateImageList.Images.Count + 1];
images[0] = stateImageList.Images[0];
for (int i = 1; i <= stateImageList.Images.Count ; i++) {
images[i] = stateImageList.Images[i -1];
}
if (internalStateImageList != null)
{
internalStateImageList.Images.Clear();
internalStateImageList.Images.AddRange(images);
}
else
{
internalStateImageList = new ImageList();
internalStateImageList.Images.AddRange(images);
}
Debug.Assert(internalStateImageList != null, "Why are changing images when the Imagelist is null?");
if (internalStateImageList != null)
{
SendMessage(NativeMethods.TVM_SETIMAGELIST, NativeMethods.TVSIL_STATE, internalStateImageList.Handle);
}
}
else //stateImageList == null || stateImageList.Images.Count = 0;
{
UpdateCheckedState(root, true);
}
}
}
///
///
/// Overridden to handle RETURN key.
///
///
protected override bool IsInputKey(Keys keyData) {
// If in edit mode, treat Return as an input key, so the form doesn't grab it
// and treat it as clicking the Form.AcceptButton. Similarly for Escape
// and Form.CancelButton.
if (editNode != null && (keyData & Keys.Alt) == 0) {
switch (keyData & Keys.KeyCode) {
case Keys.Return:
case Keys.Escape:
case Keys.PageUp:
case Keys.PageDown:
case Keys.Home:
case Keys.End:
return true;
}
}
return base.IsInputKey(keyData);
}
///
/// Note this can be null - particularly if any windows messages get generated during
/// the insertion of a tree node (TVM_INSERTITEM)
///
///
/// Fires the DrawNode event.
///
protected virtual void OnDrawNode(DrawTreeNodeEventArgs e) {
if (onDrawNode != null) onDrawNode(this, e);
}
///
///
///
///
///
/// We keep track of if we've hovered already so we don't fire multiple hover events
///
///
protected override void OnMouseLeave(EventArgs e) {
hoveredAlready = false;
base.OnMouseLeave(e);
}
///
/// In order for the MouseHover event to fire for each item in a TreeView,
/// the node the mouse is hovering over is found. Each time a new node is hovered
/// over a new event is raised.
///
protected override void OnMouseHover(EventArgs e) {
/// Hover events need to be caught for each node
/// within the TreeView so the appropriate
/// NodeHovered event can be raised.
NativeMethods.TV_HITTESTINFO tvhip = new NativeMethods.TV_HITTESTINFO();
Point pos = Cursor.Position;
pos = PointToClientInternal(pos);
tvhip.pt_x = pos.X;
tvhip.pt_y = pos.Y;
IntPtr hnode = UnsafeNativeMethods.SendMessage(new HandleRef(this, Handle), NativeMethods.TVM_HITTEST, 0, tvhip);
if (hnode != IntPtr.Zero && ((tvhip.flags & NativeMethods.TVHT_ONITEM) != 0)) {
TreeNode tn = NodeFromHandle(hnode);
if (tn != prevHoveredNode && tn != null) {
OnNodeMouseHover( new TreeNodeMouseHoverEventArgs(tn));
prevHoveredNode = tn;
}
}
if (!hoveredAlready) {
base.OnMouseHover(e);
hoveredAlready = true;
}
ResetMouseEventArgs();
}
///
/// Fires the beforeLabelEdit event.
///
protected virtual void OnBeforeLabelEdit(NodeLabelEditEventArgs e) {
if (onBeforeLabelEdit != null) onBeforeLabelEdit(this, e);
}
///
/// Fires the afterLabelEdit event.
///
protected virtual void OnAfterLabelEdit(NodeLabelEditEventArgs e) {
if (onAfterLabelEdit != null) onAfterLabelEdit(this, e);
}
///
/// Fires the beforeCheck event.
///
protected virtual void OnBeforeCheck(TreeViewCancelEventArgs e) {
if (onBeforeCheck != null) onBeforeCheck(this, e);
}
///
/// Fires the afterCheck event.
///
protected virtual void OnAfterCheck(TreeViewEventArgs e) {
if (onAfterCheck != null) onAfterCheck(this, e);
}
///
/// Fires the beforeCollapse event.
///
protected internal virtual void OnBeforeCollapse(TreeViewCancelEventArgs e) {
if (onBeforeCollapse != null) onBeforeCollapse(this, e);
}
///
/// Fires the afterCollapse event.
///
protected internal virtual void OnAfterCollapse(TreeViewEventArgs e) {
if (onAfterCollapse != null) onAfterCollapse(this, e);
}
///
/// Fires the beforeExpand event.
///
protected virtual void OnBeforeExpand(TreeViewCancelEventArgs e) {
if (onBeforeExpand != null) onBeforeExpand(this, e);
}
///
/// Fires the afterExpand event.
///
protected virtual void OnAfterExpand(TreeViewEventArgs e) {
if (onAfterExpand != null) onAfterExpand(this, e);
}
///
/// Fires the ItemDrag event.
///
protected virtual void OnItemDrag(ItemDragEventArgs e) {
if (onItemDrag != null) onItemDrag(this, e);
}
///
/// Fires the NodeMouseHover event.
///
protected virtual void OnNodeMouseHover(TreeNodeMouseHoverEventArgs e) {
if (onNodeMouseHover != null) onNodeMouseHover(this, e);
}
///
/// Fires the beforeSelect event.
///
protected virtual void OnBeforeSelect(TreeViewCancelEventArgs e) {
if (onBeforeSelect != null) onBeforeSelect(this, e);
}
///
/// Fires the afterSelect event.
///
protected virtual void OnAfterSelect(TreeViewEventArgs e) {
if (onAfterSelect != null) onAfterSelect(this, e);
}
///
/// Fires the onNodeMouseClick event.
///
protected virtual void OnNodeMouseClick(TreeNodeMouseClickEventArgs e) {
if (onNodeMouseClick != null) onNodeMouseClick(this, e);
}
///
/// Fires the onNodeMouseDoubleClick event.
///
protected virtual void OnNodeMouseDoubleClick(TreeNodeMouseClickEventArgs e) {
if (onNodeMouseDoubleClick != null) onNodeMouseDoubleClick(this, e);
}
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// Handles the OnBeforeCheck / OnAfterCheck for keyboard clicks
///
///
/// [To be supplied.]
///
[EditorBrowsable(EditorBrowsableState.Advanced)]
protected virtual void OnRightToLeftLayoutChanged(EventArgs e) {
if (GetAnyDisposingInHierarchy()) {
return;
}
if (RightToLeft == RightToLeft.Yes) {
RecreateHandle();
}
if (onRightToLeftLayoutChanged != null) {
onRightToLeftLayoutChanged(this, e);
}
}
// Refresh the nodes by clearing the tree and adding the nodes back again
//
private void RefreshNodes() {
TreeNode[] nodes = new TreeNode[Nodes.Count];
Nodes.CopyTo(nodes, 0);
Nodes.Clear();
Nodes.AddRange(nodes);
}
///
/// This resets the indentation to the system default.
///
private void ResetIndent() {
indent = -1;
// is this overkill?
RecreateHandle();
}
///
/// This resets the item height to the system default.
///
private void ResetItemHeight() {
itemHeight = -1;
RecreateHandle();
}
///
/// Retrieves true if the indent should be persisted in code gen.
///
private bool ShouldSerializeIndent() {
return(indent != -1);
}
///
/// Retrieves true if the itemHeight should be persisted in code gen.
///
private bool ShouldSerializeItemHeight() {
return(itemHeight != -1);
}
private bool ShouldSerializeSelectedImageIndex() {
if (imageList != null) {
return (SelectedImageIndex != 0);
}
return (SelectedImageIndex != -1);
}
private bool ShouldSerializeImageIndex() {
if (imageList != null) {
return (ImageIndex != 0);
}
return (ImageIndex != -1);
}
///
/// Updated the sorted order
///
public void Sort() {
Sorted = true;
RefreshNodes();
}
///
/// Returns a string representation for this control.
///
///
/// Performs custom draw handling
///
///
/// Generates colors for each item. This can be overridden to provide colors on a per state/per node
/// basis, rather than using the ForeColor/BackColor/NodeFont properties on TreeNode.
///
///
///
///
///
/// Shows the context menu for the Treenode.
///
///
///
///
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- InsufficientMemoryException.cs
- WindowsGraphics2.cs
- AutoResizedEvent.cs
- KnowledgeBase.cs
- cookiecollection.cs
- TcpConnectionPool.cs
- ContentElementCollection.cs
- CompilationRelaxations.cs
- FontNamesConverter.cs
- ThreadExceptionEvent.cs
- _NetRes.cs
- DynamicPropertyHolder.cs
- CompressionTransform.cs
- FixedLineResult.cs
- XamlReader.cs
- QilChoice.cs
- CommentEmitter.cs
- __Filters.cs
- DataGridrowEditEndingEventArgs.cs
- TextSelectionHelper.cs
- OverflowException.cs
- TextParagraph.cs
- CodeComment.cs
- categoryentry.cs
- sqlstateclientmanager.cs
- Point3D.cs
- ManagementClass.cs
- FormatException.cs
- LongTypeConverter.cs
- TextSelectionHighlightLayer.cs
- SaveFileDialog.cs
- PointAnimationUsingPath.cs
- nulltextcontainer.cs
- BidPrivateBase.cs
- Stacktrace.cs
- CompModSwitches.cs
- GraphicsContainer.cs
- FileRecordSequenceCompletedAsyncResult.cs
- ScriptDescriptor.cs
- RadioButton.cs
- XmlWrappingWriter.cs
- QueryableDataSourceHelper.cs
- RubberbandSelector.cs
- XXXInfos.cs
- SizeF.cs
- ComponentSerializationService.cs
- GradientStop.cs
- OdbcFactory.cs
- RequestCacheManager.cs
- GlyphsSerializer.cs
- HorizontalAlignConverter.cs
- SqlClientFactory.cs
- PropertyEmitter.cs
- DBAsyncResult.cs
- ListMarkerSourceInfo.cs
- PropertyChangeTracker.cs
- OciLobLocator.cs
- WinCategoryAttribute.cs
- ResourceType.cs
- XDeferredAxisSource.cs
- XmlWriterTraceListener.cs
- SparseMemoryStream.cs
- NotifyIcon.cs
- TableStyle.cs
- NameNode.cs
- PermissionRequestEvidence.cs
- CompilerGlobalScopeAttribute.cs
- StateElementCollection.cs
- ContextMenuService.cs
- NodeLabelEditEvent.cs
- OdbcFactory.cs
- ByteAnimationUsingKeyFrames.cs
- DirectionalAction.cs
- KeyEventArgs.cs
- MenuTracker.cs
- EdmValidator.cs
- DetailsViewInsertedEventArgs.cs
- SqlExpressionNullability.cs
- Identifier.cs
- CurrentChangingEventArgs.cs
- BoundColumn.cs
- ParallelTimeline.cs
- TailCallAnalyzer.cs
- ResourceAssociationSet.cs
- CodeDirectiveCollection.cs
- XmlByteStreamWriter.cs
- SecurityUtils.cs
- FileNameEditor.cs
- Normalization.cs
- RequestTimeoutManager.cs
- HttpCacheVary.cs
- RequestCachingSection.cs
- DateTimeConverter.cs
- ByteKeyFrameCollection.cs
- Models.cs
- DataQuery.cs
- BindUriHelper.cs
- DataServiceContext.cs
- DataService.cs
- CodeTypeParameterCollection.cs