ToolTipService 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示提供屬性和事件的服務,以控制工具提示的顯示和行為。
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.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 屬性為工具提示所指定區域頂端的距離。 |
方法
附加事件
ToolTipClosing |
發生於 ToolTip 關閉時。 |
ToolTipOpening |
在 ToolTip 開啟時發生。 |