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. This API first became available in Windows 10 RS5. ## Pinning Starting with Windows 10 RS5 and early versions of Windows 11 this API pins without prompting the user. Later versions of Windows 10 and 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 for every version of Windows released after Windows 10 RS5. ## Requirements The IPinnedList3 API can pin shortcuts from any directory. 8025 -
ffi.rs FFI accessible entry points into the taskbar module. 5447 -
mod.rs # Taskbar Pinning This module abstracts over the WinRT and COM APIs relevant to Windows Taskbar pinning. 9372 -
shortcut.rs # Taskbar Shortcuts This module includes utilities for interacting with shortcuts relevant to taskbar pinning. Shortcuts are only relevant for non-MSIX installs; MSIX pinning does not rely on the existence of shortcuts in `shell:AppsFolder` to pin applications to the taskbar, nor does it store shortcuts in the taskbar pin folder. 7128 -
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 and packaged (Win32 MSIX) apps while locking down the undocumented [IPinnedList3 COM API][super::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. For MSIX installs this requires an <Application> entry in the AppxManifest.xml, for non-MSIX installs 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. The app must be focused when pinning is requested. 16528 -