Dela via

TaskbarManager Class

  • Reference

Definition

Namespace:
Windows.UI.Shell
Edit

Provides methods for pinning applications to the taskbar.

public ref class TaskbarManager sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TaskbarManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TaskbarManager
Public NotInheritable Class TaskbarManager
Inheritance
Object Platform::Object IInspectable TaskbarManager
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v5.0)

Remarks

Version history

Windows version SDK version Value added
1809 17763 IsSecondaryTilePinnedAsync
1809 17763 RequestPinSecondaryTileAsync
1809 17763 TryUnpinSecondaryTileAsync

Properties

IsPinningAllowed

Gets whether pinning to the taskbar is allowed.
IsSupported

Gets whether the taskbar is present on the current device.

Methods

GetDefault()

Returns the TaskbarManager object active in the current process.
IsAppListEntryPinnedAsync(AppListEntry)

Checks if the specified application is already pinned to the taskbar.
IsCurrentAppPinnedAsync()

Checks if the currently active application is already pinned to the taskbar.
IsSecondaryTilePinnedAsync(String)

Checks if the specified secondary tile is pinned to taskbar. Requires user approval as described here
RequestPinAppListEntryAsync(AppListEntry)

Requests that the specified application be pinned to the taskbar.
RequestPinCurrentAppAsync()

Requests that the currently active application be pinned to the taskbar.
RequestPinSecondaryTileAsync(SecondaryTile)

Requests to pin the specified tile to taskbar. Requires user approval as described here.

Important

The TaskbarManager.RequestPinSecondaryTileAsync API is part of a Limited Access Feature (see LimitedAccessFeatures class). For more information or to request an unlock token, please use the LAF Access Token Request Form.
TryUnpinSecondaryTileAsync(String)

Tries to unpin the secondary tile from taskbar. Requires user approval as described here

Applies to

See also