TrackPopupMenuEx

원형

BOOL TrackPopupMenuEx(HMENU hmenu, UINT fuFlags, int x, int y, HWND hwnd, LPTPMPARAMS lptpm);

MFC 원형

해당하는 함수 없음

인수

▶hmenu : 출력할 팝업 메뉴의 핸들. 보통 GetSubMenu 함수로 구한다.

▶fuFlags : 팝업 메뉴를 출력할 옵션. 위치와 메뉴 항목 선택에 관한 여러 가지 옵션이 있다.

▶(x,y) : 팝업 메뉴를 출력할 화면 좌표

▶hWnd : 팝업 메뉴의 부모 윈도우 핸들이며 팝업 메뉴가 선택되었을 때 이 윈도우로 WM_COMMAND 메시지가 전달된다.

▶lptpm : 팝업 메뉴가 출력되지 말아야 할 영역을 지정한다. 필요없을 경우 NULL로 줄 수 있다.

리턴

성공하면 0이 아닌값을 리턴하며 실패시 0을 리턴한다. uFlags에 TPM_RETURNCMD 플래그를 주었을 경우 리턴값은 선택한 메뉴 항목의 ID가 되며 항목 선택을 취소하면 0이 리턴된다.

설명

TrackPopupMenu와 마찬가지로 팝업 메뉴를 화면으로 출력한다. 이 함수의 동작과 플래그에 대한 기본적인 사항은 TrackPopupMenu를 먼저 참고하기 바라며 추가적인 기능만을 설명한다. 이 함수의 마지막 인수 lptpm은 다음과 같이 정의된 구조체이며 팝업 메뉴에 의해 가려지지 말아야 할 영역을 지정한다.

typedef struct tagTPMPARAMS {
UINT cbSize;
RECT rcExclude;
} TPMPARAMS, *LPTPMPARAMS;

cbSize는 이 구조체의 크기값을 가지며 rcExclude는 팝업 메뉴 출력에 제외되어야 할 사각 영역을 지정하는데 이 좌표는 화면 좌표이다. 만약 팝업 메뉴가 열려 있는 동안에 아래쪽 화면을 계속 참조해야 한다면 이 구조체로 팝업 메뉴 출력 금지 영역을 지정할 수 있으며 이 경우 (x,y)가 금지 영역에 있더라도 이 영역 바깥으로 팝업 메뉴를 이동시켜 준다.

예제 1

다음 예제는 화면상의 (100,100)-(400,150) 영역에 팝업 메뉴가 출력되지 않도록 한다.

LRESULT CALLBACK WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
	HDC hdc;
	PAINTSTRUCT ps;
	HMENU hMenu, hPopup;
	TPMPARAMS tp;
	RECT ert={100,100,400,150};
	char Mes[]="이 영역에는 메뉴 출력이 금지됨";

	switch(iMessage) {
	case WM_CONTEXTMENU:
		hMenu=LoadMenu(g_hInst, MAKEINTRESOURCE(IDR_MENU1));
		hPopup=GetSubMenu(hMenu, 0);

		tp.cbSize=sizeof(TPMPARAMS);
		tp.rcExclude=ert;
		ClientToScreen(hWnd,(LPPOINT)&tp.rcExclude);
		ClientToScreen(hWnd,(LPPOINT)&tp.rcExclude+1);
		TrackPopupMenuEx(hPopup, TPM_LEFTALIGN | TPM_RIGHTBUTTON | TPM_VERTICAL, 
			LOWORD(lParam), HIWORD(lParam), 
			hWnd, &tp);
		DestroyMenu(hMenu);
		return 0;
	case WM_COMMAND:
		switch(LOWORD(wParam)) {
		case IDM_POPUP1:
			MessageBox(hWnd,"첫 번째 팝업 메뉴를 선택했습니다","알림",MB_OK);
			break;
		case IDM_POPUP2:
			MessageBox(hWnd,"두 번째 팝업 메뉴를 선택했습니다","알림",MB_OK);
			break;
		case IDM_POPUP3:
			MessageBox(hWnd,"세 번째 팝업 메뉴를 선택했습니다","알림",MB_OK);
			break;
		}
		return 0;
	case WM_PAINT:
		hdc=BeginPaint(hWnd, &ps);
		Rectangle(hdc,ert.left,ert.top,ert.right,ert.bottom);
		TextOut(hdc,ert.left+10,ert.top+10,Mes,lstrlen(Mes));
		EndPaint(hWnd, &ps);
		return 0;
	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	}
	return(DefWindowProc(hWnd,iMessage,wParam,lParam));
}

작업 영역 좌표를 화면 좌표로 변경한 후 rcExclude에 설정하였으므로 이 영역은 팝업 메뉴에 의해 가려지지 않는다. 다음은 화면의 각 부분에서 팝업 메뉴를 열었을 때의 모양이다.

팝업 메뉴가 출력 금지 영역에 열려야 할 경우 수직 위치를 조정함으로써 이 영역 바깥에 메뉴를 열어 줌으로써 팝업 메뉴가 열린 동안에도 금지 영역을 볼 수 있다. 이 함수는 TrackPopuMenu에 비해 두 개의 플래그를 추가로 지정할 수 있는데 이 플래그들은 팝업 메뉴가 출력 금지 영역에 겹칠 경우 어떤식으로 팝업 메뉴를 이동시킬 것인가를 지정한다. TPM_HORIZONTAL은 팝업 메뉴의 수평 위치를 변경하며 TPM_VERTICAL은 수직 위치를 변경한다. 예제는 수직 위치를 변경하도록 작성되어 있는데 수평 위치를 변경하도록 수정하면 다음과 같이 팝업 메뉴가 열린다.

참고함수

TrackPopupMenu : 출력 금지 영역을 지정할 수 없는 것 외에는 이 함수와 동일하다.

플랫폼

95이상

참조

팝업 메뉴에 대한 일반적인 사용예는 19-2에 있다.


written by http://www.winapi.co.kr