How to enable precision/smooth scrolling in a WPF app on Windows in C# and VB

Originally published:

The Windows Presentation Foundation, or WPF for short is a powerful platform for creating applications in Windows. Introduced in the .NET Framework 3.0 along with Windows Vista in 2006, WPF included an overhault to rendering user interfaces compared to its alternatives at the time, such as GDI (Graphics Driver Interface) and Windows Forms. 

Although modern back in 2006, WPF is starting to show its age in modern versions of Windows. One of the areas where WPF shows its age is in scrolling. Although still common, the traditional mouse and keyboard is not the only way to control a Windows computer - touch screens, pens and touchpads are other ways in which a user can send input to a computer.

If you have ever tried scrolling a scroll viewer in WPF using a touchpad or precision mouse, you would have noticed how over sensitive the scrolling is; this is not an issue with the mouse or touchpad, nor is it an issue with Windows, this is an issue with WPF ignoring an important value, known as the delta value. Whenever Windows sends scroll wheel messages, it includes the delta value, which determines how far content should scroll, the trouble is that WPF just ignores this value. However, the good news is that WPF still reads this value, it just doesn't do anything with it.

To enable precision scrolling, all we need to do is override the scrolling behaviour of a scroll viewer using the PreviewMouseWheel event. Now, you can do this to any scroll viewer you want, but for this example we will do it in a style in the App.xaml/Application.xaml file so that we can enable precision scrolling on all scroll viewers.

Firstly, in the App.xaml or Application.xaml file, add this code under <Application.Resources>:


 <Style TargetType="ScrollViewer">

        <EventSetter Event="PreviewMouseWheel" Handler="ScrollViewer_PreviewMouseWheel"/>

 </Style> 

Now right click on "ScrollViewer_PreviewMouseWheel" and select "Go to Definition". This should take you to App.xaml.cs or Application.xaml.vb, depending on what language you are using. Now, here is the code you want inside the event handler method. Feel free to experiment with it, change it and tidy it up if you desire.

C#:

// Try catches here just to ensure app does not crash and instead falls back to default WPF scrolling behaviour if an exception occurs here for whatever reason if an exception occurs here for whatever reason

try

{

// Disables custom scroll handling when scroll by one screen at a time is enabled in mouse settings. Feel free to handle this yourself if you wish.

if (System.Windows.Forms.SystemInformation.MouseWheelScrollLines == -1)

        e.Handled = false;

   else

    try

        {

         // Scrolls the scroll viewer according to the delta value and the user's scrolling settings

                System.Windows.Controls.ScrollViewer SenderScrollViewer = (System.Windows.Controls.ScrollViewer)sender;

                SenderScrollViewer.ScrollToVerticalOffset(SenderScrollViewer.VerticalOffset - e.Delta * 10 * System.Windows.Forms.SystemInformation.MouseWheelScrollLines / (double)120);

                e.Handled = true;

                }

                catch

                {

                }

        }

        catch

        {

        }

VB:

' Try catches here just to ensure app does not crash and instead falls back to default WPF scrolling behaviour if an exception occurs here for whatever reason

     Try

         ' Disables custom scroll handling when scroll by one screen at a time is enabled in mouse settings. Feel free to handle this yourself if you wish.

         If System.Windows.Forms.SystemInformation.MouseWheelScrollLines = -1 Then

             e.Handled = False

         Else

             Try

                 ' Scrolls the scroll viewer according to the delta value and the user's scrolling settings

                 Dim SenderScrollViewer As System.Windows.Controls.ScrollViewer = sender

                     SenderScrollViewer.ScrollToVerticalOffset(SenderScrollViewer.VerticalOffset - e.Delta * 10 * System.Windows.Forms.SystemInformation.MouseWheelScrollLines / 120)

                 e.Handled = True

             Catch

         End Try

         End If

     Catch

     End Try


Tip: If you get errors relating to the lines that reference Windows Forms and you are using .Net Framework, go to the solution explorer, right click References,  click Add Reference..., select Assemblies, search up Forms and add  'System.Windows.Forms'. If you are using .Net Core and have this issue, right click the project file and select 'Edit Project File' and add ' <UseWindowsForms>true</UseWindowsForms>' to '<PropertyGroup>' at the start of the file.

Bonus: ScrollViewers not scrolling with touch? Have a look at this article here.
Extra bonus: Want to enable more performant and precise scrolling for your WebBrowser controls? Have a look here.

This snippet is available in Codly. Click the appropriate link below to download the snippet. If you don't have Codly, it is available here in the Microsoft Store.

Examples

Scrolling with a touchpad normally in WPF:


Scrolling with a touchpad using the code from this guide in WPF:


