TreeView.NoExpandImageUrl プロパティ

定義

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

public:
 property System::String ^ NoExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string NoExpandImageUrl { get; set; }
member this.NoExpandImageUrl : string with get, set
Public Property NoExpandImageUrl As String

プロパティ値

展開不能なノードに表示されるカスタム イメージの URL。The URL to a custom image to display for non-expandable nodes. 既定値は空の文字列 ("") で、既定の空のイメージを表示します。The default is an empty string (""), which displays the default blank image.

次のコード例は、 NoExpandImageUrlプロパティを使用して、展開できないノードインジケーターのカスタムイメージを指定する方法を示しています。The following code example demonstrates how to use the NoExpandImageUrl property to specify a custom image for the non-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>

注釈

NoExpandImageUrlプロパティを使用して、展開できないノードインジケーターのカスタムイメージを指定します。Use the NoExpandImageUrl property to specify a custom image for the non-expandable node indicator. 拡張可能なノードインジケーターイメージ (またはスペーサー) は、リーフノードを親ノードまたはルートノードに揃えるために、リーフノードの横 (展開可能および折りたたみ可能なノードインジケーターの代わり) に表示されます。The non-expandable node indicator image (or spacer) is displayed next to leaf nodes (in place of the expandable and collapsible node indicators) to align the leaf nodes with parent or root nodes.

プロパティが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 of 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.

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

適用対象

こちらもご覧ください