MMC_FILTERDATA 结构 (mmc.h)

MMC 1.2 中引入了MMC_FILTERDATA结构。

IHeaderCtrl2：：GetColumnFilter 和 IHeaderCtrl2：：SetColumnFilter 方法使用 MMC_FILTERDATA 结构来检索和设置筛选列表视图中列的筛选值。

语法

typedef struct _MMC_FILTERDATA {
  LPOLESTR pszText;
  INT      cchTextMax;
  LONG     lValue;
} MMC_FILTERDATA;

pszText

当管理单元设置文本筛选器值时，pszText 指向要设置的筛选器字符串，cchTextMax 设置用户可以在筛选器字段中键入的筛选器字符串的最大长度。当管理单元读取文本筛选器值时，pszText 指向一个缓冲区来接收文本，cchTextMax 会提供缓冲区的长度。

cchTextMax

有关详细信息，请参阅 pszText 的说明。

lValue

当管理单元设置数字筛选器值时，lValue 包含筛选器值。筛选器字段将值转换为字符串，并将其置于筛选器控件中。当管理单元读取数字筛选器值时，当前筛选器值将转换为二进制值，并在 lValue 中返回。

当要筛选的列仅包含数值而不是任意文本字符串时，可以使用数字筛选器值。使用数字筛选器的优点是，在设置和读取筛选器值时，筛选器处理二进制文件与文本之间的转换。此外，筛选器控件仅允许用户在数字筛选器中键入数字字符。

处理文本筛选器时，忽略 lValue。同样，处理数字筛选器时，将忽略 pszText 和 cchTextMax。

对于设置和读取筛选器值，管理单元拥有MMC_FILTERDATA结构和任何文本缓冲区。