NOTIFYICONDATA

NOTIFYICONDATA

태스크바의 스테이터스 에리어에의 메세지를 시스템이 처리하는데 필요한 정보가 격납됩니다.이 구조체는 Shell_NotifyIcon 함수로 사용됩니다.

typedef struct _NOTIFYICONDATA { 
    DWORD  cbSize; 
    HWND   hWnd; 
    UINT   uID; 
    UINT   uFlags; 
    UINT   uCallbackMessage; 
    HICON  hIcon; 
#if (_WIN32_IE < 0x0500)
    TCHAR  szTip[64];
#else
    TCHAR  szTip[128];
#endif
#if (_WIN32_IE >= 0x0500)
    DWORD  dwState;
    DWORD  dwStateMask;
    TCHAR  szInfo[256];
    union {
        UINT  uTimeout;
        UINT  uVersion;
    } DUMMYUNIONNAME;
    TCHAR  szInfoTitle[64];
    DWORD  dwInfoFlags;
#endif
#if (_WIN32_IE >= 0x600)
    GUID   guidItem;
#endif
} NOTIFYICONDATA, *PNOTIFYICONDATA;

※ (_WIN32_IE >= 0x0500) 하 Shell32.dll Version 5.00 이후( Windows Me/2000 이후),(_WIN32_IE >= 0x600) 하 Shell32.dll Version 6.00 이후( Windows XP 이후)로 유효

멤버

cbSize

이 구조체의 사이즈를 아르바이트 단위로 지정합니다. ANSI 판에서는 88 (을)를 지정합니다.

Version 5.0 이후： 확장된 멤버를 사용하려면 , ANSI 판에서는 488 (을)를 지정합니다.

Version 6.0 이후： 확장된 멤버를 사용하려면 , ANSI 판에서는 504 (을)를 지정합니다.

hWnd

태스크바의 스테이터스 에리어에 표시되는 아이콘에 관련지을 수 있는, 통지 메세지를 받아들이는 윈도우의 핸들을 지정합니다.

uID

태스크바의 아이콘을 식별하기 위한 어플리케이션 정의의 ID (을)를 지정합니다.

uFlags

이 구조체의 어느 멤버가 유효한가를 나타내는 플래그를 지정합니다.이하의 값의 편성을 지정합니다.

치	유효한 멤버
0x00000001 (NIF_MESSAGE)	uCallbackMessage
0x00000002 (NIF_ICON)	hIcon
0x00000004 (NIF_TIP)	szTip
0x00000008 (NIF_STATE)	Version 5.0 이후： dwState, dwStateMask
0x00000010 (NIF_INFO)	Version 5.0 이후： szInfo, uTimeout, szInfoTitle, dwInfoFlags
0x00000020 (NIF_GUID)	Version 6.0 이후： 예약되고 있습니다.

uCallbackMessage

어플리케이션 정의의 메세지 코드를 지정합니다.아이콘상에서 마우스 이벤트가 일어났을 경우에, hWnd 멤버로 지정한 윈도우에 이 메세지가 보내집니다.이 통지는, 아이콘상에서 마우스 이벤트가 발생하는지, 키보드에 의해서 아이콘이 선택 또는 액티브한가 되었을 때에 보내집니다.메세지의 wParam 파라미터에는, 마우스 이벤트가 발생한 태스크바 아이콘의 ID 입니다. lParam 파라미터에는, 발생한 이벤트에 관련하는 마우스 또는 키보드의 메세지 코드입니다.

hIcon

추가나 변경이나 삭제되는 아이콘의 핸들을 지정합니다.

szTip

표준 툴 팁에 표시하는 텍스트의 눌 종단 문자열을 격납합니다.문자열의 최대 사이즈는, 종단 눌 문자를 포함해 64 아르바이트(Unicode 판의 경우는 64 문자)입니다.

Version 5.0 이후： 종단 눌 문자를 포함해 128 아르바이트(Unicode 판의 경우는 128 문자)까지의 문자열을 지정할 수 있습니다.

dwState

Version 5.0 이후： 아이콘 상태가 격납됩니다. 0 또는 이하의 값의 편성입니다.

치	유효한 멤버
0x00000001 (NIS_HIDDEN)	아이콘은 비표시입니다.
0x00000002 (NIS_SHAREDICON)	아이콘은 공유됩니다.

dwStateMask

Version 5.0 이후： dwState 멤버로 어느 상태를 취득 또는 설정하는지를 지정합니다. dwState 멤버의 값에 대해서, 이 멤버로 지정된 상태만이 반영됩니다.

szInfo

