An application desktop toolbar (also called an appbar) is a window that is similar to the Microsoft Windows taskbar. It is anchored to an edge of the screen, and it typically contains buttons that give the user quick access to other applications and windows. The system prevents other applications from using the desktop area occupied by an appbar. Any number of appbars can exist on the desktop at any given time.
| Appbar | An application desktop toolbar (also called an appbar) is a window that is similar to the Microsoft Windows taskbar. |
| New | Creates new Appbar. |
| Remove | Unregisters an appbar by removing it from the system’s internal list. |
| SetTaskBar | Set the state of the Taskbar. |
| About |
Appbar_New( ByRef Hwnd, o1 = "", o2 = "", o3 = "", o4 = "", o5 = "", o6 = "", o7 = "", o8 = "", o9 = "" )
Creates new Appbar.
| Hwnd | Reference to the handle of the existing window. If variable is empty, function will create Gui and you will get its handle returned in this parameter. |
| o1..o9 | Named arguments. All named arguments are optional. |
| Edge | Screen edge to glue Appbar to. Possible values are “Top” (default), “Right”, “Left”, “Bottom”. |
| AutoHide | Makes Appbar autohide (off by default). Value represents animation type. Can be “Slide”, “Blend” or “Center”. Window will be shown only if mouse is in its hot area. When Appbar is activated, it will not auto hide until its deactivated again. |
| Pos | Position. String similar to AHK format without X and Y but with P instead. For instance “w300 h30 p10”. “p” means position and it represents X for Edge type Top/Bottom or Y for Edge type Left/Right. If “p” is omitted Appbar will be put in center. If “p” is negative, window is positioned the opposite end. |
| Style | Space separated list of Appbar styles. See below. |
| Label | Used when function creates Gui, and for making an AHK Group. By default Hwnd is added to the group. You can add more windows in the group that are part of the taskbar. Appbar with autohide style will not be hidden when window belonging to its group is activated. By default “Appbar”. |
| OnTop | Sets the Appbar always on top. |
| Show | Show the Appbar. If not present the Appbar will not be shown or visibility settings of passed window will not be changed. By default “OnTop Show Reserve”. |
| Pin | Pin the Appbar to the Desktop (reserve the desktop space for the Appbar). The system prevents other applications from using the screen area occupied by the appbar. Ignored with AutoHide. |
Gui number if function created Gui.
Appbar_SetTaskBar( State = "" )
Set the state of the Taskbar.
| State | ”autohide”, “ontop”, “all”. You can also remove (-), add (+) or toggle (^) state. Omit to disable all states. You can also pass “disable”. This is the only good way to remove TaskBar (simply hiding the window isn’t enough). |
Previous state.
Shell_SetTaskBar() ;remove all states of TaskBar
Shell_SetTaskBar("+autohide") ;add autohide state
Shell_SetTaskBar("-autohide") ;remove autohide state
Shell_SetTaskBar("ontop") ;set state to ontop
Shell_SetTaskBar("^ontop") ;toggle ontop state
oldState := Shell_SetTaskBar("disable") ;disable it.
Shell_SetTaskBar( oldState ) ; & restore it when you are done ...
;Hotkey to enable/disable taskbar in reliable way.
F12::
if bIsEnabled := !bIsEnabled
oldState := AppBar_SetTaskbar("^disable")
else AppBar_SetTaskbar(oldState)
returnCreates new Appbar.
Appbar_New( ByRef Hwnd, o1 = "", o2 = "", o3 = "", o4 = "", o5 = "", o6 = "", o7 = "", o8 = "", o9 = "" )
Unregisters an appbar by removing it from the system’s internal list.
Appbar_Remove( Hwnd )
Set the state of the Taskbar.
Appbar_SetTaskBar( State = "" )