IUserNotification::SetBalloonInfo 메서드(shobjidl_core.h)
풍선 알림에 표시할 정보를 설정합니다.
HRESULT SetBalloonInfo(
[in] LPCWSTR pszTitle,
[in] LPCWSTR pszText,
[in] DWORD dwInfoFlags
);
[in] pszTitle
형식: LPCWSTR
알림의 제목을 지정하는 유니코드 문자열에 대한 포인터입니다.
[in] pszText
형식: LPCWSTR
풍선 본문에 표시할 텍스트를 지정하는 유니코드 문자열에 대한 포인터입니다.
[in] dwInfoFlags
형식:DWORD
알림 풍선에 표시할 아이콘을 나타내는 다음 값 중 하나 이상입니다.
0x00000000. 아이콘을 표시하지 마세요.
0x00000001. 정보 아이콘을 표시합니다.
0x00000002. 경고 아이콘을 표시합니다.
0x00000003. 오류 아이콘을 표시합니다.
0x00000004. Windows XP SP2 이상. 알림 풍선의 hIcon 에서 식별된 아이콘을 사용합니다.
0x00000010. Windows XP 이상. 연결된 사운드를 재생하지 마세요. 이 값은 풍선 알림에만 적용되며 표준 사용자 알림에는 적용되지 않습니다.
0x00000010. Windows Vista 이상. 아이콘의 큰 버전은 알림 풍선의 아이콘으로 사용해야 합니다. x SM_CYICON SM_CXICON 차원이 있는 아이콘에 해당합니다. 이 플래그를 설정하지 않으면 x SM_CYSMICON XM_CXSMICON 차원이 있는 아이콘이 사용됩니다.
- 이 플래그는 모든 스톡 아이콘과 함께 사용할 수 있습니다.
- 이전 사용자 지정 아이콘(hIcon과 함께 NIIF_USER)을 사용하는 애플리케이션은 NOTIFYICONDATA 구조체의 hIcon 멤버에 지정된 트레이 아이콘에 새 SM_CXICON x SM_CYICON 버전을 제공해야 합니다. 이러한 아이콘은 알림 영역에 표시될 때 축소됩니다.
- 새로운 사용자 지정 아이콘( hBalloonIcon이 있는 NIIF_USER)은 제공된 아이콘(hBalloonIcon)에서 SM_CXICON x SM_CYICON 버전을 제공해야 합니다.
0x00000080. Windows 7 이상. 현재 사용자가 "조용한 시간"에 있는 경우 알림 풍선을 표시하지 마세요. 이는 새 사용자가 처음으로 자신의 계정에 로그인한 후 처음 1시간입니다. 이 시간 동안 대부분의 알림을 보내거나 표시해서는 안 됩니다. 이렇게 하면 사용자가 이러한 방해 요소 없이 새 컴퓨터 시스템에 익숙해질 수 있습니다. 운영 체제 업그레이드 또는 클린 설치 후 각 사용자에 대해 조용한 시간도 발생합니다. 조용한 시간 동안 이 플래그와 함께 전송된 알림은 큐에 대기되지 않습니다. 그것은 단순히 파종 해제됩니다. 애플리케이션은 해당 시간에 여전히 유효한 경우 나중에 알림을 다시 전송할 수 있습니다.
애플리케이션은 조용한 시간이 발생할 수 있는 시기를 예측할 수 없으므로 이 플래그는 항상 조용한 시간을 존중하는 모든 애플리케이션에 의해 적절한 모든 알림에 설정하는 것이 좋습니다.
현재 사용자가 조용한 시간에 있지 않으면 이 플래그는 적용되지 않습니다.
0x0000000F. Windows XP (Shell32.dll 버전 6.0) 이상. 예약되어 있습니다.
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shobjidl_core.h(Shobjidl.h 포함) |