Méthode IHeaderCtrl2 ::SetColumnFilter (mmc.h)

Article
03/04/2024

IHeaderCtrl2 ::SetColumnFilter définit la valeur de filtre et sa longueur maximale de caractères pour une colonne spécifiée dans une liste filtrée.

Syntaxe

HRESULT SetColumnFilter(
  [in] UINT           nColumn,
  [in] DWORD          dwType,
  [in] MMC_FILTERDATA *pFilterData
);

Paramètres

[in] nColumn

Index de base zéro qui identifie la colonne pour laquelle la valeur de filtre et sa longueur maximale de caractères doivent être définies.

[in] dwType

Type de filtre à appliquer à la colonne spécifiée, extrait de l’énumération MMC_FILTER_TYPE .

[in] pFilterData

Pointeur vers une structure MMC_FILTERDATA qui contient les données de filtre réelles.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

Pour la définition et la lecture des valeurs de filtre, le composant logiciel enfichable possède la structure MMC_FILTERDATA et toute mémoire tampon de texte.

Si le composant logiciel enfichable ne définit pas explicitement les données de filtre pour une colonne d’une liste filtrée en appelant IHeaderCtrl2 ::SetColumnFilter, le type de filtre est par défaut MMC_STRING_FILTER sans valeur par défaut pour le filtre (MMC_FILTER_NOVALUE). La longueur par défaut du filtre n’est pas documentée par le contrôle d’en-tête Win32, mais elle est suffisante pour les entrées utilisateur les plus probables. Si le composant logiciel enfichable nécessite une longueur spécifique, il doit appeler IHeaderCtrl2 ::SetColumnFilter.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	mmc.h
DLL	Mmcndmgr.dll

Voir aussi

IHeaderCtrl2

Partager via