可訪問性支持

本主題介紹如何在DevExpress WPF控件中啟用基于UI自動化的可訪問性特性，并將可訪問的DevExpress應(yīng)用程序主題應(yīng)用到您的應(yīng)用程序中。

DevExpress WPF控件符合第508節(jié)，WCAG 2.0和EN 301 549。

基于UI自動化的可訪問性特性

基于UI自動化的可訪問性特性(如屏幕閱讀器)使用微軟UI自動化框架來獲取有關(guān)UI元素的信息。為了獲得信息，框架要求控件包含UI自動化對等體并引發(fā)UI自動化事件。

啟用基于UI自動化的可訪問性功能

在DevExpress WPF控件中 removed 了UI自動化節(jié)點和事件，這允許我們的控件避免對不依賴于UI自動化的應(yīng)用程序的avoid an impact on performance。要支持基于UI自動化的Windows特性，請用 one of the following 啟用UI自動化對等點和事件：

在啟動應(yīng)用程序之前，啟動一個屏幕閱讀應(yīng)用程序(如Windows Narrator)。
在應(yīng)用程序啟動時將屏幕閱讀器參數(shù)設(shè)置為true。
將ClearAutomationEventsHelper.IsEnabled屬性設(shè)置為false。

啟用驗證支持

將附加的ValidationService.AllowAccessibilityAlerts屬性設(shè)置為true，來通知用戶焦點編輯器和數(shù)據(jù)單元中的驗證錯誤。

您可以為容器啟用AllowAccessibilityAlerts選項，為它的子元素發(fā)送驗證警報：

XAML：

<dxg:GridControl dxe:ValidationService.AllowAccessibilityAlerts="True" .../>
<StackPanel
dxe:ValidationService.IsValidationContainer="True"
dxe:ValidationService.AllowAccessibilityAlerts="True">
<GroupBox>
<Grid>
<dxe:TextEdit .../>
<dxe:TextEdit .../>
</Grid>
</GroupBox>
<GroupBox>
<dxe:SpinEdit .../>
<dxe:ComboBoxEdit .../>
</GroupBox>
</StackPanel>

點擊復制

當用戶執(zhí)行以下操作時，驗證警報在UI自動化框架中更新：

專注一個具有驗證錯誤的編輯器。
選擇GridControl、TreeListControl或PropertyGridControl中存在驗證錯誤的單元格。
將正確的值更改為不正確的值，反之亦然。警報僅在輸入驗證后發(fā)送，如果ValidateOnTextInput屬性設(shè)置為true，則每次字符更改時都會進行輸入驗證，但是當驗證通過或失敗時，用戶只會收到一個警報。
調(diào)用帶有錯誤消息的工具提示。
當InvalidValueBehavior屬性設(shè)置為WaitForValidValue時，嘗試從具有驗證錯誤的編輯器切換焦點。

屏幕閱讀器應(yīng)用限制

以下DevExpress WPF控件不允許UI自動化框架訪問其 embedded documents、 graphic canvases或Map

Map
Chart
End-User Report Designer
PDF Viewer
Print/Export Windows
Rich Text Editor
Diagram

此限制不適用于集成到這些控件中的任何shell UI：功能區(qū)、工具欄或工具窗口。

主題

高對比度主題

您可以將Office 2019高對比度主題應(yīng)用于DevExpress WPF控件。

增強對比度的預定義調(diào)色板

增強對比度預定義調(diào)色板使用顏色組合，幫助有視覺障礙的用戶區(qū)分文本、邊框、選擇狀態(tài)和其他視覺元素。

您可以在Office 2016 SE、Office 2019、Visual Studio 2017和Visual Studio 2019主題中使用預定義的對比度調(diào)色板。

.NET 6 Tooltips

在.net 6中，DevExpress WPF控件顯示的所有工具提示的行為都符合WCAG 2.1的可訪問性要求。

Dismissable。用戶可以按Ctrl鍵隱藏鍵盤導航后顯示的工具提示。
Hoverable。懸停時工具提示仍然可見。
Persistent。工具提示保持可見，直到用戶解除(通過移動光標或按Ctrl鍵)。

當父元素獲得鍵盤焦點時將打開工具提示，要打開聚焦項的工具提示，用戶可以按Ctrl+Shift+F10組合鍵。

提示：

為了防止工具提示在鍵盤焦點上顯示，將標準的ShowsToolTipOnKeyboardFocus附加屬性設(shè)置為false。此屬性僅對應(yīng)用該屬性的控件有效，而對控件的子元素無效。

要禁用GridControl， PivotGridControl及其后代的鍵盤焦點上的工具提示，請指定InplaceBaseEdit樣式如下：

XAML：

<Style TargetType="dxe:InplaceBaseEdit">
<Setter Property="ToolTipService.ShowsToolTipOnKeyboardFocus" Value="False"/>
</Style>