MMC_FILTERDATA struttura (mmc.h)

La struttura MMC_FILTERDATA viene introdotta in MMC 1.2.

La struttura MMC_FILTERDATA viene usata dai metodi IHeaderCtrl2::GetColumnFilter e IHeaderCtrl2::SetColumnFilter per recuperare e impostare il valore del filtro di una colonna in una visualizzazione elenco filtrata.

Sintassi

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

Members

pszText

Quando uno snap-in imposta un valore di filtro di testo, pszText punta alla stringa di filtro per impostare e cchTextMax imposta la lunghezza massima della stringa di filtro che l'utente può digitare nel campo filtro. Quando uno snap-in legge un valore di filtro di testo, pszText punta a un buffer per ricevere il testo e cchTextMax fornisce la lunghezza del buffer.

cchTextMax

Per altre informazioni, vedere la descrizione per pszText.

lValue

Quando uno snap-in imposta un valore di filtro numerico, lValue contiene il valore del filtro. Il campo filtro converte il valore in una stringa e lo inserisce nel controllo filtro. Quando uno snap-in legge un valore di filtro numerico, il valore del filtro corrente viene convertito in binario e restituito in lValue.

Commenti

Un valore di filtro numerico può essere usato quando la colonna che filtra ha solo valori numerici anziché stringhe di testo arbitrarie. Il vantaggio dell'uso di un filtro numerico è che il filtro gestisce la conversione tra il file binario e il testo durante l'impostazione e la lettura del valore del filtro. Il controllo filtro consente anche a un utente di digitare caratteri numerici in un filtro numerico.

Quando si gestisce un filtro di testo, lValue viene ignorato. Analogamente, quando si gestisce un filtro numerico, pszText e cchTextMax vengono ignorati.

Per impostazione e lettura dei valori del filtro, lo snap-in possiede la struttura MMC_FILTERDATA e qualsiasi buffer di testo.

Requisiti