struktur MMC_FILTERDATA (mmc.h)

Struktur MMC_FILTERDATA diperkenalkan dalam MMC 1.2.

Struktur MMC_FILTERDATA digunakan oleh metode IHeaderCtrl2::GetColumnFilter dan IHeaderCtrl2::SetColumnFilter untuk mengambil dan mengatur nilai filter kolom dalam tampilan daftar yang difilter.

Sintaks

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

Anggota

pszText

Saat snap-in mengatur nilai filter teks, pszText menunjuk ke string filter untuk diatur dan cchTextMax mengatur panjang maksimum string filter yang dapat diketik pengguna ke dalam bidang filter. Saat snap-in membaca nilai filter teks, pszText menunjuk ke buffer untuk menerima teks dan cchTextMax memberikan panjang buffer.

cchTextMax

Untuk informasi selengkapnya, lihat deskripsi untuk pszText.

lValue

Saat snap-in mengatur nilai filter numerik, lValue berisi nilai filter. Bidang filter mengonversi nilai menjadi string dan menempatkannya di kontrol filter. Saat snap-in membaca nilai filter numerik, nilai filter saat ini dikonversi ke biner dan dikembalikan dalam lValue.

Keterangan

Nilai filter numerik dapat digunakan saat kolom yang difilter hanya memiliki nilai numerik daripada string teks arbitrer. Keuntungan menggunakan filter numerik adalah filter menangani konversi antara biner dan teks saat mengatur dan membaca nilai filter. Juga kontrol filter hanya memungkinkan pengguna untuk mengetik karakter numerik ke dalam filter numerik.

Saat menangani filter teks, lValue diabaikan. Demikian pula, saat menangani filter numerik, pszText dan cchTextMax diabaikan.

Untuk pengaturan dan nilai filter baca, snap-in memiliki struktur MMC_FILTERDATA dan buffer teks apa pun.

Persyaratan