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 0, 1, “Slide”, “Blend” or “Center”. Window will be shown only if mouse is its in hot area. When Appbar is activated, it will not auto hide until its deactivated again. Without this argument, the space on screenwill be reserved for the Appbar and all other windows will not be able to maximize over it the same as with Taskbar which is set ontop without autohide. |
| Pos | Position. String similar to AHK format without X and Y and 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 omited Appbar will be put in center. If “p” is negative, window is positioned the oposite end. |
| Style | Space separted 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 alaways 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 destop 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 ...Creates 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 = "" )