Поделиться через

структура MMC_FILTERDATA (mmc.h)

  • Статья

Структура MMC_FILTERDATA представлена в MMC 1.2.

Структура MMC_FILTERDATA используется методами IHeaderCtrl2::GetColumnFilter и IHeaderCtrl2::SetColumnFilter для получения и задания значения фильтра столбца в представлении отфильтрованного списка.

Синтаксис

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 и любым текстовым буфером.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Верхняя часть mmc.h