The above examples were taken from our app Window Commander.

Follow us to be notified when we release new guides:
Facebook
Twitter
Tags:

Comments

Post a Comment

Popular posts from this blog

How to show placeholder text in a WPF TextBox in C# and VB

Originally published:
Image
Sometimes, when you have a text box in a user interface, you may want to add placeholder text to that text box to give users a prompt as to what to enter into the text box. If you've ever used UWP or WinUI, you'll probably have noticed that the default text box elements provide a PlaceholderText property that provides this functionality. However, WPF and Windows Forms don't provide this functionality by default. Luckily, thanks to WPF's rendering capabilities, it is quite easy to set up placeholder text manually. If you're using Windows Forms, you can make use of the ElementHost to use a WPF TextBox. Typically, placeholder text is a slightly faded colour compared to user-entered text to help distinguish it and only shows when no text is entered into the text box. An example is below: How to show placeholder text in a WPF TextBox To show placeholder text in a WPF textbox, all we need to do is show a partially transparent, intangible Label above the TextBox like so (Y...
Read more

How to enable dark title bar in WPF and Windows Forms/WinForms apps in C# and VB

Originally published:
Image
Windows has had a dark mode feature for a long time now, however, as a Windows Forms and/or WPF (Windows Presentation Foundation) developer, you may have noticed that the Windows dark mode does not affect your app at all automatically - in fact the Windows dark mode only automatically affects UWP, WinUI and Chromium based user interfaces - there's no support for Windows dark mode in Windows Forms and WPF. Tip: If you want to set the title bar's colours to any colours you want instead of just light or dark, follow this guide here . Luckily, it is very easy to determine if dark mode is currently enabled and be notified any time dark mode is switched on or off - from there it's just a matter of updating your UI to match which mode Windows is in. While this may work fine for the client area of your app (i.e. the area of your app that does not include the title bar and border), you don't have a lot of control over the non-client area of your app and you'll notice that by...
Read more

How to use modern icons in XAML in WPF on Windows 10 and 11

Originally published:
Image
Icons and symbols are a common part of modern user interfaces. Depending on your skills, creating your own icons may not be easy. Luckily, Windows 10 and 11 come preinstalled with plenty of icons that can be used in applications. If you've developed for UWP or WinUI and have used the SymbolIcon , you may have seen these icons before. By using these modern icons, you can create user interfaces that look consistent with the operating system. And the great part is that it's easy to use these icons with WPF (Windows Presentation Foundation) while supporting both Windows 10 and 11. 6 WPF buttons with modern icons in Windows 11 The same 6 WPF buttons with modern icons in Windows 10 Where the icons are stored These modern icons that Windows 10 and 11 include come in the form of fonts - specifically Segoe MDL2 Assets and Segoe Fluent Icons . Segoe MDL2 Assets is included in Windows 10 and 11 and Segoe Fluent Icons is included in Windows 11. Segoe Fluent Icons includes newer version...
Read more

How to change the colour of a WPF or Windows Forms/WinForms title bar in Windows 11 in C# and VB

Originally published:
Image
The windows title bar has gone through various changes throughout the years - from the old title bars with user customisable colours to the newer title bars with visual styling support introduced in Windows XP to the DWM (Desktop Window Manager) rendered title bars introduced in Windows Vista. One thing about these changes is that they often explored the concepts the relationship of the title bar to the client area of Windows and who is in control of what the title bar looks like. For example, in Windows XP, the user could only choose between specific title bar styles unless you used the Windows classic theme, in which case you could choose your own title bar colours or even use gradients if you wanted. With the addition of the DWM in Windows Vista, Microsoft explored the idea of extending the title bar into the non client area of Windows - think File Explorer and Microsoft Word for example. Where we are now In modern versions of Windows, the title bar only uses the DWM version and all...
Read more

Microsoft WebView2: How to check if the WebView2 runtime is installed in C# and VB

Originally published:
With the initial release of Windows 10, Microsoft released a completely new web browser - Microsoft Edge - that used its own rendering engine - EdgeHTML. In recent years, Microsoft deprecated the original version of Microsoft Edge and replaced it with a Chromium based version. The original version of Microsoft Edge came with a control called WebView which could be used by apps to display content. Now that Microsoft has released the new Chromium based Edge, a new control has been released called WebView2. The existing WebView control still uses the original Microsoft Edge whereas the new WebView2  uses the Chromium based Microsoft Edge. The new control however, is not reliant on the same version of Microsoft Edge that is used as the main browser - instead it is reliant on a separate component known as the WebView2 Runtime (except in the case of non-stable channels, which come with the WebView2 runtime). This component is preinstalled in Windows 11 and is currently being rolled out ...
Read more