MMC_FILTERDATA-Struktur (mmc.h)

Die MMC_FILTERDATA-Struktur wird in MMC 1.2 eingeführt.

Die MMC_FILTERDATA-Struktur wird von den Methoden IHeaderCtrl2::GetColumnFilter und IHeaderCtrl2::SetColumnFilter verwendet, um den Filterwert einer Spalte in einer gefilterten Listenansicht abzurufen und festzulegen.

Syntax

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

Member

pszText

Wenn ein Snap-In einen Textfilterwert festlegt, zeigt pszText auf die festzulegende Filterzeichenfolge, und cchTextMax legt die maximale Länge der Filterzeichenfolge fest, die der Benutzer in das Filterfeld eingeben kann. Wenn ein Snap-In einen Textfilterwert liest, zeigt pszText auf einen Puffer, um den Text zu empfangen, und cchTextMax gibt die Länge des Puffers an.

cchTextMax

Weitere Informationen finden Sie in der Beschreibung für pszText.

lValue

Wenn ein Snap-In einen numerischen Filterwert festlegt, enthält lValue den Filterwert. Das Filterfeld konvertiert den Wert in eine Zeichenfolge und platziert ihn im Filtersteuerelement. Wenn ein Snap-In einen numerischen Filterwert liest, wird der aktuelle Filterwert in binär konvertiert und in lValue zurückgegeben.

Hinweise

Ein numerischer Filterwert kann verwendet werden, wenn die spalte, die gefiltert wird, nur numerische Werte und nicht beliebige Textzeichenfolgen enthält. Der Vorteil der Verwendung eines numerischen Filters besteht darin, dass der Filter beim Festlegen und Lesen des Filterwerts die Konvertierung zwischen der Binärdatei und dem Text verarbeitet. Außerdem ermöglicht das Filtersteuerelement einem Benutzer nur die Eingabe numerischer Zeichen in einen numerischen Filter.

Bei der Verarbeitung eines Textfilters wird lValue ignoriert. Ebenso werden bei der Behandlung eines numerischen Filters pszText und cchTextMax ignoriert.

Sowohl für das Festlegen als auch für das Lesen von Filterwerten besitzt das Snap-In die MMC_FILTERDATA-Struktur und einen beliebigen Textpuffer.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	mmc.h