螢幕助讀程式和硬體系統按鈕

發行項
04/01/2024

朗讀程式等螢幕助讀程式必須能夠辨識並處理硬體系統按鈕事件，並將事件狀態傳達給使用者。在某些情況下，螢幕助讀程式可能需要專門處理這些硬體按鈕事件，而不讓它們反昇至其他處理常式。

從 Windows 10 版本 2004 開始，UWP 應用程式能以與其他硬體按鈕相同的方式，接聽並處理 Fn 硬體系統按鈕事件。以往，此系統按鈕僅充當其他硬體按鈕所回報之事件和狀態的修飾元。

注意事項

是否支援 Fn 按鈕取決於 OEM 廠商，功能可能包括：切換/鎖定開啟或關閉的功能 (而非按住不放的按鍵組合)，以及對應的鎖定指示燈 (對盲人或視力障礙人士可能沒有幫助)。

Fn 按鈕事件會透過 Windows.UI.Input 命名空間中的新 SystemButtonEventController 類別公開。 SystemButtonEventController 物件支援下列事件：

重要事項

如果這些事件已由優先順序較高的處理常式處理，則 SystemButtonEventController 無法接收這些事件。

範例

以下範例將會示範如何根據 DispatcherQueue 建立 SystemButtonEventController，並處理此物件支援的四種事件。

按下 Fn 按鈕時，通常會引發多個支援的事件。舉例來說，按下 Surface 鍵盤上的 Fn 按鈕會同時引發 SystemFunctionButtonPressed、SystemFunctionLockChanged 和 SystemFunctionLockIndicatorChanged。

在第一個程式碼片段中，我們僅加入所需的命名空間，並指定了一些全域物件，包括用來管理 SystemButtonEventController 執行緒的 DispatcherQueue 和 DispatcherQueueController 物件。

然後，我們指定了註冊 SystemButtonEventController 事件處理委派時，所傳回的事件語彙基元。

namespace winrt
{
    using namespace Windows::System;
    using namespace Windows::UI::Input;
}

...

// Declare related members
winrt::DispatcherQueueController _queueController;
winrt::DispatcherQueue _queue;
winrt::SystemButtonEventController _controller;
winrt::event_token _fnKeyDownToken;
winrt::event_token _fnKeyUpToken;
winrt::event_token _fnLockToken;

我們還為 SystemFunctionLockIndicatorChanged 事件指定了一個事件語彙基元和一個布林值，以指出應用程式是否處於「學習模式」(使用者只是嘗試探索鍵盤，而不執行任何功能)。
```
winrt::event_token _fnLockIndicatorToken;
bool _isLearningMode = false;
```

第三個程式碼片段包含 SystemButtonEventController 物件所支援之每個事件的對應事件處理常式委派。

每個事件處理常式都會宣告發生的事件。另外，FunctionLockIndicatorChanged 處理常式還會控制應用程式是否處於「學習」模式 (_isLearningMode = true)，以防止事件升階至其他處理常式，讓使用者能夠探索鍵盤功能而不實際執行任何操作。

void SetupSystemButtonEventController()
{
    // Create dispatcher queue controller and dispatcher queue
    _queueController = winrt::DispatcherQueueController::CreateOnDedicatedThread();
    _queue = _queueController.DispatcherQueue();

    // Create controller based on new created dispatcher queue
    _controller = winrt::SystemButtonEventController::CreateForDispatcherQueue(_queue);

    // Add Event Handler for each different event
    _fnKeyDownToken = _controller->FunctionButtonPressed(
        [](const winrt::SystemButtonEventController& /*sender*/, const winrt:: FunctionButtonEventArgs& args)
        {
            // Mock function to read the sentence "Fn button is pressed"
            PronounceFunctionButtonPressedMock();
            // Set Handled as true means this event is consumed by this controller
            // no more targets will receive this event
            args.Handled(true);
        });

        _fnKeyUpToken = _controller->FunctionButtonReleased(
            [](const winrt::SystemButtonEventController& /*sender*/, const winrt:: FunctionButtonEventArgs& args)
            {
                // Mock function to read the sentence "Fn button is up"
                PronounceFunctionButtonReleasedMock();
                // Set Handled as true means this event is consumed by this controller
                // no more targets will receive this event
                args.Handled(true);
            });

    _fnLockToken = _controller->FunctionLockChanged(
        [](const winrt::SystemButtonEventController& /*sender*/, const winrt:: FunctionLockChangedEventArgs& args)
        {
            // Mock function to read the sentence "Fn shift is locked/unlocked"
            PronounceFunctionLockMock(args.IsLocked());
            // Set Handled as true means this event is consumed by this controller
            // no more targets will receive this event
            args.Handled(true);
        });

    _fnLockIndicatorToken = _controller->FunctionLockIndicatorChanged(
        [](const winrt::SystemButtonEventController& /*sender*/, const winrt:: FunctionLockIndicatorChangedEventArgs& args)
        {
            // Mock function to read the sentence "Fn lock indicator is on/off"
            PronounceFunctionLockIndicatorMock(args.IsIndicatorOn());
            // In learning mode, the user is exploring the keyboard. They expect the program
            // to announce what the key they just pressed WOULD HAVE DONE, without actually
            // doing it. Therefore, handle the event when in learning mode so the key is ignored
            // by the system.
            args.Handled(_isLearningMode);
        });
}

另請參閱

SystemButtonEventController 類別

共用方式為

螢幕助讀程式和硬體系統按鈕

範例

另請參閱

其他資源