Metode IUserNotification::SetBalloonInfo (shobjidl_core.h)

Artikel
08/08/2024

Mengatur informasi yang akan ditampilkan dalam pemberitahuan balon.

Sintaks

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

Parameter

[in] pszTitle

Jenis: LPCWSTR

Penunjuk ke string Unicode yang menentukan judul pemberitahuan.

[in] pszText

Jenis: LPCWSTR

Penunjuk ke string Unicode yang menentukan teks yang akan ditampilkan dalam isi balon.

[in] dwInfoFlags

Jenis: DWORD

Satu atau beberapa nilai berikut yang menunjukkan ikon untuk ditampilkan di balon pemberitahuan.

NIIF_NONE (0x00000000)

0x00000000. Jangan tampilkan ikon.

NIIF_INFO (0x00000001)

0x00000001. Tampilkan ikon informasi.

NIIF_WARNING (0x00000002)

0x00000002. Tampilkan ikon peringatan.

NIIF_ERROR (0x00000003)

0x00000003. Tampilkan ikon kesalahan.

NIIF_USER (0x00000004)

0x00000004. Windows XP SP2 dan yang lebih baru. Gunakan ikon yang diidentifikasi dalam hIcon di balon pemberitahuan.

NIIF_NOSOUND (0x00000010)

0x00000010. Windows XP dan yang lebih baru. Jangan putar suara terkait. Nilai ini hanya berlaku untuk pemberitahuan balon dan bukan untuk pemberitahuan pengguna standar.

NIIF_LARGE_ICON (0x00000010)

0x00000010. Windows Vista dan yang lebih baru. Versi besar ikon harus digunakan sebagai ikon di balon pemberitahuan. Ini sesuai dengan ikon dengan dimensi SM_CXICON x SM_CYICON. Jika bendera ini tidak diatur, ikon dengan dimensi XM_CXSMICON x SM_CYSMICON digunakan.

Bendera ini dapat digunakan dengan semua ikon stok.
Aplikasi yang menggunakan ikon yang disesuaikan yang lebih lama (NIIF_USER dengan hIcon) harus menyediakan versi SM_CXICON x SM_CYICON baru dalam ikon baki yang ditentukan dalam anggota hIcon struktur NOTIFYICONDATA . Ikon ini diturunkan skalanya ketika ditampilkan di area pemberitahuan.
Ikon baru yang disesuaikan (NIIF_USER dengan hBalloonIcon) harus menyediakan versi SM_CXICON x SM_CYICON dalam ikon yang disediakan (hBalloonIcon).

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080. Windows 7 dan yang lebih baru. Jangan tampilkan balon pemberitahuan jika pengguna saat ini berada dalam "waktu tenang", yang merupakan jam pertama setelah pengguna baru masuk ke akunnya untuk pertama kalinya. Selama waktu ini, sebagian besar pemberitahuan tidak boleh dikirim atau ditampilkan. Ini memungkinkan pengguna terbiasa dengan sistem komputer baru tanpa gangguan tersebut. Waktu tenang juga terjadi untuk setiap pengguna setelah peningkatan sistem operasi atau penginstalan bersih. Pemberitahuan yang dikirim dengan bendera ini selama waktu tenang tidak diantrekan; itu hanya diberhentikan tanpa shown. Aplikasi dapat mengirim ulang pemberitahuan nanti jika masih valid pada saat itu.

Karena aplikasi tidak dapat memprediksi kapan mungkin mengalami waktu tenang, kami menyarankan agar bendera ini selalu diatur pada semua pemberitahuan yang sesuai oleh aplikasi apa pun yang berarti menghormati waktu tenang.

Jika pengguna saat ini tidak berada dalam waktu tenang, bendera ini tidak berpengaruh.

NIIF_ICON_MASK (0x0000000F)

0x0000000F. Windows XP (Shell32.dll versi 6.0) dan yang lebih baru. Dicadangkan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui