ToolTipService ToolTipService ToolTipService ToolTipService Class

定義

ツールヒントの表示と動作を制御するためのプロパティおよびイベントを提供するサービスを表します。Represents a service that provides properties and events to control the display and behavior of tooltips.

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
継承
ToolTipServiceToolTipServiceToolTipServiceToolTipService

次の例は、 ToolTipServiceクラスを使用して、ツールヒントの動作を指定する方法を示しています。The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. ToolTipServiceクラスのプロパティは、ツールヒントを公開する要素に直接アタッチすることによって設定します。You set the properties of the ToolTipService class by attaching them directly to the element that exposes the tooltip.

<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またはプロパティを設定します。You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. ToolTip プロパティは、1つの子を受け取ります。The ToolTip property takes one child. 子のコンテンツは、単純なテキスト文字列から、テキストとStackPanel Image要素が埋め込まれたなど、より複雑なコンテンツに変更されることがあります。The content of the child can vary from a simple text string to more complex content such as a StackPanel that has embedded text and Image elements.

ツールヒントコンテンツはToolTipオブジェクトとして定義できますが、これは必須ではありません。You can define tooltip content as a ToolTip object, but this is not required. ツールヒントの内容をToolTipオブジェクトとして定義しない場合は、 ToolTipServiceプロパティを使用して、ツールヒントの内容を配置したりカスタマイズしたりできます。When you do not define the tooltip content as a ToolTip object, you can use the ToolTipService properties to position and customize the tooltip content. ToolTipServiceクラスの添付プロパティは、ツールヒントの配置、動作、および外観を決定するために使用されます。Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. これらのプロパティは、ツールヒントを定義する要素に設定されます。These properties are set on the element that defines the tooltip.

ToolTip クラスToolTipServiceとクラスは、ツールヒントをカスタマイズするために使用されるのと同じプロパティの多くを共有します。The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. 同等ToolTipのプロパティToolTipServiceとプロパティの両方が設定ToolTipServiceされている場合は、プロパティが優先されます。If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. たとえば、 ToolTip.Placement ToolTipService.PlacementプロパティToolTipService.PlacementSystem.Windows.Controls.ToolTipプロパティの両方がオブジェクトに対して設定されている場合、プロパティの値が使用されます。For example, if both the ToolTip.Placement property and the ToolTipService.Placement property are set for a System.Windows.Controls.ToolTip object, the value of the ToolTipService.Placement property is used.

ToolTipServiceのタイミングプロパティはToolTipServiceクラスに対してのみ定義され、すべてのツールヒントによって使用されます。The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

ツールヒントが開いたり閉じたりしたときに発生するイベントを処理する方法にToolTipOpeningEventついToolTipClosingEventては、「」および「」のフィールドを参照してください。For information about how to handle the events that occur when the tooltip opens or closes, see the ToolTipOpeningEvent and ToolTipClosingEvent fields.

PlacementPlacementRectangle Popup 、、 、HorizontalOffset、およびVerticalOffsetは、クラス内の同じ名前のプロパティと同じように動作します。 PlacementTargetPlacement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. 詳細については、「Popup Placement Behavior」を参照してください。For more information, see Popup Placement Behavior.

フィールド

BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty

BetweenShowDelay 添付プロパティを識別します。Identifies the BetweenShowDelay attached property.

HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty

HasDropShadow 添付プロパティを識別します。Identifies the HasDropShadow attached property.

HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty

HorizontalOffset 添付プロパティを識別します。Identifies the HorizontalOffset attached property.

InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty

InitialShowDelay 添付プロパティを識別します。Identifies the InitialShowDelay attached property.

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

IsEnabled 添付プロパティを識別します。Identifies the IsEnabled attached property.

IsOpenProperty IsOpenProperty IsOpenProperty IsOpenProperty

IsOpen 添付プロパティを識別します。Identifies the IsOpen attached property.

PlacementProperty PlacementProperty PlacementProperty PlacementProperty

Placement 添付プロパティを識別します。Identifies the Placement attached property.

PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty

PlacementRectangle 添付プロパティを識別します。Identifies the PlacementRectangle attached property.

PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty

PlacementTarget 添付プロパティを識別します。Identifies the PlacementTarget attached property.

ShowDurationProperty ShowDurationProperty ShowDurationProperty ShowDurationProperty

ShowDuration 添付プロパティを識別します。Identifies the ShowDuration attached property.

ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty

ShowOnDisabled 添付プロパティを識別します。Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent

ToolTipClosing サービスを使用してツールヒントを表示するオブジェクトによって公開される ToolTipService イベントを識別します。Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent

ToolTipOpening サービスを使用してツールヒントを表示するオブジェクトによって公開される ToolTipService イベントを識別します。Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty ToolTipProperty ToolTipProperty ToolTipProperty

ToolTip 添付プロパティを識別します。Identifies the ToolTip attached property.

VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty

VerticalOffset 添付プロパティを識別します。Identifies the VerticalOffset attached property.

