TreeView.ExpandImageUrl プロパティ

定義

展開可能なノード インジケーターのカスタム イメージの URL を取得または設定します。Gets or sets the URL to a custom image for the expandable node indicator.

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。The URL to a custom image to display for expandable nodes. 既定値は空の文字列 ("") で、既定の正符号 (+) のイメージを表示します。The default is an empty string (""), which displays the default plus sign (+) image.

次のコード例は、 ExpandImageUrlプロパティを使用して、展開可能なノードインジケーターのカスタムイメージを指定する方法を示しています。The following code example demonstrates how to use the ExpandImageUrl property to specify a custom image for the expandable node indicator. 表示するコード例とイメージをコントロールに表示するには、独自のイメージを指定しImageSet 、プロパティをにTreeNodeImageSet.Custom設定する必要があります。For the code example to display and the image to appear in the control, you must provide your own image and the ImageSet property must be set to 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プロパティを使用して、展開可能なノードインジケーターのカスタムイメージを指定します。Use the ExpandImageUrl property to specify a custom image for the expandable node indicator. このイメージは、展開可能なノードの横に表示され、通常はプラス記号 (+) です。This image is displayed next to an expandable node and is usually a plus sign (+).

プロパティがShowExpandCollapsetrue設定されているTreeView場合、コントロールには、ノードの横に正符号 (+) またはマイナス記号 (-) またはプレースホルダーイメージが表示され、ノードが展開可能か、折りたたみ可能か、または展開不可能かが示されます。When the ShowExpandCollapse property is set to true, the TreeView control displays a plus sign (+) or minus sign (-) or a placeholder image next to a node to indicate whether the node is expandable, collapsible, or non-expandable, respectively. カスタムイメージを指定するには、最初ImageSetにプロパティTreeViewImageSet.Customをに設定し、 NoExpandImageUrlExpandImageUrlに、 CollapseImageUrl 、、およびの各プロパティをカスタムイメージの url に設定します。You can specify custom images by first setting the ImageSet property to TreeViewImageSet.Custom, and then setting the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties to the URLs for the custom images. イメージが指定されていない場合は、既定のイメージが使用されます。If no images are specified, the default images are used. 展開ノードのインジケーターを非表示にするShowExpandCollapseにはfalse、プロパティをに設定します。To hide the expansion node indicators, set the ShowExpandCollapse property to false.

注意

カスタムイメージを使用するときに、 TreeViewノードがコントロール内で正しく配置されるようにするには、 NoExpandImageUrlExpandImageUrl、およびCollapseImageUrlの各プロパティによって指定されたすべてのイメージが同じ大きさであることを確認してください。To ensure that nodes align correctly in the TreeView control when using custom images, make sure that all the images that are specified by the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties have the same dimensions.

カスタムイメージを正しく表示するには、をにShowLines false設定する必要がある場合があります。To display a custom image correctly, you may need to set ShowLines to false.

展開可能なノードインジケーターにカスタムイメージを使用する場合は、 ExpandImageToolTipプロパティを設定してイメージのツールヒントを指定することも検討してください。When using a custom image for the expandable node indicator, you should also consider setting the ExpandImageToolTip property to specify a ToolTip for the image.

このプロパティの値は、ビューステートに格納されます。The value of this property is stored in view state.

適用対象

こちらもご覧ください