TreeView.ExpandImageUrl Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia adres URL na obraz niestandardowy dla wskaźnika węzła, który można rozwinąć.
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
Wartość właściwości
Adres URL obrazu niestandardowego do wyświetlenia dla węzłów z możliwością rozwijania. Wartość domyślna to pusty ciąg (""), który wyświetla domyślny obraz znaku plus (+).
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą ExpandImageUrl właściwości określić obraz niestandardowy dla wskaźnika węzła, który można rozwinąć. Aby przykładowy kod był wyświetlany i obraz wyświetlany w kontrolce, należy podać własny obraz, a ImageSet właściwość musi być ustawiona na TreeNodeImageSet.Custom
wartość .
<%@ 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>
Uwagi
ExpandImageUrl Użyj właściwości , aby określić obraz niestandardowy dla wskaźnika węzła, który można rozwinąć. Ten obraz jest wyświetlany obok węzła z możliwością rozwijania i zwykle jest znakiem plus (+).
ShowExpandCollapse Gdy właściwość jest ustawiona na true
wartość , kontrolka TreeView wyświetla znak plus (+) lub znak minus (-) lub obraz zastępczy obok węzła, aby wskazać, czy węzeł jest rozszerzalny, zwijany, czy nie rozwijalny odpowiednio. Obrazy niestandardowe można określić, ustawiając ImageSet najpierw właściwość na TreeViewImageSet.Custom
, a następnie ustawiając NoExpandImageUrlwłaściwości , ExpandImageUrli CollapseImageUrl na adresy URL obrazów niestandardowych. Jeśli nie określono żadnych obrazów, są używane obrazy domyślne. Aby ukryć wskaźniki węzła rozszerzenia, ustaw ShowExpandCollapse właściwość na false
wartość .
Uwaga
Aby upewnić się, że węzły są prawidłowo wyrównane do kontrolki TreeView podczas korzystania z obrazów niestandardowych, upewnij się, że wszystkie obrazy określone przez NoExpandImageUrlwłaściwości , ExpandImageUrli CollapseImageUrl mają te same wymiary.
Aby poprawnie wyświetlić obraz niestandardowy, może być konieczne ustawienie wartości ShowLinesfalse
.
W przypadku używania obrazu niestandardowego dla wskaźnika węzła z możliwością rozwijania należy również rozważyć ustawienie ExpandImageToolTip właściwości w celu określenia etykietki narzędzia dla obrazu.
Wartość tej właściwości jest przechowywana w stanie widoku.