Fungsi SHAppBarMessage (shellapi.h)

Artikel
03/15/2023

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)