共用方式為


ToolTipService 類別

定義

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

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
繼承
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.ToolTipFrameworkElement.ToolTip 屬性來定義元素的工具提示。 ToolTip 屬性會採用一個子系。 子系的內容可能會因簡單文字字串而異,而更複雜的內容,例如 StackPanel 具有內嵌文字和 Image 元素的 。

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

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

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

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

PlacementPlacementRectanglePlacementTargetHorizontalOffsetVerticalOffset 的行為類似于 類別中 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

取得或設定 PlacementRectanglePlacementTarget 屬性為工具提示所指定區域左邊的位移。

InitialShowDelay

取得或設定工具提示開啟之前的時間長度。

IsEnabled

取得或設定是否顯示工具提示。

IsOpen

取得值,指出工具提示目前是否為可見。

Placement

取得或設定工具提示開啟時的方向,並指定該工具提示與螢幕邊界重疊時的行為。

PlacementRectangle

取得或設定相對於工具提示所在位置的矩形區域。

PlacementTarget

取得或設定相對於工具提示所在位置的物件。

ShowDuration

取得或設定工具提示保持可見的時間量。

ShowOnDisabled

取得或設定是否顯示未啟用物件的工具提示。

ShowsToolTipOnKeyboardFocus

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

ToolTip

取得或設定工具提示的內容。

VerticalOffset

取得或設定 PlacementRectanglePlacementTarget 屬性為工具提示所指定區域頂端的距離。

方法

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 開啟時發生。

適用於

另請參閱