ToolTipService 類別

參考

定義

命名空間:: System.Windows.Controls

組件:: PresentationFramework.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示提供屬性和事件的服務，以控制工具提示的顯示和行為。

public ref class ToolTipService abstract sealed

public static class ToolTipService

type ToolTipService = class

Public Class ToolTipService

繼承: Object
ToolTipService

範例

下列範例示範如何使用 ToolTipService 類別來指定工具提示的行為。您可以將屬性直接附加至公開工具提示的元素，以設定類別的屬性 ToolTipService 。

<Ellipse Height="25" Width="50" 
      Fill="Gray" 
      HorizontalAlignment="Left"
      ToolTipService.InitialShowDelay="1000"
      ToolTipService.ShowDuration="7000"
      ToolTipService.BetweenShowDelay="2000"
      ToolTipService.Placement="Right" 
      ToolTipService.PlacementRectangle="50,0,0,0"
      ToolTipService.HorizontalOffset="10" 
      ToolTipService.VerticalOffset="20"
      ToolTipService.HasDropShadow="false"
      ToolTipService.ShowOnDisabled="true" 
      ToolTipService.IsEnabled="true"
      ToolTipOpening="whenToolTipOpens"
      ToolTipClosing="whenToolTipCloses"
      >
  <Ellipse.ToolTip>
    <BulletDecorator>
      <BulletDecorator.Bullet>
        <Ellipse Height="10" Width="20" Fill="Blue"/>
      </BulletDecorator.Bullet>
      <TextBlock>Uses the ToolTipService class</TextBlock>
    </BulletDecorator>
  </Ellipse.ToolTip>
</Ellipse>

備註

您可以藉由設定 FrameworkContentElement.ToolTip 或 FrameworkElement.ToolTip 屬性來定義元素的工具提示。 ToolTip 屬性會採用一個子系。子系的內容可能會因簡單文字字串而異，而更複雜的內容，例如 StackPanel 具有內嵌文字和 Image 元素的。

您可以將工具提示內容 ToolTip 定義為物件，但這並非必要專案。當您未將工具提示內容 ToolTip 定義為物件時，您可以使用 ToolTipService 屬性來定位和自訂工具提示內容。類別的 ToolTipService 附加屬性可用來判斷工具提示的位置、行為和外觀。這些屬性是在定義工具提示的元素上設定。

類別 ToolTip 和 ToolTipService 類別共用許多用來自訂工具提示的相同屬性。如果同時設定對等 ToolTip 和 ToolTipService 屬性，則 ToolTipService 屬性會優先使用。例如，如果 ToolTip.Placement 屬性和 ToolTipService.Placement 屬性都設定為 System.Windows.Controls.ToolTip 物件，則會使用屬性的值 ToolTipService.Placement 。

下列 ToolTipService 計時屬性只會針對類別定義， ToolTipService 並供所有工具提示使用：

如需如何處理工具提示開啟或關閉時所發生之事件的資訊，請參閱 ToolTipOpeningEvent 和 ToolTipClosingEvent 欄位。

Placement、 PlacementRectangle 、 PlacementTarget 、 HorizontalOffset 和 VerticalOffset 的行為類似于類別中 Popup 相同名稱的屬性。如需詳細資訊，請參閱快顯放置行為。

欄位

BetweenShowDelayProperty	識別 BetweenShowDelay 附加屬性。
HasDropShadowProperty	識別 HasDropShadow 附加屬性。
HorizontalOffsetProperty	識別 HorizontalOffset 附加屬性。
InitialShowDelayProperty	識別 InitialShowDelay 附加屬性。
IsEnabledProperty	識別 IsEnabled 附加屬性。
IsOpenProperty	識別 IsOpen 附加屬性。
PlacementProperty	識別 Placement 附加屬性。
PlacementRectangleProperty	識別 PlacementRectangle 附加屬性。
PlacementTargetProperty	識別 PlacementTarget 附加屬性。
ShowDurationProperty	識別 ShowDuration 附加屬性。
ShowOnDisabledProperty	識別 ShowOnDisabled 附加屬性。
ShowsToolTipOnKeyboardFocusProperty	表示提供屬性和事件的服務，以控制工具提示的顯示和行為。
ToolTipClosingEvent	識別由使用 ToolTipClosing 服務以顯示工具提示之物件公開 ToolTipService 事件。
ToolTipOpeningEvent	識別由使用 ToolTipOpening 服務以顯示工具提示之物件公開 ToolTipService 事件。
ToolTipProperty	識別 ToolTip 附加屬性。
VerticalOffsetProperty	識別 VerticalOffset 附加屬性。

附加屬性

