tip2tail.WinFormAppBarLib 1.2.1

Helper library for creating AppBars (forms which are docked to the side of the screen).  AppBars reserve the required space, similar to the Taskbar in Windows.

Install-Package tip2tail.WinFormAppBarLib -Version 1.2.1
dotnet add package tip2tail.WinFormAppBarLib --version 1.2.1
<PackageReference Include="tip2tail.WinFormAppBarLib" Version="1.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add tip2tail.WinFormAppBarLib --version 1.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

t2tWinFormAppBarLib

Helper library for creating AppBars (forms which are docked to the side of the screen) in .NET WinForms. AppBars reserve the required space, similar to the Taskbar in Windows.

Available via Nuget : https://www.nuget.org/packages/tip2tail.WinFormAppBarLib/

Based on:

  • https://github.com/PhilipRieck/WpfAppBar which carries out a similar function for WPF applications.
  • Various other sources found online.

What is it?

A helper for turning a WinForms window into an "AppBar" like the Windows taskbar.

How do I use it?

To use, just call this code from anywhere within a normal WinForms window (say a button click or the initialize). Note that you can not call this until AFTER the window is initialized, if the HWND hasn't been created yet (like in the constructor), an error will occur.

// Setup
AppBarHelper.AppBarMessage = "UniqueAPIMesasgeForYourApplication";

// Make the window an AppBar and dock to the right of the screen:
AppBarHelper.SetAppBar(this, AppBarEdge.Right);

// Restore the window to a normal window:
AppBarHelper.SetAppBar(this, AppBarEdge.None);

How do I prevent the bar being hidden on Win+D / Show Desktop?

By default the app bar will be hidden when a user executes the Windows Show Desktop command. This can be prevented but requires some additional code:

// Add the following in your form's constructor, before InitializeComponent()
AppBarHelper.PreventShowDesktop(this.Handle);

Important Note: A side-effect of preventing Show Desktop is that a non docked window will appear behind every other application that is running.

I found a bug!

Please add an issue, or better yet send a pull request. I can't say that I'll revisit this project in the future so any contributions are welcome.
Thanks!

That sounds okay... but licensing?

No warranty of any kind implied. MIT license.

t2tWinFormAppBarLib

Helper library for creating AppBars (forms which are docked to the side of the screen) in .NET WinForms. AppBars reserve the required space, similar to the Taskbar in Windows.

Available via Nuget : https://www.nuget.org/packages/tip2tail.WinFormAppBarLib/

Based on:

  • https://github.com/PhilipRieck/WpfAppBar which carries out a similar function for WPF applications.
  • Various other sources found online.

What is it?

A helper for turning a WinForms window into an "AppBar" like the Windows taskbar.

How do I use it?

To use, just call this code from anywhere within a normal WinForms window (say a button click or the initialize). Note that you can not call this until AFTER the window is initialized, if the HWND hasn't been created yet (like in the constructor), an error will occur.

// Setup
AppBarHelper.AppBarMessage = "UniqueAPIMesasgeForYourApplication";

// Make the window an AppBar and dock to the right of the screen:
AppBarHelper.SetAppBar(this, AppBarEdge.Right);

// Restore the window to a normal window:
AppBarHelper.SetAppBar(this, AppBarEdge.None);

How do I prevent the bar being hidden on Win+D / Show Desktop?

By default the app bar will be hidden when a user executes the Windows Show Desktop command. This can be prevented but requires some additional code:

// Add the following in your form's constructor, before InitializeComponent()
AppBarHelper.PreventShowDesktop(this.Handle);

Important Note: A side-effect of preventing Show Desktop is that a non docked window will appear behind every other application that is running.

I found a bug!

Please add an issue, or better yet send a pull request. I can't say that I'll revisit this project in the future so any contributions are welcome.
Thanks!

That sounds okay... but licensing?

No warranty of any kind implied. MIT license.

Release Notes

Added new feature prevents bar hiding on Show Desktop

Dependencies

This package has no dependencies.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.2.1 141 3/23/2019
1.1.1 325 3/11/2018
1.0.2 278 1/13/2018
1.0.1 255 1/13/2018
1.0.0 400 1/10/2018