Método IConsole2::Expand (mmc.h)

O método IConsole2::Expand permite que o snap-in expanda ou recolha um item no painel de escopo.

Sintaxe

HRESULT Expand(
  [in] HSCOPEITEM hItem,
  [in] BOOL       bExpand
);

Parâmetros

[in] hItem

Um identificador para o item a ser expandido.

[in] bExpand

Um valor que especifica se o item deve ser expandido ou recolhido. TRUE expande o item. FALSE recolhe o item.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

O método IConsole2::Expand é o equivalente programático do usuário clicando no sinal de adição ou subtração para expandir ou recolher um item no painel de escopo. Ou seja, esse método causa uma expansão visível ou um recolhimento de um item no painel de escopo. Lembre-se de que esse método não altera a seleção no painel de escopo e não afeta o painel de resultados.

Quando esse método é chamado, o MMC expande ou recolhe o item especificado por hItem com base no valor definido para bExpand. O MMC envia uma notificação de expansão para o snap-in de cada item filho. O MMC faz isso chamando o método IComponentData::Notify de cada snap-in filho com evento definido como MMCN_EXPAND, lpDataObject definido como um ponteiro para o objeto de dados para hItem, arg definido como TRUE ou FALSE com base em bExpand e param definido como hItem. Lembre-se de que hItem é o identificador HSCOPEITEM especificado em sua chamada para IConsole2::Expand.

O método IConsole2::Expand aplica-se somente a uma exibição específica. Isso significa que ele se aplica somente à instância do objeto IComponent do snap-in que corresponde ao item snap-in que aparece em uma janela MDI (interface MDI) específica dentro do console. Lembre-se de que cada janela MDI dentro do console representa uma exibição diferente e que uma instância de um snap-in dentro de uma janela MDI corresponde a um objeto IComponent para esse snap-in.

Portanto, o snap-in só deve chamar esse método no ponteiro da interface IConsole2 associado a um objeto IComponent , ou seja, um ponteiro de interface IConsole2 recuperado chamando QueryInterface no ponteiro da interface IConsole retornado por IComponent::Initialize.

Para enumerar os itens filho de um item no namespace sem expandir visivelmente o item, o snap-in deve usar o método IConsoleNameSpace2::Expand .

Requisitos

Confira também

IConsole2

IConsoleNameSpace2::Expand