estructura de MMC_FILTERDATA (mmc.h)

La estructura MMC_FILTERDATA se introduce en MMC 1.2.

La estructura MMC_FILTERDATA la usan los métodos IHeaderCtrl2::GetColumnFilter e IHeaderCtrl2::SetColumnFilter para recuperar y establecer el valor de filtro de una columna en una vista de lista filtrada.

Sintaxis

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

Miembros

pszText

Cuando un complemento establece un valor de filtro de texto, pszText apunta a la cadena de filtro para establecer y cchTextMax establece la longitud máxima de la cadena de filtro que el usuario puede escribir en el campo de filtro. Cuando un complemento lee un valor de filtro de texto, pszText apunta a un búfer para recibir el texto y cchTextMax proporciona la longitud del búfer.

cchTextMax

Para obtener más información, consulte la descripción de pszText.

lValue

Cuando un complemento establece un valor de filtro numérico, lValue contiene el valor de filtro. El campo de filtro convierte el valor en una cadena y lo coloca en el control de filtro. Cuando un complemento lee un valor de filtro numérico, el valor del filtro actual se convierte en binario y se devuelve en lValue.

Comentarios

Se puede usar un valor de filtro numérico cuando la columna que está filtrando solo tiene valores numéricos en lugar de cadenas de texto arbitrarias. La ventaja de usar un filtro numérico es que el filtro controla la conversión entre el binario y el texto al establecer y leer el valor del filtro. Además, el control de filtro solo permite a un usuario escribir caracteres numéricos en un filtro numérico.

Al controlar un filtro de texto, se omite lValue. De forma similar, al controlar un filtro numérico, se omiten pszText y cchTextMax.

Para establecer y leer valores de filtro, el complemento posee la estructura de MMC_FILTERDATA y cualquier búfer de texto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	mmc.h