TreeView.ExpandImageUrl Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает 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 элемент управления отображает знак плюса (+) или знак минуса (-) или изображение заполнителя рядом с узлом, чтобы указать, является ли узел развертываемым, сворачиваемым или неразвертываемым соответственно. Вы можете указать пользовательские образы, сначала задав свойству ImageSetTreeViewImageSet.Custom
значение , а затем задав NoExpandImageUrlдля свойств , ExpandImageUrlи CollapseImageUrl URL-адреса для пользовательских образов. Если образы не указаны, используются образы по умолчанию. Чтобы скрыть индикаторы узла расширения, присвойте свойству ShowExpandCollapse значение false
.
Примечание
Чтобы обеспечить правильное выравнивание узлов в элементе TreeView управления при использовании пользовательских образов, убедитесь, что все изображения, указанные свойствами NoExpandImageUrl, и CollapseImageUrl , ExpandImageUrlимеют одинаковые размеры.
Чтобы правильно отобразить пользовательское изображение, может потребоваться задать значение ShowLinesfalse
.
При использовании пользовательского образа для индикатора расширяемого узла следует также задать ExpandImageToolTip свойство , чтобы указать подсказку для изображения.
Значение этого свойства хранится в состоянии представления.