TreeView.ExpandImageUrl 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定可展開節點指示器之自訂影像的 URL。
public:
property System::String ^ ExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string ExpandImageUrl { get; set; }
member this.ExpandImageUrl : string with get, set
Public Property ExpandImageUrl As String
屬性值
為可展開節點顯示之自訂影像的 URL。 預設為空字串 (""),會顯示預設的加號 (+) 影像。
範例
下列程式碼範例示範如何使用 ExpandImageUrl 屬性來指定可展開節點指標的自訂映射。 若要讓程式碼範例顯示,以及要出現在 控制項中的影像,您必須提供自己的影像,而且 ImageSet 屬性必須設定為 TreeNodeImageSet.Custom
。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView Custom Images Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView Custom Images Example</h3>
<!-- Set the custom images of this TreeView control -->
<!-- declaratively. -->
<asp:TreeView id="CustomTreeView"
NoExpandImageUrl="Space.jpg"
CollapseImageUrl="Minus.jpg"
CollapseImageToolTip="Collapse Node"
ExpandImageUrl="Plus.jpg"
ExpandImageToolTip="Expand Node"
RootNodeStyle-ImageUrl="Root.jpg"
ParentNodeStyle-ImageUrl="Parent.jpg"
LeafNodeStyle-ImageUrl="Leaf.jpg"
ImageSet="Custom"
runat="server">
<Nodes>
<asp:TreeNode Value="Home"
NavigateUrl="Home.aspx"
Text="Home"
Target="_blank"
Expanded="True">
<asp:TreeNode Value="Page 1"
NavigateUrl="Page1.aspx"
Text="Page 1"
Target="_blank">
<asp:TreeNode Value="Section 1"
ImageUrl="custom.jpg"
NavigateUrl="Section1.aspx"
Text="Section 1"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Value="Page 2"
Selected="True"
NavigateUrl="Page2.aspx"
Text="Page 2"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView Custom Images Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView Custom Images Example</h3>
<!-- Set the custom images of this TreeView control -->
<!-- declaratively. -->
<asp:TreeView id="CustomTreeView"
NoExpandImageUrl="Space.jpg"
CollapseImageUrl="Minus.jpg"
CollapseImageToolTip="Collapse Node"
ExpandImageUrl="Plus.jpg"
ExpandImageToolTip="Expand Node"
RootNodeStyle-ImageUrl="Root.jpg"
ParentNodeStyle-ImageUrl="Parent.jpg"
LeafNodeStyle-ImageUrl="Leaf.jpg"
ImageSet="Custom"
runat="server">
<Nodes>
<asp:TreeNode Value="Home"
NavigateUrl="Home.aspx"
Text="Home"
Target="_blank"
Expanded="True">
<asp:TreeNode Value="Page 1"
NavigateUrl="Page1.aspx"
Text="Page 1"
Target="_blank">
<asp:TreeNode Value="Section 1"
ImageUrl="custom.jpg"
NavigateUrl="Section1.aspx"
Text="Section 1"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Value="Page 2"
Selected="True"
NavigateUrl="Page2.aspx"
Text="Page 2"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
</form>
</body>
</html>
備註
ExpandImageUrl使用 屬性可指定可展開節點指標的自訂映射。 此影像會顯示在可展開的節點旁邊,通常是加號 (+) 。
ShowExpandCollapse當 屬性設定為 true
時, TreeView 控制項會顯示加號 (+) 或減號 () 或節點旁的預留位置影像,指出節點是可展開、可折迭或不可展開的。 您可以先將 屬性設定 ImageSet 為 TreeViewImageSet.Custom
來指定自訂影像,然後將 、 ExpandImageUrl 和 CollapseImageUrl 屬性設定 NoExpandImageUrl 為自訂影像的 URL。 如果未指定任何影像,則會使用預設影像。 若要隱藏擴充節點指標,請將 ShowExpandCollapse 屬性設定為 false
。
注意
若要在使用自訂影像時,確保控制項中的 TreeView 節點正確對齊,請確定 、 和 CollapseImageUrl 屬性所 NoExpandImageUrlExpandImageUrl 指定的所有影像具有相同維度。
若要正確顯示自訂影像,您可能需要設定 ShowLines 為 false
。
針對可展開節點指標使用自訂影像時,您也應該考慮設定 ExpandImageToolTip 屬性來指定影像的工具提示。
此屬性的值會儲存在檢視狀態中。