[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
   [Expand]Focus and Navigation
   [Expand]Printing and Exporting
   [Expand]Design-Time Features
     Hints and Tooltips
     Hit Information
     Copy Data to the Clipboard
   [Expand]UI Elements
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Hints and Tooltips

The PivotGridControl supports hints (tooltips) for field headers, field values, and cells. Hints are displayed if text within an element's region is clipped.

Expanded Customizing Tooltips using Properties

Hints are usually displayed when an end-user hovers the mouse pointer over a visual element (for example, a field header or cell) whose contents are truncated. The image below shows a hint for a truncated field header.


The Pivot Grid provides a set of options that specify which elements can display hints. To access these options, use the PivotGridControl.OptionsHint property. The table below lists these options and their descriptions.

Option Description
PivotGridOptionsHint.ShowCellHints Specifies whether hints are displayed for cells with truncated content.
PivotGridOptionsHint.ShowHeaderHints Specifies whether hints are displayed for field headers with truncated captions.
PivotGridOptionsHint.ShowValueHints Specifies whether hints are displayed for field values that are truncated.


It is also possible to specify custom hints using each field's PivotGridField.ToolTips property. This property returns the PivotGridFieldToolTips object that allows you to specify the hint that is displayed when you hover over a field's header and values.

Note that you can use the Tooltip Controller to manage the tooltips of all DevExpress controls and elements. To learn more, see Tooltip Controller.

Expanded Customizing Tooltips using the Event

The PivotGridControl.FieldTooltipShowing event occurs when a tooltip is about to be invoked, for example, when an end-user hovers the mouse over a trimmed caption. This event allows you to cancel invoking the tooltip, or specify the hint's custom text.

You can define which element is located at particular screen coordinates using the event's PivotFieldTooltipShowingEventArgs.HitInfo property. See Hit Information to learn more about defining of visual elements.

The following PivotFieldTooltipShowingEventArgs properties provide information specific to this event:

Option Description
PivotFieldTooltipShowingEventArgs.HitInfo Gets information about the point where the tooltip should be invoked.
PivotFieldTooltipShowingEventArgs.Point Gets the coordinates of the point where the tooltip should be invoked.
PivotFieldTooltipShowingEventArgs.ShowTooltip Gets or sets whether to show the tooltip.
PivotFieldTooltipShowingEventArgs.Text Gets or sets the tooltip text.

Expanded Customizing Tooltips using the Tooltip Controller

Tooltips can be managed by using the ToolTipController component, which provides the hint settings. It allows you to customize hint appearances, specify icons displayed in hints and set the time interval between invoking/hiding hints, etc. To learn how to use this component, see the Tooltip Management section.

Expanded See Also

Is this topic helpful?​​​​​​​