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.v24.2.dll
Declaration
Property Value
| Type | Description |
|---|---|
| CardHitTest | A CardHitTest enumeration value identifying the type of the visual element located under the test point. |
Available values:
| 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.