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

See also

IComponent::Notify

IHeaderCtrl2

MMCN_FILTER_CHANGE

MMC_FILTER_CHANGE_CODE

Adding Filtered Views