Narrator reads collapsed content

WPF, hide collapsed content to be ignored by the narrator

Hidden maintains

Last week, I worked on some accessibility issues. One of them was the windows narrator reading collapsed content. Hidding the content from the narrator was a little harder than I would have expected when starting working on the issues.

The WPF application is using an MVVM pattern where controls are hidden and shown by changing the Visibility property. For users that look at the screen, this works fine. However, when navigating the screen with the windows narrator, the collapsed content was still read to the user. When looking deeper, content in WPF that is collapsed is removed from the visual tree and should not be read by the narrator.

Fortunately, I found some hints to make a workaround. By overriding the OnCreateAutomationPeer method, you can give a hint to the narrator to read or not read the element. The method IsControlElementCore in the AutomationPeer class gives a hint on if a control is a Control element if so the narrator skips the control. This can be used to skip your content when hidden:

public class MyButton : Button
    protected override AutomationPeer OnCreateAutomationPeer()
        return new MyAutomationPeer(this);

public class MyAutomationPeer : ButtonBaseAutomationPeer
     public MyAutomationPeer(Button button): base(button) {}

     protected override bool IsControlElementCore()
          return Owner.Visible != Visiblity.Collapsed;

In the XAML I updated the controls to my own controls and now the collapsed content is hidden from the narrator.

Some links:

Image by:Malcolm Lightbody

5 thoughts on “Narrator reads collapsed content”

  1. I need to implement something similar for views. When the narrator is reading my view, it first reads control on the base page (that are now hidden) and then reads the view controls. Can you please help me with it.


    1. The code above checks on collapsed, not on hidden. So you have to collapse the view to remove it from the visual tree. I did add some code to check if a parent control is collapsed (in the IsControlElementCore method). Some controls are composed of multiple sub elements, which can lead to some problems. As last resort you can just remove the text when the control is collapsed. Getting to to work right is in most cases lots of try and retry. You can also try .net 4.8 preview release: The accessibility should be improved a lot and if you are able to target a newer framework it will save you a lot of time.


      1. Thank you Peter. Sorry to bother you. One last doubt. I implemented this same code for Button in my application. But now when the narrator focuses on button, it says “Directions Custom” instead of “Directions Button Double tap to select”. I was able to change it back to button using the following code:

        protected override AutomationControlType GetAutomationControlTypeCore()
        return AutomationControlType.Button;
        But it still does not say Double tap to select. Also on double tap, nothing happens on the focused button. Do you have any idea, how can we make it to retain it’s double tap functionality.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.