ListView.ShowItemToolTips Property

Definition

获取或设置一个值,该值指示是否为 ListViewItem 中包含的 ListView 对象显示工具提示。Gets or sets a value indicating whether ToolTips are shown for the ListViewItem objects contained in the ListView.

public:
 property bool ShowItemToolTips { bool get(); void set(bool value); };
public bool ShowItemToolTips { get; set; }
member this.ShowItemToolTips : bool with get, set
Public Property ShowItemToolTips As Boolean

Property Value

Boolean

如果应显示 ListViewItem 工具提示,则为 true;否则为 falsetrue if ListViewItem ToolTips should be shown; otherwise, false. 默认为 trueThe default is true.

Examples

下面的代码示例演示如何使用 "ShowItemToolTips" 和 "ListViewItem.ToolTipText" 属性。The following code example demonstrates how to use the ShowItemToolTips and ListViewItem.ToolTipText properties. 若要运行此示例,请将代码粘贴到 Windows 窗体中,并从窗体的构造函数或 Load 事件处理程序调用 InitializeItemsWithToolTipsTo run this example, paste the code into a Windows Form and call InitializeItemsWithToolTips from the form's constructor or Load event handler.


// Declare the ListView.
private ListView ListViewWithToolTips;
private void InitializeItemsWithToolTips()
{

    // Construct and set the View property of the ListView.
    ListViewWithToolTips = new ListView();
    ListViewWithToolTips.Width = 200;
    ListViewWithToolTips.View = View.List;

    // Show item tooltips.
    ListViewWithToolTips.ShowItemToolTips = true;
    
    // Create items with a tooltip.
    ListViewItem item1WithToolTip = new ListViewItem("Item with a tooltip");
    item1WithToolTip.ToolTipText = "This is the item tooltip.";
    ListViewItem item2WithToolTip = new ListViewItem("Second item with a tooltip");
    item2WithToolTip.ToolTipText = "A different tooltip for this item.";

    // Create an item without a tooltip.
    ListViewItem itemWithoutToolTip = new ListViewItem("Item without tooltip.");

    // Add the items to the ListView.
    ListViewWithToolTips.Items.AddRange(new ListViewItem[]{item1WithToolTip, 
        item2WithToolTip, itemWithoutToolTip} );

    // Add the ListView to the form.
    this.Controls.Add(ListViewWithToolTips);
    this.Controls.Add(button1);
}
' Declare the ListView.
Private ListViewWithToolTips As ListView

Private Sub InitializeItemsWithToolTips() 
    
    ' Construct and set the View property of the ListView.
    ListViewWithToolTips = New ListView()
    ListViewWithToolTips.Width = 200
    ListViewWithToolTips.View = View.List
    
    ' Show item tooltips.
    ListViewWithToolTips.ShowItemToolTips = True
    
    ' Create items with a tooltip.
    Dim item1WithToolTip As New ListViewItem("Item with a tooltip")
    item1WithToolTip.ToolTipText = "This is the item tooltip."
    Dim item2WithToolTip As New ListViewItem("Second item with a tooltip")
    item2WithToolTip.ToolTipText = "A different tooltip for this item."
    
    ' Create an item without a tooltip.
    Dim itemWithoutToolTip As New ListViewItem("Item without tooltip.")
    
    ' Add the items to the ListView.
    ListViewWithToolTips.Items.AddRange(New ListViewItem() _
        {item1WithToolTip, item2WithToolTip, itemWithoutToolTip})
    
    ' Add the ListView to the form.
    Me.Controls.Add(ListViewWithToolTips)
    Me.Controls.Add(button1)

End Sub

Remarks

如果 ShowItemToolTips 属性设置为 true,则具有工具提示的所有 ListViewItem 都将显示该属性;否则,不会显示任何内容。If the ShowItemToolTips property is set to true, any ListViewItem that has a ToolTip will display it; otherwise, nothing is displayed.

Applies to