Partager via

structure MMC_FILTERDATA (mmc.h)

  • Article

La structure MMC_FILTERDATA est introduite dans MMC 1.2.

La structure MMC_FILTERDATA est utilisée par les méthodes IHeaderCtrl2 ::GetColumnFilter et IHeaderCtrl2 ::SetColumnFilter pour récupérer et définir la valeur de filtre d’une colonne dans un affichage de liste filtré.

Syntaxe

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

Membres

pszText

Lorsqu’un composant logiciel enfichable définit une valeur de filtre de texte, pszText pointe vers la chaîne de filtre à définir et cchTextMax définit la longueur maximale de la chaîne de filtre que l’utilisateur peut taper dans le champ de filtre. Lorsqu’un composant logiciel enfichable lit une valeur de filtre de texte, pszText pointe vers une mémoire tampon pour recevoir le texte et cchTextMax donne la longueur de la mémoire tampon.

cchTextMax

Pour plus d’informations, consultez la description de pszText.

lValue

Lorsqu’un composant logiciel enfichable définit une valeur de filtre numérique, lValue contient la valeur de filtre. Le champ de filtre convertit la valeur en chaîne et la place dans le contrôle de filtre. Lorsqu’un composant logiciel enfichable lit une valeur de filtre numérique, la valeur de filtre actuelle est convertie en binaire et retournée dans lValue.

Remarques

Une valeur de filtre numérique peut être utilisée lorsque la colonne qu’elle filtre a uniquement des valeurs numériques plutôt que des chaînes de texte arbitraires. L’avantage de l’utilisation d’un filtre numérique est que le filtre gère la conversion entre le binaire et le texte lors de la définition et de la lecture de la valeur du filtre. En outre, le contrôle de filtre permet uniquement à un utilisateur de taper des caractères numériques dans un filtre numérique.

Lors de la gestion d’un filtre de texte, lValue est ignoré. De même, lors de la gestion d’un filtre numérique, pszText et cchTextMax sont ignorés.

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

Configuration requise

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