firefox-main/browser/components/shell/rust/shell_windows/src/taskbar
Name Description Size Coverage
com.rs # Taskband Pin COM API Taskband Pin is a COM class implementing the undocumented IPinnedList3 interface that affords pinning and unpinning from the Windows taskbar for unpackaged Win32 (non-MSIX) applications. Chromium source documents this API as functional starting with Windows 10 RS5 and ending as of Windows 11 24H2. ## Pinning In Windows 10 and early versions of Windows 11 this API pins without prompting the user. Later versions of Windows 11 prior to Windows 11 24H2 instead prompt the user if they wish to pin with a toast notification. For Windows 11 24H2 and later this API reports success even though pinning is not successful. ## Unpinning This API can be used to unpin an application past Windows 11 24H2. ## Requirements The IPinnedList3 API can pin shortcuts from any directory. 8006 28 %
mod.rs # Taskbar Pinning This module abstracts over the WinRT and COM APIs to pin a given shortcut with matching AppUserModelId (AUMID) to the Windows taskbar. 6118 73 %
winrt.rs # TaskbarManager Pin WinRT API This implements functionality to pin an app to the taskbar using the TaskbarManager WinRT API. This was originally exposed to UWP/MSIX apps, and later extended to unpackaged Win32 apps while locking down the undocumented [IPinnedList3 COM API][crate::taskbar::com]. ## Secondary Pinning For unpackaged Win32 applications secondary applications can be pinned to the taskbar by temporarily changing the process AUMID while requesting the application be pinned. This does not work for MSIX applications as the process AUMID is virtualized, and modifying it within the application is not visible to the system. Instead MSIX relies on [Secondary Tiles][crate::secondary_tiles]. ## Limited Access Feature This feature initially required the "com.microsoft.windows.taskbar.pin" [Limited Access Feature][crate::limited_access_features] unlocked to work for unpackaged Win32 applications. As of Windows 11 26200 Build 7840 this graduated out of limited access and became generally available. ## Requirements This API requires a shortcut present in the virtual shell:appsfolder directory, i.e. a shortcut with unique AUMID in either the User or Common Start Menu folders. Note that there is a delay between files being created in the Start Menu folders and becoming accessible in shell:appsfolder. Additionally the app must be focused when pinning is requested. 12946 66 %