TreeView.HideSelection プロパティ

.NET Framework クラス ライブラリ リファレンス

TreeView.HideSelection プロパティ

ツリー ビューがフォーカスを失った場合でも、選択されているツリー ノードが強調表示されたままかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property HideSelection As
 Boolean

Visual Basic (使用法)

Dim instance As TreeView
Dim value As Boolean

value = instance.HideSelection

instance.HideSelection = value

C#

public bool HideSelection { get;
 set; }

C++

public:
property bool HideSelection {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_HideSelection ()

/** @property */
public void set_HideSelection (boolean value)

JScript

public function get HideSelection
 () : boolean

public function set HideSelection
 (value : boolean)

プロパティ値
ツリー ビューがフォーカスを失うと選択されているツリー ノードの強調表示が解除される場合は true。それ以外の場合は false。既定値は true です。

解説

このプロパティを false に設定すると、TreeView コントロールで選択されているノードは、TreeView コントロールがフォーカスを失っても、現在選択されている色とは異なる色で強調表示されたままになります。このプロパティを使用すると、ユーザーがフォーム上の異なるコントロールをクリックしたり、異なるウィンドウに移動したりした場合でも、ユーザーが選択した項目を表示したままにしておくことができます。

メモ
アプリケーションのユーザー補助を考慮する必要がある場合は、HideSelection プロパティを false に設定することをお勧めします。

使用例

HideSelection プロパティを使用する方法を次のコード例に示します。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load イベント ハンドラで InitializeSelectedTreeView メソッドを呼び出します。

Visual Basic

' Declare the TreeView control.
Friend WithEvents TreeView2 As
 System.Windows.Forms.TreeView

' Initialize the TreeView to blend with the form, giving it the 
' same color as the form and no border.
Private Sub InitializeSelectedTreeView()

    ' Create a new TreeView control and set the location and size.
    Me.TreeView2 = New System.Windows.Forms.TreeView
    Me.TreeView2.Location = New System.Drawing.Point(72,
 48)
    Me.TreeView2.Size = New System.Drawing.Size(200,
 200)
    Me.TreeView2.BorderStyle = BorderStyle.Fixed3D
   
    ' Set the HideSelection property to false to keep the 
    ' selection highlighted when the user leaves the control. 
    Me.TreeView2.HideSelection = False

    ' Add the nodes.
    Me.TreeView2.Nodes.AddRange(New System.Windows.Forms.TreeNode()
 _
        {New System.Windows.Forms.TreeNode("Features",
 _
        New System.Windows.Forms.TreeNode() _
        {New System.Windows.Forms.TreeNode("Full Color"),
 _
        New System.Windows.Forms.TreeNode("Project
 Wizards"), _
        New System.Windows.Forms.TreeNode("Visual
 C# and Visual Basic Support")}), _
        New System.Windows.Forms.TreeNode("System
 Requirements", _
        New System.Windows.Forms.TreeNode() _
        {New System.Windows.Forms.TreeNode _
        ("Pentium 133 MHz or faster processor "),
 _
        New System.Windows.Forms.TreeNode("Windows
 98 or later"), _
        New System.Windows.Forms.TreeNode("100
 MB Disk space")})})

    ' Set the tab index and add the TreeView to the form.
    Me.TreeView2.TabIndex = 0
    Me.Controls.Add(Me.TreeView2)
End Sub

C#

// Declare the TreeView control.
internal System.Windows.Forms.TreeView TreeView2;

// Initialize the TreeView to blend with the form, giving it the 
// same color as the form and no border.
private void InitializeSelectedTreeView()
{

    // Create a new TreeView control and set the location and size.
    this.TreeView2 = new System.Windows.Forms.TreeView();
    this.TreeView2.Location = new System.Drawing.Point(72,
 48);
    this.TreeView2.Size = new System.Drawing.Size(200,
 200);

    this.TreeView2.BorderStyle = BorderStyle.Fixed3D;
    
    // Set the HideSelection property to false to keep the 
    // selection highlighted when the user leaves the control. 
    // This helps it blend with form.
    this.TreeView2.HideSelection = false;

    // Add the nodes.
    this.TreeView2.Nodes.AddRange(new TreeNode[]
        {new TreeNode("Features", 
            new TreeNode[]{
            new TreeNode("Full Color"), 
            new TreeNode("Project Wizards"), 
            new TreeNode("Visual C# and Visual Basic Support")}),
 
            new TreeNode("System Requirements", 
            new TreeNode[]{
                new TreeNode("Pentium 133 MHz or faster processor
 "),
                new TreeNode("Windows 98 or later"),
 
                new TreeNode("100 MB Disk space")})
        });

    // Set the tab index and add the TreeView to the form.
    this.TreeView2.TabIndex = 0;
    this.Controls.Add(this.TreeView2);
}

J#

// Declare the TreeView control.
System.Windows.Forms.TreeView treeView2;

// Initialize the TreeView to blend with the form, giving it the 
// same color as the form and no border.
private void InitializeSelectedTreeView()
{
    // Create a new TreeView control and set the location and size.
    this.treeView2 = new System.Windows.Forms.TreeView();
    this.treeView2.set_Location(new System.Drawing.Point(72,
 48));
    this.treeView2.set_Size(new System.Drawing.Size(200,
 200));
    
    // Set the BorderStyle property to none, the BackColor property
 to
    // the form's backcolor, and the Scrollable property to false. 
 
    // This allows the TreeView to blend in form.
    this.treeView2.set_BorderStyle(BorderStyle.Fixed3D);
           
    // Set the HideSelection property to false to keep the 
    // selection highlighted when the user leaves the control. 
    this.treeView2.set_HideSelection(false);
   
    // Add the nodes.
    this.treeView2.get_Nodes().AddRange(
        new TreeNode[] {new TreeNode("Features"
,
        new TreeNode[] { new TreeNode("Full
 Color"),
        new TreeNode("Project Wizards"),
        new TreeNode("Visual C# and Visual Basic Support")
 }),
        new TreeNode("System Requirements",
        new TreeNode[] {
        new TreeNode("Pentium 133 MHz or faster processor
 "),
        new TreeNode("Windows 98 or later"),
        new TreeNode("100 MB Disk space") }) });
    
    // Set the tab index and add the TreeView to the form.
    this.treeView2.set_TabIndex(0);
    this.get_Controls().Add(this.treeView2);
} 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
TreeView クラス
TreeView メンバ
System.Windows.Forms 名前空間
SelectedNode