WinExplorerView.CustomContextButtonToolTip Event

Allows you to specify a tooltip shown when the mouse pointer hovers over a context button. This event is only raised for RatingContextButton and TrackBarContextButton objects.

Namespace: DevExpress.XtraGrid.Views.WinExplorer

Assembly: DevExpress.XtraGrid.v24.2.dll

Declaration

C#

[DXCategory("Context Buttons")]
public event WinExplorerViewContextButtonToolTipEventHandler CustomContextButtonToolTip

VB.NET

<DXCategory("Context Buttons")>
Public Event CustomContextButtonToolTip As WinExplorerViewContextButtonToolTipEventHandler

Event Data

The CustomContextButtonToolTip event's data class is WinExplorerViewContextButtonToolTipEventArgs. The following properties provide information specific to this event:

Property	Description
Item	Gets the currently processed context button.
RowHandle	Gets the row handle of the currently processed data record.
Text	Gets or sets the tooltip text.
Value	Gets the rating context button’s value for which a tooltip needs to be provided.

Remarks

Use a context button’s SuperTip property to assign a super tooltip to the button. To assign a regular tooltip, use the following properties:

• ToolTip — gets or sets the tooltip text.
• ToolTipTitle — gets or sets the title displayed above the text.
• ToolTipIconType — gets or sets the icon that indicates whether the tooltip contains an error, warning, question, or other information.

See the following topic for more information about regular and super tooltips: Hints and Tooltips.

Rating Scale and Track Bar

The RatingContextButton and TrackBarContextButton show the current rating and track value in the default tooltips.

You can handle the owner control’s CustomContextButtonToolTip or the button’s CustomToolTip event to specify custom tooltips. Use the Value event argument to obtain the current value and the Text event argument to specify the tooltip text.

Note

The owner control’s CustomContextButtonToolTip event fires after the button’s CustomToolTip event and overrides its tooltips. Also note that these events do not fire if a super or regular tooltip is assigned to the button.

Disable Tooltips

You can also disable the owner control’s ShowToolTips option to hide tooltips. The button’s ShowToolTips property overrides this option for an individual button.

C#

pictureEdit1.Properties.ContextButtonOptions.ShowToolTips = false;

VB.NET

pictureEdit1.Properties.ContextButtonOptions.ShowToolTips = False

Note

If a context button’s Enabled property is set to false, tooltips are not displayed regardless of the owner control’s ShowToolTips option or the button’s ShowToolTips property.

Example

The code below handles the WinExplorerView.CustomContextButtonToolTip event to assign different tooltips to each of the five rating grades.

C#

using DevExpress.XtraGrid.Views.WinExplorer;

private void winExplorerView1_CustomContextButtonToolTip(object sender, WinExplorerViewContextButtonToolTipEventArgs e) {
    if (e.Item.Name == "itemRating") {
        decimal rating = Convert.ToDecimal(e.Value);
        if (0 < rating && rating <= 1)
            e.Text = "Very Bad";
        else if (1 < rating && rating <= 2)
            e.Text = "Bad";
        else if (2 < rating && rating <= 3)
            e.Text = "Average";
        else if (3 < rating && rating <= 4)
            e.Text = "Good";
        else if (4 < rating && rating <= 5)
            e.Text = "Excellent";
        else
            e.Text = String.Empty;
    }
}

VB.NET

Imports DevExpress.XtraGrid.Views.WinExplorer

Private Sub winExplorerView1_CustomContextButtonToolTip(sender As Object, e As WinExplorerViewContextButtonToolTipEventArgs) _
    Handles winExplorerView1.CustomContextButtonToolTip
    If Equals(e.Item.Name, "itemRating") Then
        Dim rating As Decimal = Convert.ToDecimal(e.Value)
        If 0 < rating AndAlso rating <= 1 Then
            e.Text = "Very Bad"
        ElseIf 1 < rating AndAlso rating <= 2 Then
            e.Text = "Bad"
        ElseIf 2 < rating AndAlso rating <= 3 Then
            e.Text = "Average"
        ElseIf 3 < rating AndAlso rating <= 4 Then
            e.Text = "Good"
        ElseIf 4 < rating AndAlso rating <= 5 Then
            e.Text = "Excellent"
        Else
            e.Text = String.Empty
        End If
    End If
End Sub