MMCN_FILTERBTN_CLICK message
The MMCN_FILTERBTN_CLICK notification is introduced in MMC 1.2.
The MMCN_FILTERBTN_CLICK notification message is sent to the snap-in's IComponent implementation when the user clicks the filter button on the header control of a filtered view. The snap-in responds to this notification by that displays a user interface element that allows the user to change the filter operator. Be aware that the filtered view mode does not affect the sort settings on the filtered list.
Parameters
-
lpDataObject [in]
-
Not used (NULL).
-
arg [in]
-
ID of the column whose filter button was clicked.
-
param [in]
-
A pointer to a RECT structure (LPRECT) with the coordinates of the filter button. The snap-in can use the contents of the structure to position the user interface element (usually a menu) used to change the filter operator.
Return value
-
S_OK
-
The snap-in modified the filter operator and generates an MMCN_FILTER_CHANGE event.
-
S_FALSE
-
The snap-in did not change the filter operator, or has already updated the filtered list.
Remarks
After the user's changes to the filter operator have been handled by the snap-in, the message handler returns S_OK to generate an MMCN_FILTER_CHANGE notification with arg set to MFCC_VALUE_CHANGE and param set to the column ID of the affected filtered view column.
Requirements
Minimum supported client |
Windows Vista |
Minimum supported server |
Windows Server 2008 |
Header |
|