IUserNotification::SetBalloonInfo 메서드(shobjidl_core.h)

아티클
03/05/2024

풍선 알림에 표시할 정보를 설정합니다.

구문

HRESULT SetBalloonInfo(
  [in] LPCWSTR pszTitle,
  [in] LPCWSTR pszText,
  [in] DWORD   dwInfoFlags
);

매개 변수

[in] pszTitle

형식: LPCWSTR

알림의 제목을 지정하는 유니코드 문자열에 대한 포인터입니다.

[in] pszText

형식: LPCWSTR

풍선 본문에 표시할 텍스트를 지정하는 유니코드 문자열에 대한 포인터입니다.

[in] dwInfoFlags

형식:DWORD

알림 풍선에 표시할 아이콘을 나타내는 다음 값 중 하나 이상입니다.

NIIF_NONE(0x00000000)

0x00000000. 아이콘을 표시하지 마세요.

NIIF_INFO(0x00000001)

0x00000001. 정보 아이콘을 표시합니다.

NIIF_WARNING(0x00000002)

0x00000002. 경고 아이콘을 표시합니다.

NIIF_ERROR(0x00000003)

0x00000003. 오류 아이콘을 표시합니다.

NIIF_USER(0x00000004)

0x00000004. Windows XP SP2 이상. 알림 풍선의 hIcon 에서 식별된 아이콘을 사용합니다.

NIIF_NOSOUND(0x00000010)

0x00000010. Windows XP 이상. 연결된 사운드를 재생하지 마세요. 이 값은 풍선 알림에만 적용되며 표준 사용자 알림에는 적용되지 않습니다.

NIIF_LARGE_ICON(0x00000010)

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 버전을 제공해야 합니다.

NIIF_RESPECT_QUIET_TIME(0x00000080)

0x00000080. Windows 7 이상. 현재 사용자가 "조용한 시간"에 있는 경우 알림 풍선을 표시하지 마세요. 이는 새 사용자가 처음으로 자신의 계정에 로그인한 후 처음 1시간입니다. 이 시간 동안 대부분의 알림을 보내거나 표시해서는 안 됩니다. 이렇게 하면 사용자가 이러한 방해 요소 없이 새 컴퓨터 시스템에 익숙해질 수 있습니다. 운영 체제 업그레이드 또는 클린 설치 후 각 사용자에 대해 조용한 시간도 발생합니다. 조용한 시간 동안 이 플래그와 함께 전송된 알림은 큐에 대기되지 않습니다. 그것은 단순히 파종 해제됩니다. 애플리케이션은 해당 시간에 여전히 유효한 경우 나중에 알림을 다시 전송할 수 있습니다.

애플리케이션은 조용한 시간이 발생할 수 있는 시기를 예측할 수 없으므로 이 플래그는 항상 조용한 시간을 존중하는 모든 애플리케이션에 의해 적절한 모든 알림에 설정하는 것이 좋습니다.

현재 사용자가 조용한 시간에 있지 않으면 이 플래그는 적용되지 않습니다.

NIIF_ICON_MASK(0x0000000F)

0x0000000F. Windows XP (Shell32.dll 버전 6.0) 이상. 예약되어 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

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

다음을 통해 공유