MMC_LISTPAD_INFO structure (mmc.h)
La structure MMC_LISTPAD_INFO est introduite dans MMC 1.1.
La structure MMC_LISTPAD_INFO est renseignée par la méthode IExtendTaskPad::GetListPadInfo pour spécifier les informations suivantes pour un bloc-tâches d’affichage de liste :
- Texte de titre pour le contrôle de liste
- Texte d’un bouton facultatif
- ID de commande transmis à IExtendTaskPad::TaskNotify lorsque l’utilisateur clique sur ce bouton.
Syntaxe
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
Membres
szTitle
Pointeur vers une chaîne terminée par null qui contient le texte placé directement au-dessus du contrôle de liste. Ce texte peut être l’étiquette des objets dans le contrôle de liste (par exemple, « Imprimantes » si la liste contient des imprimantes) ou des instructions (telles que « Sélectionner une imprimante et cliquer sur une action à effectuer »).
Si szTitle a la valeur NULL ou vide, aucun titre n’est affiché pour le contrôle de liste.
N’oubliez pas que le membre szTitle n’est pas le même que le paramètre pszTitle pour IExtendTaskPad::GetTitle. La méthode IExtendTaskPad::GetTitle retourne le titre de l’ensemble du bloc-tâches qui apparaît en haut du bloc-tâches et s’affiche sur chaque bloc-tâches MMC standard. Le membre szTitle de MMC_LISTPAD_INFO est l’étiquette du contrôle de liste et apparaît uniquement dans les pavés de tâches de l’affichage de liste MMC.
szButtonText
Pointeur vers une chaîne terminée par null qui contient le texte placé sur un bouton situé directement au-dessus du contrôle de liste et à droite du texte szTitle .
Lorsque l’utilisateur clique sur ce bouton dans le bloc-tâches, MMC appelle la méthode IExtendTaskPad::TaskNotify du composant logiciel enfichable et transmet la valeur spécifiée dans nCommandID en tant que structure VARIANT dans le paramètre arg. Le variant passé à TaskNotify a un membre vt défini sur VT_I4 et un membre lVal qui contient l’ID de commande.
Pour que le bouton s’affiche sans texte, définissez szButtonText sur une chaîne vide.
Pour masquer l’affichage de ce bouton dans le bloc-tâches, définissez szButtonText surNULL.
nCommandID
Valeur qui sert d’identificateur pour le bouton spécifié par szButtonText. Il est recommandé de rendre cette valeur unique pour chaque bloc-tâches afin d’identifier le bloc-tâches qui a envoyé la notification de clic sur le bouton.
Lorsque l’utilisateur clique sur ce bouton, MMC appelle la méthode IExtendTaskPad::TaskNotify du composant logiciel enfichable et transmet cette valeur en tant que VARIANT dans le paramètre arg.
Cette valeur est ignorée si szButtonText a la valeur NULL.
Notes
Allouez les chaînes szTitle et szButtonText avec la fonction d’API COM CoTaskMemAlloc (ou l’équivalent) et MMC la libère.
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | mmc.h |