Méthode IConsole2::Expand (mmc.h)
La méthode IConsole2::Expand permet au composant logiciel enfichable de développer ou de réduire un élément dans le volet d’étendue.
Syntaxe
HRESULT Expand(
[in] HSCOPEITEM hItem,
[in] BOOL bExpand
);
Paramètres
[in] hItem
Handle de l’élément à développer.
[in] bExpand
Valeur qui spécifie s’il faut développer ou réduire l’élément. TRUE développe l’élément. FALSE réduit l’élément.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Notes
La méthode IConsole2::Expand est l’équivalent programmatique de l’utilisateur qui clique sur le signe plus ou moins pour développer ou réduire un élément dans le volet d’étendue. Autrement dit, cette méthode provoque une expansion ou un effondrement visible d’un élément dans le volet d’étendue. N’oubliez pas que cette méthode ne modifie pas la sélection dans le volet d’étendue et n’affecte pas le volet de résultats.
Lorsque cette méthode est appelée, MMC développe ou réduit l’élément spécifié par hItem en fonction de la valeur définie pour bExpand. MMC envoie ensuite une notification de développement au composant logiciel enfichable de chaque élément enfant. Pour ce faire, MMC appelle la méthode IComponentData::Notify de chaque composant logiciel enfichable enfant avec le jeu d’événements MMCN_EXPAND, lpDataObject défini en tant que pointeur vers l’objet de données pour hItem, arg défini sur TRUE ou FALSE basé sur bExpand et param défini sur hItem. N’oubliez pas que hItem est le handle HSCOPEITEM que vous avez spécifié dans votre appel à IConsole2::Expand.
La méthode IConsole2::Expand s’applique uniquement à une vue particulière. Cela signifie qu’elle s’applique uniquement à la instance de l’objet IComponent du composant logiciel enfichable qui correspond à l’élément de composant logiciel enfichable qui apparaît dans une fenêtre MDI (Multi-Document Interface) spécifique dans la console. N’oubliez pas que chaque fenêtre MDI de la console représente une vue différente et qu’un instance d’un composant logiciel enfichable dans une fenêtre MDI correspond à un objet IComponent pour ce composant logiciel enfichable.
Par conséquent, le composant logiciel enfichable doit appeler cette méthode uniquement sur le pointeur d’interface IConsole2 associé à un objet IComponent , c’est-à-dire un pointeur d’interface IConsole2 récupéré en appelant QueryInterface sur le pointeur d’interface IConsole retourné par IComponent::Initialize.
Pour énumérer les éléments enfants d’un élément dans l’espace de noms sans développer visiblement l’élément, le composant logiciel enfichable doit utiliser la méthode IConsoleNameSpace2::Expand .
Spécifications
| 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 |