TreeNode 类.docx
- 文档编号:3443142
- 上传时间:2022-11-23
- 格式:DOCX
- 页数:20
- 大小:26.16KB
TreeNode 类.docx
《TreeNode 类.docx》由会员分享,可在线阅读,更多相关《TreeNode 类.docx(20页珍藏版)》请在冰豆网上搜索。
TreeNode类
表示 TreeView 的节点。
继承层次结构
System.Object
System.MarshalByRefObject
System.Windows.Forms.TreeNode
System.ComponentModel.Design.ObjectSelectorEditor.SelectorNode
System.Workflow.ComponentModel.Design.WorkflowOutlineNode
命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms(在System.Windows.Forms.dll中)
语法
C#
C++
F#
VB
声明
PublicClassTreeNode_
InheritsMarshalByRefObject_
ImplementsICloneable,ISerializable
TreeNode 类型公开以下成员。
构造函数
显示:
继承
保护
名称
说明
TreeNode
初始化 TreeNode 类的新实例。
PublicSubNew
TreeNode(String)
用指定的标签文本初始化 TreeNode 类的新实例。
PublicSubNew(textAsString)
text
类型:
System.String
新的树节点的标签 Text。
TreeNode(SerializationInfo,StreamingContext)
使用指定的序列化信息和上下文初始化 TreeNode 类的新实例。
ProtectedSubNew(_
serializationInfoAsSerializationInfo,_
contextAsStreamingContext_
)
serializationInfo
类型:
System.Runtime.Serialization.SerializationInfo
一个 SerializationInfo,其中包含用来反序列化类的数据。
context
类型:
System.Runtime.Serialization.StreamingContext
一个 StreamingContext,其中包含序列化流的源和目标。
TreeNode(String, TreeNode())
text 参数值分配给节点的 Text 属性,成为树节点标签。
children 数组中包含的树节点被添加到在 Nodes 属性中存储的 TreeNodeCollection 中。
用指定的标签文本和子树节点初始化 TreeNode 类的新实例。
PublicSubNew(_
textAsString,_
childrenAsTreeNode()_
)
text
类型:
System.String
新的树节点的标签 Text。
children
类型:
System.Windows.Forms.TreeNode()
子 TreeNode 对象的数组。
TreeNode(String,Int32,Int32)
text 参数值分配给节点的 Text 属性,成为树节点标签。
imageIndex 和 selectedImageIndex 值是存储在分配给 TreeView.ImageList 属性的 ImageList 中的 Image 的索引值。
当没有选定树节点时,将显示在 imageIndex属性中引用的图像。
同样,当树节点处于选定状态时,将显示在 selectedImageIndex 属性中引用的图像。
用指定的标签文本以及树节点处于选定和未选定状态时所显示的图像来初始化 TreeNode 类的新实例。
PublicSubNew(_
textAsString,_
imageIndexAsInteger,_
selectedImageIndexAsInteger_
)
text
类型:
System.String
新的树节点的标签 Text。
imageIndex
类型:
System.Int32
在取消选定树节点时显示的 Image 的索引值。
selectedImageIndex
类型:
System.Int32
在选择树节点时显示的 Image 的索引值。
TreeNode(String,Int32,Int32, TreeNode())
text 参数值分配给节点的 Text 属性,成为树节点标签。
imageIndex 和 selectedImageIndex 值是存储在分配给 TreeView.ImageList 属性的 ImageList 中的 Image 的索引值。
当没有选择树节点时,将显示在 imageIndex参数中引用的图像。
同样,当树节点处于选定状态时,将显示在 selectedImageIndex 参数中引用的图像。
children 数组中包含的树节点被添加到在 Nodes 属性中存储的 TreeNodeCollection 中。
用指定的标签文本、子树节点以及树节点处于选定和未选定状态时所显示的图像来初始化 TreeNode 类的新实例。
PublicSubNew(_
textAsString,_
imageIndexAsInteger,_
selectedImageIndexAsInteger,_
childrenAsTreeNode()_
)
参数
text
类型:
System.String
新的树节点的标签 Text。
imageIndex
类型:
System.Int32
在取消选定树节点时显示的 Image 的索引值。
selectedImageIndex
类型:
System.Int32
在选择树节点时显示的 Image 的索引值。
children
类型:
System.Windows.Forms.TreeNode()
子 TreeNode 对象的数组。
页首
属性
显示:
继承
保护
名称
说明
BackColor
如果将 BackColor 属性设置为 Color.Empty,所使用的 Color 则为树节点分配到的 TreeView 控件的 BackColor 属性值。
获取或设置树节点的背景色。
PublicPropertyBackColorAsColor
Bounds
坐标相对于 TreeView 控件的左上角。
获取树节点的界限。
PublicReadOnlyPropertyBoundsAsRectangle
Checked
获取或设置一个值,用以指示树节点是否处于选中状态。
PublicPropertyCheckedAsBoolean
ContextMenu
获取与此树节点关联的快捷菜单。
PublicOverridablePropertyContextMenuAsContextMenu
ContextMenuStrip
获取或设置与此树节点关联的快捷菜单。
PublicOverridablePropertyContextMenuStripAsContextMenuStrip
FirstNode
FirstNode 是存储在当前树节点的 Nodes 属性的 TreeNodeCollection 中的第一个子 TreeNode。
如果 TreeNode 没有子树节点,则 FirstNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取树节点集合中的第一个子树节点。
PublicReadOnlyPropertyFirstNodeAsTreeNode
ForeColor
如果 null引用(在VisualBasic中为 Nothing),所使用的 Color 则为树节点分配到的 TreeView 控件的 ForeColor 属性值。
获取或设置树节点的前景色。
PublicPropertyForeColorAsColor
FullPath
路径从根树节点开始,包括要达到该树节点而必须浏览的所有树节点的标签。
分隔节点标签的分隔符在包含该节点的 TreeView 控件的 PathSeparator 属性中指定。
例如,如果名为“Location”的树视图控件的分隔符设置为反斜杠字符(\),FullPath 属性值就为“Country\Region\State”。
设置从根树节点到当前树节点的路径。
PublicReadOnlyPropertyFullPathAsString
Handle
如果在引用 Handle 属性时尚未创建句柄,则将创建句柄。
获取树节点的句柄。
PublicReadOnlyPropertyHandleAsIntPtr
ImageIndex
ImageIndex 值是存储在分配给 TreeView.ImageList 属性的 ImageList 中的 Image 的索引值。
ImageKey 和 ImageIndex 属性互相排斥,因此,如果设置了其中的一个属性,另一个属性将被忽略。
如果设置了 ImageKey 属性,则会将 ImageIndex 属性自动设为-1。
或者,如果设置 ImageIndex,则 ImageKey 自动设置为空字符串("")。
获取或设置当树节点处于未选定状态时所显示图像的图像列表索引值。
PublicPropertyImageIndexAsInteger
ImageKey
由此属性返回的图像键包含在 TreeView 包含控件的 ImageList 属性中。
ImageKey 不区分大小写。
ImageKey 和 ImageIndex 属性互相排斥,如果设置了其中的一个属性,另一个属性将被忽略。
如果设置了 ImageKey 属性,则会将 ImageIndex 属性自动设为-1。
或者,如果设置 ImageIndex,则 ImageKey 自动设置为空字符串("")。
获取或设置此树节点处于未选中状态时与其关联的图像的键。
PublicPropertyImageKeyAsString
Index
获取树节点在树节点集合中的位置。
PublicReadOnlyPropertyIndexAsInteger
从零开始的索引值,表示树节点在 Nodes 集合中的位置。
IsEditing
获取一个值,用以指示树节点是否处于可编辑状态。
PublicReadOnlyPropertyIsEditingAsBoolean
IsExpanded
获取一个值,用以指示树节点是否处于可展开状态。
PublicReadOnlyPropertyIsExpandedAsBoolean
IsSelected
获取一个值,用以指示树节点是否处于选定状态。
PublicReadOnlyPropertyIsSelectedAsBoolean
IsVisible
获取一个值,用以指示树节点是否是完全可见或部分可见。
PublicReadOnlyPropertyIsVisibleAsBoolean
LastNode
LastNode 是存储在当前树节点的 Nodes 属性的 TreeNodeCollection 中的最后一个子 TreeNode。
如果 TreeNode 没有子树节点,则 LastNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取最后一个子树节点。
PublicReadOnlyPropertyLastNodeAsTreeNode
Level
对于 Level 属性,根节点被视为嵌套的第一层,并返回0。
获取 TreeView 控件中的树视图的深度(从零开始)。
PublicReadOnlyPropertyLevelAsInteger
TreeView 控件中的树视图的深度(从零开始)。
Name
当 TreeNode 是 TreeNodeCollection 的一部分时,该节点的 Name 也是该节点的键。
如果该节点没有名称,则 Name 返回一个空字符串("")。
获取或设置树节点的名称。
PublicPropertyNameAsString
NextNode
NextNode 是存储在树节点的父 TreeNode 的 Nodes 属性的 TreeNodeCollection 中的下一个同级 TreeNode。
如果没有下一个树节点,则 NextNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取下一个同级树节点。
PublicReadOnlyPropertyNextNodeAsTreeNode
TreeNode ,表示下一个同级树节点。
NextVisibleNode
NextVisibleNode 可以是另一分支的子级、同级或树节点。
如果没有下一个树节点,则 NextVisibleNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取下一个可见树节点。
PublicReadOnlyPropertyNextVisibleNodeAsTreeNode
TreeNode ,表示下一个可见的树节点。
NodeFont
如果 null引用(在VisualBasic中为 Nothing),所使用的 Font 则为该节点连接的 TreeView 控件的 Font 属性值。
如果节点字体大于在 TreeView 控件中设置的 Font 属性值,则将剪裁树节点标签文本。
获取或设置用于显示树节点标签文本的字体。
PublicPropertyNodeFontAsFont
用于显示树节点标签文本的 Font。
Nodes
Nodes 属性可以包含其他 TreeNode 对象的集合。
集合中的每个树节点都有一个 Nodes 属性,它可以包含其自己的 TreeNodeCollection。
树节点的这种嵌套结构可能会使浏览树结构变得困难。
但利用 FullPath 属性,则可以比较容易地确定您在树结构中的位置。
获取分配给当前树节点的 TreeNode 对象的集合。
PublicReadOnlyPropertyNodesAsTreeNodeCollection
TreeNodeCollection ,表示分配给当前树节点的树节点。
Parent
如果树节点位于根级别,Parent 属性将返回 null引用(在VisualBasic中为 Nothing)。
获取当前树节点的父树节点。
PublicReadOnlyPropertyParentAsTreeNode
TreeNode ,表示当前树节点的父树节点。
PrevNode
PrevNode 是存储在树节点的父 TreeNode 的 Nodes 属性的 TreeNodeCollection 中的上一个同级 TreeNode。
如果没有上一个树节点,则 PrevNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取上一个同级树节点。
PublicReadOnlyPropertyPrevNodeAsTreeNode
TreeNode ,表上一个同级树节点。
PrevVisibleNode
PrevVisibleNode 可以是另一分支的子级、同级或树节点。
如果没有上一个树节点,则 PrevVisibleNode 属性返回 null引用(在VisualBasic中为 Nothing)。
获取上一个可见树节点。
PublicReadOnlyPropertyPrevVisibleNodeAsTreeNode
TreeNode ,表示上一个可见的树节点。
SelectedImageIndex
由此属性返回的图像键包含在 TreeView 父控件的 ImageList 属性中。
获取或设置当树节点处于选定状态时所显示的图像的图像列表索引值。
PublicPropertySelectedImageKeyAsString
SelectedImageKey
由此属性返回的图像键包含在 TreeView 父控件的 ImageList 属性中。
获取或设置当树节点处于选中状态时显示在该节点中的图像的键。
PublicPropertySelectedImageKeyAsString
StateImageIndex
由此属性返回的图像索引包含在父 TreeView 控件的 StateImageList 属性中。
如果父 TreeView 已启用复选框,将忽略 StateImageIndex,该节点将显示父 TreeView 上设置的 StateImageList 中的第一幅或第二幅图像,以分别指示未选中状态或选中状态。
切换 Checked 属性不影响StateImageIndex 的值。
如果未设置,则 StateImageIndex 返回-1。
StateImageKey 和 StateImageIndex 属性互相排斥,这意味着如果设置了其中一个属性,另一个属性将被忽略。
如果设置了 StateImageKey 属性,则会将 StateImageIndex属性自动设为-1。
或者,如果设置 StateImageIndex,则 StateImageKey 自动设置为空字符串("")。
获取或设置图像的索引,该图像用于在父 TreeView 的 CheckBoxes 属性设置为 false 时,指示 TreeNode 的状态。
PublicPropertyStateImageIndexAsInteger
StateImageKey
此属性返回的图像键包含在父 TreeView 控件的 StateImageList 属性中。
如果父 TreeView 已启用复选框,将忽略 StateImageKey,该节点将显示父 TreeView 上设置的 StateImageList 中的第一幅或第二幅图像,以分别指示未选中状态或选中状态。
切换 Checked 属性对 StateImageKey 的值没有影响。
StateImageKey 和 StateImageIndex 属性互相排斥,这意味着如果设置了其中一个属性,另一个属性将被忽略。
如果设置了 StateImageKey 属性,则会将 StateImageIndex 属性自动设为-1。
或者,如果设置StateImageIndex,则 StateImageKey 自动设置为空字符串("")。
应将 StateImageKey 设置为带有0到14之间的相应索引的图像。
可将 StateImageKey 设置为索引值大于14的图像(将不会引发异常),但不能显示该图像
获取或设置图像的键,该图像用于在父 TreeView 的 CheckBoxes 属性设置为 false 时,指示 TreeNode 的状态。
PublicPropertyStateImageKeyAsString
Tag
任何 Object 派生类型都可被指派给此属性。
如果此属性是通过Windows窗体设计器设置的,则只能指派文本。
Clone 方法执行节点的一个卷影复制。
如果 Tag 属性的值是引用类型,原始和克隆的副本上指向 Tag 值的同一个实例。
获取或设置包含树节点有关数据的对象。
PublicPropertyTagAsObject
Object ,包含有关树节点的数据。
默认值为 null引用(在VisualBasic中为 Nothing)。
Text
TreeNode 可显示的最大字符数是259。
如果拥有多于259个字符的 String 被分配到此属性,那么只会显示前259个字符。
如果父 TreeView 的 LabelEdit 属性设置为 false,用户将无法设置此属性。
要显式设置此属性,一种替代方法是通过使用 TreeNode 构造函数之一创建树节点,且此构造函数具有表示 Text 属性的字符串参数。
如果显示标签,则标签显示在 TreeNode 图像的旁边。
获取或设置在树节点标签中显示的文本。
PublicPropertyTextAsString
在树节点标签中显示的文本。
ToolTipText
获取当鼠标指针悬停于 TreeNode 之上时显示的文本。
获取或设置当鼠标指针悬停于 TreeNode 之上时显示的文本。
PublicPropertyToolTipTextAsString
要想使 ToolTipText 在运行时可见,必须将父 TreeView 的 ShowNodeToolTips 属性设置为 true。
如果 TreeView 控件有一个工具提示,并且包含一个具有 ToolTip 的 TreeNode,则只显示节点的 ToolTip。
TreeView
获取树节点分配到的父树视图。
PublicReadOnlyPropertyTreeViewAsTreeView
一个 TreeView,表示该树节点被分配到的父树视图;如果该节点尚未分配到任何树视图,则为 null引用(在VisualBasic中为 Nothing)。
页首
方法
显示:
继承
保护
名称
说明
BeginEdit
使用此方法的常见方案是对 MenuItem 或 ContextMenu 的 Click 事件调用此方法。
只有当 TreeView 的 LabelEdit 属性设置为 true,此方法才生效。
如果 LabelEdit 设置为 false,将引发异常,并且树节点不会进入可编辑状态。
开始编辑树节点标签。
PublicSubBeginEdit
Clone
复制的部分包括克隆的树节点及其以下的树结构。
所有子树节点分配给克隆的 TreeNode 在新的树节点和子树中。
Clone 方法执行节点的一个卷影复制。
如果 Tag 属性的值是引用类型,原始和克隆的副本上指向 Tag 值的同一个实例。
复制树节点和以此树节点为根的整个子树。
PublicOverridableFunctionCloneAsObject
返回值
类型:
System.Object
表示克隆的 TreeNode 的 Object。
实现
ICloneable.Clone
Collapse
Collapse 方法折叠当前 TreeNode 及其子节点。
如果需要只折叠当前 TreeNode,请使用 TreeNode.Collap
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- TreeNode