IShellBrowser::InsertMenusSB 메서드(shobjidl_core.h)

아티클
08/26/2023

확장 네임스페이스를 보거나 사용할 때 표시되는 복합 메뉴에 해당 메뉴 그룹을 삽입할 수 있습니다.

구문

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

매개 변수

hmenuShared

형식: HMENU

빈 메뉴에 대한 핸들입니다.

lpMenuWidths

형식: LPOLEMENUGROUPWIDTHS

6개의 LONG 값으로 구성된 OLEMENUGROUPWIDTHS 배열의 주소입니다. 컨테이너는 파일, 보기 및 창 메뉴 그룹에 제공된 메뉴 요소의 수를 반영하기 위해 요소 0, 2 및 4를 채웁니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 COM 정의 오류 값을 반환합니다.

설명

이 메서드는 IOleInPlaceFrame::InsertMenus 메서드와 비슷합니다. Windows Explorer 파일 메뉴 그룹의 파일 및 편집 드롭다운 메뉴, 컨테이너 메뉴 그룹의 보기 및 도구 메뉴 및 창 메뉴 그룹의 도움말 메뉴를 배치합니다. 각 드롭다운 메뉴에는 고유한 식별자 FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP가 있습니다. 보기는 OLE의 현재 위치 활성화 메커니즘과 다른 식별자에 의해 해당 하위 메뉴에 메뉴 항목을 삽입할 수 있습니다. 보기가 Windows Explorer 하위 메뉴 또는 자체 하위 메뉴에 삽입하는 메뉴의 명령 식별자는 FCIDM_SHVIEWFIRST FCIDM_SHVIEWLAST 사이여야 합니다.

호출 애플리케이션에 대한 참고 사항

이 메서드는 처음 활성화될 때 네임스페이스 확장에서 호출되므로 프레임 수준 사용자 인터페이스에 메뉴를 삽입할 수 있습니다.

개체 애플리케이션은 hmenuShared 매개 변수에 지정된 메뉴에 메뉴를 추가하고 lpMenuWidths 매개 변수가 가리키는 OLEMENUGROUPWIDTHS 배열에서 그룹 수를 설정하도록 컨테이너에 요청합니다. 그런 다음 개체 애플리케이션은 고유한 메뉴와 개수를 추가합니다. 개체는 복합 메뉴를 빌드하는 데 필요한 만큼 IOleInPlaceFrame::InsertMenus 메서드를 호출할 수 있습니다. 컨테이너는 드롭다운 메뉴의 모든 항목에 대해 복합 메뉴와 연결된 초기 메뉴 핸들을 사용해야 합니다.

구현자에 대한 참고 사항

IShellBrowser 구현의 경우 메뉴 식별자는 FCIDM_BROWSERLAST FCIDM_BROWSERFIRST 범위에 있어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)

다음을 통해 공유