MMC_FILTERDATA 結構 (mmc.h)

MMC_FILTERDATA結構是在 MMC 1.2 中引進。

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結構和任何文字緩衝區。