Version 5.0 이후： 벌룬 툴 팁에 표시하는 텍스트의 눌 종단 문자열을 격납합니다.문자열의 최대 사이즈는 255 아르바이트(Unicode 판의 경우는 255 문자)입니다.벌룬 툴 팁을 삭제하려면 , uFlags 멤버에 NIF_INFO (을)를 지정하고,szInfo 멤버에 공문자열을 지정합니다.

uTimeout

Version 5.0 이후： 벌룬 툴 팁의 타임 아웃 시간을 밀리 세컨드 단위로 지정합니다.시스템은 타임 아웃치의 최소치 및 최대치를 가지고 있어 이 멤버로 지정된 값이 너무 작은 경우는 최소치에, 너무 큰 경우는 최대치로 설정됩니다.통상은, 최소치가 10 초, 최대치는 30 초로 설정되어 있습니다.

uVersion

Version 5.0 이후： 쉘 통지 아이콘의 인터페이스에 Windows 95 (와)과 Windows 2000 의 어느 쪽의 행동을 하는지를 지정합니다.이 멤버는 Shell_NotifyIcon 함수로 NIM_VERSION 메세지를 보내는 경우에게만 사용됩니다.

치	의미
0	Windows 95 (와)과 같이 행동합니다.
3 (NOTIFYICON_VERSION)	Windows 2000 (와)과 같이 행동합니다.

szTitleInfo

Version 5.0 이후： 벌룬 툴 팁의 타이틀을 나타내는 눌 종단 문자열을 격납합니다.문자열의 최대 사이즈는 64 아르바이트(Unicode 판의 경우는 64 문자)입니다.

dwInfoFlags

Version 5.0 이후： 벌룬 툴 팁에 아이콘을 표시하도록(듯이) 설정하기 위한 플래그입니다.아이콘은 타이틀의 좌측으로 표시됩니다. szTitleInfo 멤버가로부터 문자열인 경우에는 아이콘은 표시되지 않습니다.이하의 값의 어느쪽이든을 지정합니다.

치	표시되는 아이콘
0x00000000 (NIIF_NONE)	아이콘 없음
0x00000001 (NIIF_INFO)	「정보」아이콘
0x00000002 (NIIF_WARNING)	「경고」아이콘
0x00000003 (NIIF_ERROR)	「에러」아이콘
0x0000000F (NIIF_ICON_MASK)	Version 6.0 이후： 예약되고 있습니다.
0x00000010 (NIIF_NOSOUND)	Version 6.0 이후： 관련 사운드를 울리지 않게 합니다.벌룬 툴 팁에게만 적용됩니다.

guidItem

Version 6.0 이후： 예약되고 있습니다.

해설

uFlags 멤버에 NIF_INFO 플래그를 지정했을 경우, 표준 툴 팁은 벌룬 툴 팁으로 옮겨집니다.

태스크바에서는 동시에 복수의 벌룬 툴 팁은 표시되지 않습니다.이미 벌룬 툴 팁이 표시되고 있는 상태로, 벌룬 툴 팁을 표시 시키려고 했을 경우, 적어도 시스템 최소 타임 아웃 시간만 전의 벌룬 툴 팁이 표시될 때까지는 다음의 벌룬 툴 팁은 표시되지 않습니다.

대응 정보

Shell32.dll Version 4.0 이후

Windows 95 이후 / Windows NT 4.0 이후

변수와의 대응 (ANSI 판의 경우)

Shell32.dll Version 4.72 이전

HSP 변수	멤버
	멤버명	오프셋	사이즈
nid.0	cbSize ( = 88 )	0	4
nid.1	hWnd	4	4
nid.2	uID	8	4
nid.3	uFlags	12	4
nid.4	uCallbackMessage	16	4
nid.5	hIcon	20	4
nid.6	szTip	24	64
…
nid.21

Shell32.dll Version 5.0 / 6.0 이후

HSP 변수	멤버
	멤버명	오프셋	사이즈
nid.0	cbSize ( = 504 )	0	4
nid.1	hWnd	4	4
nid.2	uID	8	4
nid.3	uFlags	12	4
nid.4	uCallbackMessage	16	4
nid.5	hIcon	20	4
nid.6	szTip	24	128
…
nid.37
nid.38	dwState	152	4
nid.39	dwStateMask	156	4
nid.40	szInfo	160	256
…
nid.103
nid.104	uTimeout / uVersion	416	4
nid.105	szInfoTitle	420	64
…
nid.120
nid.121	dwInfoFlags	484	4
nid.122	guidItem	488	16
…
nid.125