TreeView.ExpandImageUrl Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die URL zu einem benutzerdefinierten Bild für den Indikator eines erweiterbaren Knotens ab oder legt diese fest.
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
Eigenschaftswert
Die URL zu einem benutzerdefinierten Bild, das für erweiterbare Knoten angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die das Standardbild mit dem Pluszeichen (+) anzeigt.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ExpandImageUrl -Eigenschaft verwendet wird, um ein benutzerdefiniertes Bild für den Erweiterbaren Knotenindikator anzugeben. Damit das Codebeispiel angezeigt wird und das Bild im Steuerelement angezeigt wird, müssen Sie Ihr eigenes Bild angeben, und die ImageSet -Eigenschaft muss auf TreeNodeImageSet.Custom
festgelegt sein.
<%@ 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>
Hinweise
Verwenden Sie die ExpandImageUrl -Eigenschaft, um ein benutzerdefiniertes Bild für den erweiterbaren Knotenindikator anzugeben. Dieses Bild wird neben einem erweiterbaren Knoten angezeigt und ist in der Regel ein Pluszeichen (+).
Wenn die ShowExpandCollapse -Eigenschaft auf true
festgelegt ist, zeigt das TreeView Steuerelement ein Pluszeichen (+) oder ein Minuszeichen (-) oder ein Platzhalterbild neben einem Knoten an, um anzugeben, ob der Knoten erweiterbar, reduzierbar oder nicht erweiterbar ist. Sie können benutzerdefinierte Bilder angeben, indem Sie zuerst die ImageSet -Eigenschaft auf TreeViewImageSet.Custom
festlegen und dann die NoExpandImageUrlEigenschaften , ExpandImageUrlund CollapseImageUrl auf die URLs für die benutzerdefinierten Bilder festlegen. Wenn keine Bilder angegeben sind, werden die Standardbilder verwendet. Um die Erweiterungsknotenindikatoren auszublenden, legen Sie die ShowExpandCollapse -Eigenschaft auf fest false
.
Hinweis
Stellen Sie sicher, dass alle Bilder, die TreeView durch NoExpandImageUrldie Eigenschaften , ExpandImageUrlund CollapseImageUrl angegeben werden, die gleichen Dimensionen aufweisen, um sicherzustellen, dass knoten im Steuerelement ordnungsgemäß ausgerichtet sind.
Um ein benutzerdefiniertes Bild richtig anzuzeigen, müssen Sie möglicherweise auf false
festlegenShowLines.
Wenn Sie ein benutzerdefiniertes Image für den Indikator für erweiterbare Knoten verwenden, sollten Sie auch erwägen, die ExpandImageToolTip -Eigenschaft so festzulegen, dass eine QuickInfo für das Bild angegeben wird.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.