IMenuPopup::P opup 메서드(shobjidl_core.h)

아티클
03/05/2024

지정된 화면 위치에서 바로 가기 메뉴를 호출합니다.

구문

HRESULT Popup(
  [in] POINTL        *ppt,
  [in] RECTL         *prcExclude,
  [in] MP_POPUPFLAGS dwFlags
);

매개 변수

[in] ppt

형식: POINTL*

화면 좌표에서 팝업 메뉴의 위치를 지정하는 POINTL 구조체에 대한 포인터입니다. 팝업 메뉴는 dwFlags에 설정된 위치 플래그에 의해 결정된 대로 이 지점과 관련하여 표시됩니다.

[in] prcExclude

형식: RECTL*

메뉴를 배치할 때 제외할 사각형을 지정하는 RECTL 구조체에 대한 포인터입니다. Windows Vista에서 이 영역과 관련된 메뉴의 맞춤은 dwFlags에 설정된 맞춤 플래그에 따라 결정됩니다. 이 매개 변수는 전체 화면을 포함하도록 NULL 일 수 있습니다.

[in] dwFlags

형식: MP_POPUPFLAGS

팝업 메뉴의 표시를 제어하는 다음 상수 중 하나 이상.

MPPF_SETFOCUS(0x00000001)

메뉴가 나타나면 포커스가 있어야 합니다.

MPPF_INITIALSELECT(0x00000002)

메뉴의 첫 번째 항목을 선택해야 합니다.

MPPF_NOANIMATE(0x00000004)

이 쇼에 애니메이션 효과를 주지 마세요.

MPPF_KEYBOARD(0x00000010)

메뉴는 키보드에 의해 활성화됩니다.

MPPF_REPOSITION(0x00000020)

표시된 막대의 위치를 변경합니다.

MPPF_FORCEZORDER(0x00000040)

메뉴 모음은 하위 메뉴 위치를 무시해야 합니다.

MPPF_FINALSELECT(0x00000080)

메뉴의 마지막 항목을 선택해야 합니다.

MPPF_TOP(0x20000000)

ppt에 지정된 지점 위에 팝업 메뉴를 표시합니다.

MPPF_LEFT(0x40000000)

ppt에 지정된 점의 왼쪽에 팝업 메뉴를 표시합니다.

MPPF_RIGHT(0x60000000)

ppt에 지정된 지점의 오른쪽에 팝업 메뉴를 표시합니다.

MPPF_BOTTOM(0x80000000)

ppt에 지정된 지점 아래에 팝업 메뉴를 표시합니다.

MPPF_POS_MASK(0xE0000000)

위치 값 MPPF_TOP, MPPF_LEFT 및 MPPF_RIGHT 마스크합니다.

MPPF_ALIGN_LEFT(0x02000000)

기본 맞춤입니다.

MPPF_ALIGN_RIGHT(0x04000000)

팝업 메뉴는 prcExclude로 지정된 제외된 사각형의 오른쪽에 맞춰야 합니다.

반환 값

형식: HRESULT

개체가 팝업 메뉴를 모덜리스 메뉴로 구현하는 경우 S_OK 반환합니다. 그렇지 않으면 메뉴에 대한 구현의 끝을 나타내는 S_FALSE 반환합니다.

요구 사항

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

다음을 통해 공유