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