添付プロパティ

BetweenShowDelay BetweenShowDelay BetweenShowDelay BetweenShowDelay

2 番目のツールヒントを遅延なしで表示する場合の、2 つのツールヒントの表示間隔の最大時間を取得または設定します。Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow HasDropShadow HasDropShadow HasDropShadow

ツールヒントにドロップ シャドウ効果を表示するかどうかを取得または設定します。Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset

PlacementRectangle プロパティおよび PlacementTarget プロパティでツールヒントに対して指定した領域の左端からのオフセットを取得または設定します。Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay InitialShowDelay InitialShowDelay InitialShowDelay

ツールヒントが開くまでの時間を取得または設定します。Gets or sets the length of time before a tooltip opens.

IsEnabled IsEnabled IsEnabled IsEnabled

ツールヒントを表示するかどうかを取得または設定します。Gets or sets whether a tooltip appears.

IsOpen IsOpen IsOpen IsOpen

ツールヒントが現在表示されているかどうかを取得します。Gets whether a tooltip is currently visible.

Placement Placement Placement Placement

ツールヒントが開いたときの向きを取得または設定し、このツールヒントが画面の境界と重なった場合の動作を指定します。Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle

ツールヒントを相対的に配置するための基準である四角形の領域を取得または設定します。Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget PlacementTarget PlacementTarget PlacementTarget

ツールヒントを相対的に配置するための基準であるオブジェクトを取得または設定します。Gets or sets the object relative to which the tooltip is positioned.

ShowDuration ShowDuration ShowDuration ShowDuration

ツールヒントが表示される時間の長さを取得または設定します。Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled

有効でないオブジェクトに対してツールヒントを表示するかどうかを取得または設定します。Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip ToolTip ToolTip ToolTip

ツールヒントのコンテンツを取得または設定します。Gets or sets the content of a tooltip.

VerticalOffset VerticalOffset VerticalOffset VerticalOffset

PlacementRectangle プロパティおよび PlacementTarget プロパティによってツールヒントに対して指定されている領域の上端からの距離を取得または設定します。Gets or sets the distance from the top of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

メソッド

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

ToolTipClosing 添付イベントのハンドラーを追加します。Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

ToolTipOpening 添付イベントのハンドラーを追加します。Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject)

オブジェクトに対する BetweenShowDelay 添付プロパティの値を取得します。Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject)

オブジェクトに対する HasDropShadow 添付プロパティの値を取得します。Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject)

オブジェクトに対する HorizontalOffset 添付プロパティの値を取得します。Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject)

オブジェクトに対する InitialShowDelay 添付プロパティの値を取得します。Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject)

オブジェクトに対する IsEnabled 添付プロパティの値を取得します。Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject)

オブジェクトに対する IsOpen 添付プロパティの値を取得します。Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject)

オブジェクトに対する Placement 添付プロパティの値を取得します。Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject)

オブジェクトに対する PlacementRectangle 添付プロパティの値を取得します。Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject)

オブジェクトに対する PlacementTarget 添付プロパティの値を取得します。Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject)

オブジェクトに対する ShowDuration 添付プロパティの値を取得します。Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject)

オブジェクトに対する ShowOnDisabled 添付プロパティの値を取得します。Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject)

オブジェクトに対する ToolTip 添付プロパティの値を取得します。Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject)

オブジェクトに対する VerticalOffset 添付プロパティの値を取得します。Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

ToolTipClosing 添付イベントのハンドラーを削除します。Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

ToolTipOpening 添付イベントのハンドラーを削除します。Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32)

オブジェクトに対する BetweenShowDelay 添付プロパティの値を設定します。Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean)

オブジェクトに対する HasDropShadow 添付プロパティの値を設定します。Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double)

オブジェクトに対する HorizontalOffset 添付プロパティの値を設定します。Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32)

オブジェクトに対する InitialShowDelay 添付プロパティの値を設定します。Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean)

オブジェクトに対する IsEnabled 添付プロパティの値を設定します。Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode)

オブジェクトに対する Placement 添付プロパティの値を設定します。Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect)

オブジェクトに対する PlacementRectangle 添付プロパティの値を設定します。Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement)

オブジェクトに対する PlacementTarget 添付プロパティの値を設定します。Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32)

オブジェクトに対する ShowDuration 添付プロパティの値を設定します。Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean)

オブジェクトに対する ShowOnDisabled 添付プロパティの値を設定します。Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object)

オブジェクトに対する ToolTip 添付プロパティの値を設定します。Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double)

オブジェクトに対する VerticalOffset 添付プロパティの値を設定します。Sets the value of the VerticalOffset attached property for an object.

添付イベント

ToolTipClosing ToolTipClosing ToolTipClosing ToolTipClosing

ToolTip が閉じた場合に発生します。Occurs when the ToolTip closes.

ToolTipOpening ToolTipOpening ToolTipOpening ToolTipOpening

ToolTip が開くときに発生します。Occurs when the ToolTip opens.

適用対象

こちらもご覧ください