可訪問性支持

立即下載DevExpress WPF

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

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

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

 (如)使用來獲取有關UI元素的信息。為了獲得信息，框架要求控件包含UI自動化對等體并引發UI自動化事件。

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

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

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

啟用驗證支持

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

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

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>

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

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

屏幕閱讀器應用限制

以下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：功能區、工具欄或工具窗口。

主題

高對比度主題

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

增強對比度的預定義調色板

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

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

.NET 6 Tooltips

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

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

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

提示：

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

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

XAML：

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