Question

我有一个Visual Studio 2019解决方案，其中包含两个项目：一个包含登录页面的类库（Universal Windows）和一个简单导航至该登录页面的空白应用程序（Universal Windows）。

我的要求之一是整个解决方案必须通过可访问性测试。该测试涉及使讲述人（必须为讲述人）阅读屏幕上的所有文本。

我的问题是，讲述人仅在加载页面时读取具有焦点的TextBox的文本。我希望讲述人也可以阅读Image元素和TextBlock元素中的文本。这是我在页面中使用的XAML的简化版本：

<Page>
    <RelativePanel>
        <Image
             x:Name="Logo"
             AutomationProperties.Name="Logo"/>
        <TextBlock
             x:Name="WelcomeTo"
             x:Uid="WelcomeTo"
             Text="Welcome to" />
        <TextBlock
             x:Name="ServiceName"
             x:Uid="ServiceName"
             Text="Service Name" />
        <TextBox
             x:Name="UserId"
             x:Uid="UserId"
             PlaceholderText="User ID"/>
        <TextBox
             x:Name="Password"
             x:Uid="Password"
             PlaceholderText="Password"/>
        <Button
             x:Name="SignIn"
             x:Uid="SignIn"
             Content="Sign In"/>
        <TextBlock
             x:Name="Footer"
             x:Uid="Footer"
             Text="Footer Text" />
    </RelativePanel>
</Page>

作为一项健全性测试，我删除了两个TextBox元素以查看焦点是否是问题所在。在这种情况下，讲述人没有在屏幕上说任何文字。我还尝试将几个AutomationProperties字段更改为无效（即AccessibilityView =“ Control”，LiveSetting =“ Assertive”等）。我还使用了“检查”工具来验证所有文本框是否都出现在“控件”视图中。

我想念什么吗？

任何帮助或建议，我们将不胜感激。谢谢！

Answer 1

Narrator无法按预期阅读中的文本。仅在所选的文本框中

如果您想阅读TextBlock的文本，请打开讲述人扫描模式。然后使用方向键读取您在页面上选择的TextBlock。

打开讲述人： Ctrl + Win + Enter

打开扫描模型： CapsLock + 空格键

Answer 2

虽然不一定是最优雅的解决方案，但这可以满足我的需要。

我设置了UserId TextBox的AutomationProperties.NameProperty，它最初以编程方式获得焦点，以包含我想要的TextBlock文本。由于只希望读取一次TextBlock文本，因此我保存了初始NameProperty值，并在UserId随后获得焦点时将其重新设置。

我将XAML中的UserId更新为以下内容：

<TextBox
         x:Name="UserId"
         x:Uid="UserId"
         PlaceholderText="User ID"
         GotFocus="UserId_GotFocus"/>

然后我按如下方式更新相关的C＃文件：

namespace my_namespace
{
    public sealed partial class LoginPage : Page
    {
        private bool hasFullTextBeenRead = false;
        private object userIdNameProperty = null;

        private void UserId_GotFocus(object sender, RoutedEventArgs e)
        {
            if (hasFullTextBeenRead)
            {
                UserId.SetValue(AutomationProperties.NameProperty, userIdNameProperty);
            }
            else
            {
                userIdNameProperty = UserId.GetValue(AutomationProperties.NameProperty);
                UserId.SetValue(AutomationProperties.NameProperty, 
                    // Add a period so Narrator pauses after reading the logo name.
                    FrameworkElementAutomationPeer.FromElement(Logo)?.GetName() + ". " + 
                    FrameworkElementAutomationPeer.FromElement(WelcomeTo)?.GetName() + " " + 
                    // Add a period so Narrator pauses after reading the service name.
                    FrameworkElementAutomationPeer.FromElement(ServiceName)?.GetName() + ". " + 
                    // Add a period so Narrator pauses after reading the footer.
                    FrameworkElementAutomationPeer.FromElement(Footer)?.GetName() + ". " + 
                    FrameworkElementAutomationPeer.FromElement(UserId)?.GetName());

                hasFullTextBeenRead = true;
            }
        }
    }
}

我希望这对其他人有帮助，我希望听到更好的解决方案。谢谢！

讲述人无法按预期读取TextBlock中的文本。仅在选定的文本框中

2 个答案: