Fungsi SHAppBarMessage (shellapi.h)
Mengirim pesan appbar ke sistem.
Sintaks
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
Parameter
[in] dwMessage
Jenis: DWORD
Nilai pesan appbar untuk dikirim. Parameter ini bisa menjadi salah satu nilai berikut.
ABM_NEW (0x00000000)
Mendaftarkan appbar baru dan menentukan pengidentifikasi pesan yang harus digunakan sistem untuk mengirim pesan pemberitahuan ke appbar.
ABM_REMOVE (0x00000001)
Membatalkan pendaftaran appbar, menghapus bilah dari daftar internal sistem.
ABM_QUERYPOS (0x00000002)
Meminta ukuran dan posisi layar untuk appbar.
ABM_SETPOS (0x00000003)
Mengatur ukuran dan posisi layar appbar.
ABM_GETSTATE (0x00000004)
Mengambil status autohide dan always-on-top taskbar Windows.
ABM_GETTASKBARPOS (0x00000005)
Mengambil persegi panjang pembatas taskbar Windows. Perhatikan bahwa ini hanya berlaku untuk taskbar sistem. Objek lain, terutama toolbar yang disediakan dengan perangkat lunak pihak ketiga, juga dapat ada. Akibatnya, beberapa area layar yang tidak tercakup oleh taskbar Windows mungkin tidak terlihat oleh pengguna. Untuk mengambil area layar yang tidak dicakup oleh taskbar dan bilah aplikasi lainnya—area kerja yang tersedia untuk aplikasi Anda—, gunakan fungsi GetMonitorInfo .
ABM_ACTIVATE (0x00000006)
Memberi tahu sistem untuk mengaktifkan atau menonaktifkan appbar. Anggota lParam dari APPBARDATA yang ditunjukkan oleh pData diatur ke TRUE untuk mengaktifkan atau FALSE untuk menonaktifkan.
ABM_GETAUTOHIDEBAR (0x00000007)
Mengambil handel ke appbar autohide yang terkait dengan tepi layar tertentu.
ABM_SETAUTOHIDEBAR (0x00000008)
Mendaftarkan atau membatalkan pendaftaran appbar autohide untuk tepi layar.
ABM_WINDOWPOSCHANGED (0x00000009)
Memberi tahu sistem ketika posisi appbar telah berubah.
ABM_SETSTATE (0x0000000A)
Windows XP dan yang lebih baru: Mengatur status atribut autohide dan always-on-top appbar.
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP dan yang lebih baru: Mengambil handel ke appbar autohide yang terkait dengan tepi tertentu dari monitor tertentu.
ABM_SETAUTOHIDEBAREX (0x0000000C)
Windows XP dan yang lebih baru: Mendaftarkan atau membatalkan pendaftaran appbar autohide untuk tepi monitor tertentu.
[in, out] pData
Jenis: PAPPBARDATA
Penunjuk ke struktur APPBARDATA . Konten struktur pada entri dan saat keluar tergantung pada nilai yang ditetapkan dalam parameter dwMessage . Lihat halaman pesan individual untuk detailnya.
Mengembalikan nilai
Jenis: UINT_PTR
Fungsi ini mengembalikan nilai yang bergantung pada pesan. Untuk informasi selengkapnya, lihat dokumentasi Windows SDK untuk pesan appbar tertentu yang dikirim. Tautan ke dokumen tersebut diberikan di bagian Lihat Juga.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shellapi.h |
| Pustaka | Shell32.lib |
| DLL | Shell32.dll (versi 4.0 atau yang lebih baru) |
| Set API | ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240) |