SHAppBarMessage 函式 (shellapi.h)
將 appbar 訊息傳送至系統。
語法
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
參數
[in] dwMessage
類型： DWORD
要傳送的Appbar訊息值。 此參數可以是下列其中一個值。
ABM_NEW (0x00000000)
註冊新的 appbar，並指定系統應該用來將通知訊息傳送至 appbar 的訊息識別碼。
ABM_REMOVE (0x00000001)
取消註冊 appbar，從系統的內部清單中移除列。
ABM_QUERYPOS (0x00000002)
要求 appbar 的大小和螢幕位置。
ABM_SETPOS (0x00000003)
設定 appbar 的大小和螢幕位置。
ABM_GETSTATE (0x00000004)
擷取 Windows 任務列的自動隱藏和永遠開啟狀態。
ABM_GETTASKBARPOS (0x00000005)
擷取 Windows 任務列的周框。 請注意，這隻適用於系統任務列。 其他物件，特別是第三方軟體所提供的工具列，也可以存在。 因此，使用者可能無法看到 Windows 任務欄所涵蓋的部分螢幕區域。 若要擷取任務列和其他應用程式橫條未涵蓋的屏幕區域，也就是應用程式可用的工作區，請使用 GetMonitorInfo 函式。
ABM_ACTIVATE (0x00000006)
通知系統啟用或停用appbar。 pData 所指向 APPBARDATA 的 lParam 成員會設定為 TRUE 以啟用或 FALSE 停用。
ABM_GETAUTOHIDEBAR (0x00000007)
擷取與螢幕特定邊緣相關聯的自動隱藏應用列句柄。
ABM_SETAUTOHIDEBAR (0x00000008)
註冊或取消註冊螢幕邊緣的自動隱藏應用列。
ABM_WINDOWPOSCHANGED (0x00000009)
當 appbar 的位置變更時，通知系統。
ABM_SETSTATE (0x0000000A)
Windows XP 和更新版本： 設定 appbar 自動隱藏和永遠在頂端屬性的狀態。
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP 和更新版本： 擷取與特定監視器特定邊緣相關聯的自動隱藏應用列句柄。
ABM_SETAUTOHIDEBAREX (0x0000000C)
Windows XP 和更新版本： 註冊或取消註冊特定監視器邊緣的自動隱藏應用列。
[in, out] pData
類型： PAPPBARDATA
APPBARDATA 結構的指標。 項目和結束結構的內容取決於 dwMessage 參數中設定的值。 如需詳細資訊，請參閱個別訊息頁面。
傳回值
類型： UINT_PTR
此函式會傳回訊息相依值。 如需詳細資訊，請參閱傳送的特定 appbar 訊息 Windows SDK 檔。 如需這些文件的連結，請參閱另請參閱一節。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shellapi.h |
| 程式庫 | Shell32.lib |
| Dll | Shell32.dll (4.0 版或更新版本) |
| API 集合 | ext-ms-win-shell32-l1-2-1 (於 Windows 10 10.0.10240 版) |