Returns a pointer to a control bar that contains the given point.
- Returns
- A pointer to a CBCGPBaseControlBar - derived object that contains the given point or NULL.
This function is used to determine a control bar that contains the point specified by point according to the specified conditions such as runtime class and visibility. When the function returns and a control bar was found, dwAlignment will contain the alignment of the specified point. For example, if the point was close to the top of the control bar, dwAlignment will contain CBRS_ALIGN_TOP value.
- Parameters
-
| point | Specifies the point to check in the screen coordinates. |
| nSensitivity | The window rectangle of each checked control bar is inflated according to this value and a control bar may satisfy the search criteria even if the given point is not contained in a control bar. |
| dwAlignment | If a control bar was found, this parameter will contain the closest to the specified point control bar side . |
| pRTCBarType | If not NULL the function iterates only control bars of the type specified. |
| pBarToIgnore | If not NULL the function will ignore the control bar specified by this parameter. |
