IConsole2::Expand 메서드(mmc.h)

IConsole2::Expand 메서드를 사용하면 스냅인에서 scope 창에서 항목을 확장하거나 축소할 수 있습니다.

구문

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

매개 변수

[in] hItem

확장할 항목에 대한 핸들입니다.

[in] bExpand

항목을 확장할지 축소할지 여부를 지정하는 값입니다. TRUE 이면 항목이 확장됩니다. FALSE 이면 항목이 축소됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

IConsole2::Expand 메서드는 사용자가 더하기 또는 빼기 기호를 클릭하여 scope 창에서 항목을 확장하거나 축소하는 것과 같은 프로그래밍 방식입니다. 즉, 이 메서드를 사용하면 scope 창에서 항목이 눈에 띄게 확장되거나 축소됩니다. 이 메서드는 scope 창에서 선택 영역을 변경하지 않으며 결과 창에 영향을 주지 않습니다.

이 메서드가 호출되면 MMC는 bExpand에 설정된 값에 따라 hItem에 지정된 항목을 확장하거나 축소합니다. 그런 다음 MMC는 각 자식 항목의 스냅인에 확장 알림을 보냅니다. MMC는 이벤트가 MMCN_EXPAND 설정된 각 자식 스냅인의 IComponentData::Notify 메서드를 호출하고, lpDataObject를 hItem의 데이터 개체에 대한 포인터로 설정하고, arg를 bExpand에 따라 TRUE 또는 FALSE로 설정하고, 매개 변수를 hItem으로 설정하여 호출합니다. hItem은 IConsole2::Expand 호출에서 지정한 HSCOPEITEM 핸들입니다.

IConsole2::Expand 메서드는 특정 보기에만 적용됩니다. 즉, 콘솔 내의 특정 MDI(다중 문서 인터페이스) 창에 나타나는 스냅인 항목에 해당하는 스냅인 IComponent 개체의 instance만 적용됩니다. 콘솔 내의 각 MDI 창은 다른 보기를 나타내며 MDI 창 내에서 스냅인의 instance 해당 스냅인에 대한 IComponent 개체에 해당한다는 점에 유의하세요.

따라서 스냅인은 IComponent 개체와 연결된 IConsole2 인터페이스 포인터, 즉 IComponent::Initialize에서 반환된 IConsole 인터페이스 포인터에서 QueryInterface를 호출하여 검색된 IConsole2 인터페이스 포인터에서만 이 메서드를 호출해야 합니다.

항목을 눈에 띄게 확장하지 않고 네임스페이스에 있는 항목의 자식 항목을 열거하려면 스냅인에서 IConsoleNameSpace2::Expand 메서드를 사용해야 합니다.

요구 사항

참고 항목

IConsole2

IConsoleNameSpace2::Expand