CExtGridWnd::OnGridHookCellQueryButtonInfo

Professional User Interface Suite, Copyright FOSS Software Inc. Help Published with Permission.

Called to query the information about the state and behavior of the built-in button specified by the nButtonType parameter. The method returns false if the button is not used.

virtualbool OnGridHookCellQueryButtonInfo(
   INT nButtonType,
   const CExtGridCell & _cell,
   LONG nColNo,
   LONG nRowNo,
   INT nColType,
   INT nRowType
   bool * p_bEnabled,
   bool * p_bPressed,
   bool * p_bStayPressed,
   UINT * p_nTimerElapseValue,
   bool & bRetVal
) const;

Parameters

nButtonType
Specifies the button type. All available button types are listed in the CExtGridCell::e_button_type_t enumeration.
_cell
Reference to the cell object.
nColNo
Column index.
nRowNo
Row index.
nColType
Type of column (0 - inner column, -1 - outer column on left, 1 - outer column on right).
nRowType
Type of row (0 - inner row, -1 - outer row at top, 1 - outer row at bottom).
p_bEnabled
Pointer to the variable in which true should be saved if the button is enabled. Set NULL for this argument if you are not interested in this value.
p_bPressed
Pointer to the variable in which true should be saved if the button is pressed. Set NULL for this argument if you are not interested in this value.
p_bStayPressed
Pointer to the variable in which true should be saved if the button is ″permanently pressed″. Set NULL for this argument if you are not interested in this value.
p_nTimerElapseValue
Pointer to the variable in which the number of milliseconds specifying the frequency of calls made to the OnButtonPressing method should be saved. Set NULL for this argument if you are not interested in this value. Set zero for this argument so that the OnButtonPressing will not be called when the grid control tracks the built-in button. This feature is applied to the built-in up/down button.

Remarks

It is a version of the CExtGridCell::OnQueryButtonInfo() method, that is called at the grid level.

See Also

CExtGridWnd Overview | Class Members | Hierarchy Chart