BetweenShowDelay	取得或設定顯示兩個工具提示的最大間隔時間，其中第二個工具提示會在未經延遲的情況下立即顯示。
HasDropShadow	取得或設定工具提示是否顯示延伸陰影效果。
HorizontalOffset	取得或設定 PlacementRectangle 和 PlacementTarget 屬性為工具提示所指定區域左邊的位移。
InitialShowDelay	取得或設定工具提示開啟之前的時間長度。
IsEnabled	取得或設定是否顯示工具提示。
IsOpen	取得值，指出工具提示目前是否為可見。
Placement	取得或設定工具提示開啟時的方向，並指定該工具提示與螢幕邊界重疊時的行為。
PlacementRectangle	取得或設定相對於工具提示所在位置的矩形區域。
PlacementTarget	取得或設定相對於工具提示所在位置的物件。
ShowDuration	取得或設定工具提示保持可見的時間量。
ShowOnDisabled	取得或設定是否顯示未啟用物件的工具提示。
ShowsToolTipOnKeyboardFocus	表示提供屬性和事件的服務，以控制工具提示的顯示和行為。
ToolTip	取得或設定工具提示的內容。
VerticalOffset	取得或設定 PlacementRectangle 和 PlacementTarget 屬性為工具提示所指定區域頂端的距離。

方法

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	加入 ToolTipClosing 附加事件的處理常式。
AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	加入 ToolTipOpening 附加事件的處理常式。
GetBetweenShowDelay(DependencyObject)	取得物件之 BetweenShowDelay 附加屬性的值。
GetHasDropShadow(DependencyObject)	取得物件之 HasDropShadow 附加屬性的值。
GetHorizontalOffset(DependencyObject)	取得物件之 HorizontalOffset 附加屬性的值。
GetInitialShowDelay(DependencyObject)	取得物件之 InitialShowDelay 附加屬性的值。
GetIsEnabled(DependencyObject)	取得物件之 IsEnabled 附加屬性的值。
GetIsOpen(DependencyObject)	取得物件之 IsOpen 附加屬性的值。
GetPlacement(DependencyObject)	取得物件之 Placement 附加屬性的值。
GetPlacementRectangle(DependencyObject)	取得物件之 PlacementRectangle 附加屬性的值。
GetPlacementTarget(DependencyObject)	取得物件之 PlacementTarget 附加屬性的值。
GetShowDuration(DependencyObject)	取得物件之 ShowDuration 附加屬性的值。
GetShowOnDisabled(DependencyObject)	取得物件之 ShowOnDisabled 附加屬性的值。
GetShowsToolTipOnKeyboardFocus(DependencyObject)	表示提供屬性和事件的服務，以控制工具提示的顯示和行為。
GetToolTip(DependencyObject)	取得物件之 ToolTip 附加屬性的值。
GetVerticalOffset(DependencyObject)	取得物件之 VerticalOffset 附加屬性的值。
RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	移除 ToolTipClosing 附加事件的處理常式。
RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	移除 ToolTipOpening 附加事件的處理常式。
SetBetweenShowDelay(DependencyObject, Int32)	設定物件的 BetweenShowDelay 附加屬性值。
SetHasDropShadow(DependencyObject, Boolean)	設定物件的 HasDropShadow 附加屬性值。
SetHorizontalOffset(DependencyObject, Double)	設定物件的 HorizontalOffset 附加屬性值。
SetInitialShowDelay(DependencyObject, Int32)	設定物件的 InitialShowDelay 附加屬性值。
SetIsEnabled(DependencyObject, Boolean)	設定物件的 IsEnabled 附加屬性值。
SetPlacement(DependencyObject, PlacementMode)	設定物件的 Placement 附加屬性值。
SetPlacementRectangle(DependencyObject, Rect)	設定物件的 PlacementRectangle 附加屬性值。
SetPlacementTarget(DependencyObject, UIElement)	設定物件的 PlacementTarget 附加屬性值。
SetShowDuration(DependencyObject, Int32)	設定物件的 ShowDuration 附加屬性值。
SetShowOnDisabled(DependencyObject, Boolean)	設定物件的 ShowOnDisabled 附加屬性值。
SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)	表示提供屬性和事件的服務，以控制工具提示的顯示和行為。
SetToolTip(DependencyObject, Object)	設定物件的 ToolTip 附加屬性值。
SetVerticalOffset(DependencyObject, Double)	設定物件的 VerticalOffset 附加屬性值。

附加事件

ToolTipClosing	發生於 ToolTip 關閉時。
ToolTipOpening	在 ToolTip 開啟時發生。

適用於

ToolTipService 類別

定義

範例

備註

欄位

附加屬性

方法

附加事件

適用於

另請參閱

意見反應

其他資源