Shell_NotifyIcon(A)

Shell_NotifyIcon(A)

태스크바의 스테이터스 에리어에 메세지를 송신합니다.

BOOL Shell_NotifyIconA(
    DWORD   dwMessage,     // 송신하는 메세지
    PNOTIFYICONDATA  pnid  // NOTIFYICONDATA구조체
);

SHELL32.DLL

인수

dwMessage

시스템에 송신하는 메세지의 종류를 지정합니다.이하의 값의 어느쪽이든을 지정합니다.

치	의미
0x00000000 (NIM_ADD)	스테이터스 에리어에 아이콘을 추가합니다.
0x00000001 (NIM_MODIFY)	아이콘을 변경합니다.
0x00000002 (NIM_DELETE)	아이콘을 삭제합니다.
0x00000003 (NIM_SETFOCUS)	Version 5.00 이후： 태스크바 통지 에리어에 포커스를 돌려줍니다.태스크바 아이콘은, 유저 인터페이스 조작이 완료했을 때에 이 메세지를 보내야 합니다.예를 들면, 태스크바 아이콘에 쇼트 컷 메뉴를 표시하고, 유저가 ESC 키를 눌러 캔슬했을 때에, 이 메세지를 송신해 포커스를 태스크바 통지 에리어에 돌려주어야 합니다.
0x00000004 (NIM_SETVERSION)	Version 5.00 이후： pnid 파라미터로 지정된다 NOTIFYICONDATA 구조체의 uVersion 멤버로 지정되는 버젼에 따라서 행동하도록(듯이) 태스크바로 지정합니다.이 멤버의 디폴트치는 0 (이어)여, 원형의 Windows 95 의 통지 아이콘에 있어서의 행동이 됩니다.

pnid

필요한 정보를 격납했다 NOTIFYICONDATA 구조체의 주소를 지정합니다.구조체의 내용은 dwMessage 파라미터에 의존합니다.

반환값

함수가 성공하면 1 (TRUE) 하지만 돌아갑니다.그 이외의 경우에는 0 (FALSE) 하지만 돌아갑니다.

dwMessage 파라미터에 NIM_SETVERSION (을)를 지정했을 경우에는, 버젼이 잘 변경되면 1 (TRUE) 하지만 돌아갑니다.지정된 버젼이 서포트되어 있지 않은 경우에는 0 (FALSE) 하지만 돌아갑니다.

해설

Windows 2000/Me 이후에 있는 버젼 5.0 이후의 쉘에서는, Shell_NotifyIcon 함수에 의한 마우스 및 키보드 이벤트의 취급이 Windows 95/98/NT 4.0 에 있는 종래의 쉘과는 다릅니다.

• 유저가 통지 아이콘의 쇼트 컷 메뉴를 키보드로 선택했을 경우에, 버젼 5.0 의 쉘에서는, 관련지을 수 있고 있는 어플리케이션에 WM_CONTEXTMENU 메세지가 보내집니다.종래의 쉘에서는, WM_RBUTTONDOWN 및 WM_RBUTTONUP 메세지가 보내집니다.

• 유저가 통지 아이콘을 마우스로 선택해 스페이스 바 또는 Enter 키로 액티브하게 했을 경우에, 버젼 5.0 의 쉘에서는, 관련지을 수 있고 있는 어플리케이션에 NIN_KEYSELECT 통지가 보내집니다.종래의 쉘에서는, WM_RBUTTONDOWN 및 WM_RBUTTONUP 메세지가 보내집니다.

• 유저가 통지 아이콘을 키보드로 선택해 Enter 키로 액티브하게 했을 경우에, 버젼 5.0 의 쉘에서는, 관련지을 수 있고 있는 어플리케이션에 NIN_SELECT 통지가 보내집니다.종래의 쉘에서는, WM_RBUTTONDOWN 및 WM_RBUTTONUP 메세지가 보내집니다.

• 벌룬 툴 팁을 관련지을 수 있고 있는 아이콘상에서 유저가 마우스 포인터를 통과시켰을 경우에, 버젼 5.0 의 쉘에서는, 관련지을 수 있고 있는 어플리케이션에 이하의 통지가 보내집니다.

  • NIN_BALLOONSHOW (0x402) ：벌룬이 표시되었을 때
  • NIN_BALLOONHIDE (0x403) ：벌룬이 사라졌을 때(아이콘이 사라졌을 때 등)
  • NIN_BALLOONTIMEOUT (0x404) ：타임 아웃에 의해 벌룬이 사라졌을 때
  • NIN_BALLOONUSERCLICK (0x405) ：유저의 마우스 클릭에 의해서 벌룬이 사라졌을 때

dwMessage 파라미터에 NIM_SETVERSION (을)를 지정해 이 함수를 호출하는 것으로, 어느 쪽의 행동을 하는지를 선택할 수 있습니다.

대응 정보

Shell32.dll Version 4.00 이후

Windows 95 이후 / Windows NT 4.0 이후