Skip to main content

CardHitInfo.HitTest Property

Gets or sets a value identifying the type of the visual element located under the test point.

Namespace: DevExpress.XtraGrid.Views.Card.ViewInfo

Assembly: DevExpress.XtraGrid.v22.1.dll

NuGet Package: DevExpress.Win.Grid

Declaration

public CardHitTest HitTest { get; set; }

Property Value

Type Description
CardHitTest

A CardHitTest enumeration value identifying the type of the visual element located under the test point.

Available values:

Show 21 items
Name Description
None

The test point does not belong to any Card View visual element or is outside the View.

Card

The test point belongs to a card‘s area not occupied by card constituent elements (in other words, the point belongs to a card’s edge).

CardCaption

The test point belongs to a card’s caption.

CardExpandButton

The test point belongs to the card expand button that resides within the card caption and is used to expand/collapse the card.

Field

The test point belongs to a card field‘s area which is not occupied by the field caption or field value cell (in other words, the point belongs to a field edge).

FieldCaption

The test point belongs to a field caption.

FieldValue

The test point belongs to a field value cell.

Separator

The test point belongs to a card separator.

CardUpButton

The test point belongs to a top card scroll button.

CardDownButton

The test point belongs to a bottom card scroll button.

CardCaptionErrorIcon

The test point belongs to an error icon displayed within a card caption. Such error icons are displayed when cards fail to be validated.

QuickCustomizeButton

The test point belongs to the customization button.

CloseZoomButton

The test point belongs to a Card View’s zoom button.

FilterPanel

The test point belongs to a filter panel.

FilterPanelCloseButton

The test point belongs to a filter panel close button.

FilterPanelActiveButton

The test point belongs to the check box in the filter panel used to enable/disable filtering within a Card View.

FilterPanelText

The test point belongs to a string in the filter panel which represents the filter criteria applied to a Card View.

FilterPanelMRUButton

The test point belongs to a button in the filter panel used to display a dropdown window with a list of the most recently used filter criteria.

FilterPanelCustomizeButton

The test point belongs to the filter panel customize button.

ViewCaption

The test point belongs to the View Caption.

MasterTabPageHeader

The test point belongs to the View’s master-detail tab.

Remarks

Some View elements (card, filter panel, etc.) can display other elements within them. For instance, the filter panel can display buttons and filter criteria. Thus, care needs to be taken when using the HitTest property. To determine whether the test point is over the filter panel, it’s not enough to compare the property’s value with the CardHitTest.FilterPanel. Because a constituent element of the panel may reside under the test point and the HitTest property may return CardHitTest.FilterPanelCloseButton, CardHitTest.FilterPanelText, etc. In such cases, it’s better to use the other properties of the CardHitInfo object. For example the CardHitInfo.InFilterPanel property.

See Also