FrameworkElement.ToolTip 屬性

定義

取得或設定工具提示物件,該物件會為使用者介面 (UI)user interface (UI) 中的這個項目而顯示。Gets or sets the tool-tip object that is displayed for this element in the 使用者介面 (UI)user interface (UI).

public:
 property System::Object ^ ToolTip { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.ToolTip)]
public object ToolTip { get; set; }
member this.ToolTip : obj with get, set
Public Property ToolTip As Object

屬性值

工具提示物件。The tooltip object.

屬性

範例

下列範例會在程式碼中建立 ToolTip,然後在 StatusBar 控制項上設定 ToolTip 屬性。The following example creates a ToolTip in code and then sets the ToolTip property on a StatusBar control.

private void MakeProgressBar(object sender, RoutedEventArgs e)
{
    sbar.Items.Clear();
    TextBlock txtb = new TextBlock();
    txtb.Text = "Progress of download.";
    sbar.Items.Add(txtb);
    ProgressBar progressbar = new ProgressBar();
    progressbar.Width = 100;
    progressbar.Height = 20;
    Duration duration = new Duration(TimeSpan.FromSeconds(5));
    DoubleAnimation doubleanimation =
                               new DoubleAnimation(100.0, duration);
    progressbar.BeginAnimation(ProgressBar.ValueProperty,
                               doubleanimation);
    ToolTip ttprogbar = new ToolTip();
    ttprogbar.Content = "Shows the progress of a download.";
    progressbar.ToolTip = (ttprogbar);
    sbar.Items.Add(progressbar);
}
Private Sub MakeProgressBar(ByVal sender As Object, ByVal e As RoutedEventArgs)
    sbar.Items.Clear()
    Dim txtb As New TextBlock()
    txtb.Text = "Progress of download."
    sbar.Items.Add(txtb)
    Dim progressbar As New ProgressBar()
    progressbar.Width = 100
    progressbar.Height = 20
    Dim duration As New Duration(TimeSpan.FromSeconds(5))
    Dim doubleanimation As New DoubleAnimation(100.0, duration)
    progressbar.BeginAnimation(ProgressBar.ValueProperty, doubleanimation)
    Dim ttprogbar As New ToolTip()
    ttprogbar.Content = "Shows the progress of a download."
    progressbar.ToolTip = (ttprogbar)
    sbar.Items.Add(progressbar)
End Sub

備註

如果這個屬性的值是 ToolTip類型,則該值是將在 UIUI中使用的工具提示。If the value of this property is of type ToolTip, then that value is the tool-tip that will be used in the UIUI. 如果值為任何其他類型,則該值將作為系統所提供(已建立)之 ToolTip內容If the value is of any other type, then that value will be used as the content for a ToolTip provided (constructed) by the system. 如需詳細資訊,請參閱 ToolTipServiceFor more information, see ToolTipService. 服務類別提供附加屬性,可用來進一步自訂 ToolTipThe service class provides attached properties that can be used to further customize a ToolTip.

XAML Attribute UsageXAML Attribute Usage

<object ToolTip="toolTipContent"/>  

XAML 屬性項目用法XAML Property Element Usage

<object>  
  <object.ToolTip>  
    <ToolTip .../>  
  </object.ToolTip>  
</object>

-或--or-

<object>  
  <object.ToolTip>  
    toolTipObjectContent  
  </object.ToolTip>  
</object>  

XAML 值XAML Values

toolTipContenttoolTipContent
字串,會成為 ToolTip的顯示文字。A string that becomes the display text for the ToolTip.

toolTipObjectContenttoolTipObjectContent
在物件專案表單中提供的某些物件,應該用來做為 FrameworkElement 的內容。Some object, provided in object element form, that should be used as the content for the FrameworkElement . 通常這會是 FrameworkElement 或一些其他元素,以建立 ToolTip的版面配置組合,最後包含複合中的文字內容。Typically this would be a FrameworkElement or some other element that creates layout compositing for the ToolTip, eventually containing text content within the compositing. 在此用法中,會以隱含的方式從剖析的 XAMLXAML建立 ToolTip 專案,並將toolTipObjectContent內容設定為其 ContentControl.Content 屬性。In this usage, the ToolTip element is created implicitly from the parsed XAMLXAML, and the toolTipObjectContent content is set as its ContentControl.Content property.

<ToolTip .../><ToolTip .../>
請參閱<ToolTip>。See ToolTip.

相依性屬性資訊Dependency Property Information

識別碼欄位Identifier field ToolTipProperty
設定為 true 的中繼資料屬性Metadata properties set to true NoneNone

適用於