Easily modernise your WPF and Windows Forms/WinForms WebBrowser controls with 3 lines of C# or VB code

Originally published:

If you've ever used the WPF or Windows Forms WebBrowser control in recent years, it's quite likely that you've noticed that many websites don't work well with it and that it can be slow when rendering content. This control uses Internet Explorer to render web contents and although Internet Explorer may be old, it's actually better than how it behaves by default when using the WebBrowser controls. This is because of compatibility features that result in the WebBrowser control not being as up-to-date as it should. Luckily, it's very easy to disable these compatibility features for your app by simply adding a value to the registry (and note that this works even if your app is packaged and using registry virtualisation). There are 3 compatibility features that can greatly affect the behaviour of the WebBrowser control and these are FEATURE_BROWSER_EMULATION, FEATURE_NINPUT_LEGACYMODE and FEATURE_96DPI_PIXEL. Here's what they all do:

  • FEATURE_BROWSER_EMULATION - This feature causes the WebBrowser control to behave as though it is using an older version of Internet Explorer.
  • FEATURE_NINPUT_LEGACYMODE - This disables modern features such as hardware accelerated panning and zooming is disabled, tap to select text and pointer and gesture events.
  • FEATURE_96DPI_PIXEL - This feature enables better DPI scaling behaviour.

To set these values, you just have to add a DWORD to the key 'HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl' with the name being the file name of the executable file of your app. Then, set the value according to the information below:

  • FEATURE_BROWSER_EMULATION - This can be set to a variety of different values depending on the behaviour you want. The highest value you can use here is '11001'. This will result in any WebBrowsers running inside that executable using Internet Explorer 11. By default, WebBrowsers will emulate Internet Explorer 8 if this value is not set. View more information about this feature here.
  • FEATURE_NINPUT_LEGACYMODE - This can be set to 1 or 0 and is set to 1 by default. Setting this to 0 will disable this compatibility feature, resulting in more modern behaviour. View more information about this feature here.
  • FEATURE_96DPI_PIXEL - Setting this to 1 will result in better system aware DPI scaling behaviour. If you find content in WebBrowsers appears too small, this can help. View more information about this feature here.
If you FEATURE_BROWSER_EMULATION to 11001, FEATURE_NINPUT_LEGACYMODE to 0 and FEATURE_96DPI_PIXEL to 1, this will result in a more modern WebBrowser control, resulting in better website compatibility, faster rendering, scrolling and zooming and content being easier to read in high DPI environments. Note that Microsoft states that FEATURE_96DPI_PIXEL is obsolete - though it still works and they have not provided an alternative that we could find. Also note that FEATURE_96DPI_PIXEL only improves system aware DPI scaling - it won't react to scaling changes after the application was launched, so be aware of this if you use Per Monitor DPI scaling.

You can set these values in code in C# like so:

Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\\Microsoft\\Internet Explorer\\Main\\FeatureControl\\FEATURE_BROWSER_EMULATION", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(System.Windows.Forms.Application.ExecutablePath), 11001, Microsoft.Win32.RegistryValueKind.DWord);


Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\\Microsoft\\Internet Explorer\\Main\\FeatureControl\\FEATURE_NINPUT_LEGACYMODE", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(System.Windows.Forms.Application.ExecutablePath), 0, Microsoft.Win32.RegistryValueKind.DWord);

 

Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\\Microsoft\\Internet Explorer\\Main\\FeatureControl\\FEATURE_96DPI_PIXEL", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(System.Windows.Forms.Application.ExecutablePath), 1, Microsoft.Win32.RegistryValueKind.DWord);

And in VB:

Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(Forms.Application.ExecutablePath), 11001, Microsoft.Win32.RegistryValueKind.DWord)

 

Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_NINPUT_LEGACYMODE", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(Forms.Application.ExecutablePath), 0, Microsoft.Win32.RegistryValueKind.DWord)

 

Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_96DPI_PIXEL", Microsoft.Win32.RegistryKeyPermissionCheck.Default).SetValue(System.IO.Path.GetFileName(Forms.Application.ExecutablePath), 1, Microsoft.Win32.RegistryValueKind.DWord)

You can run the above code when your app starts up before you initialise any WebBrowsers to ensure the values apply.

Note: For a more modern web control, you could use the WebView, WebViewCompatible or WebView2 controls. If you need help with these controls, we have guides on how to allow moving focus to and from the WPF WebView control using the Tab key and how to check if the WebView2 runtime is installed.

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.

Did this guide help you? Do you have anything to add? Let us know in the comments! Also, if this guide did help you and you use an AdBlocker and you want to support us, consider disabling it for this site - if you do, it will be greatly appreciated!

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