FGenericAccessibleMessageHandler

Platform and application-agnostic messaging system for accessible events.

Windows
MacOS
Linux

References

Module

ApplicationCore

Header

/Engine/Source/Runtime/ApplicationCore/Public/GenericPlatform/Accessibility/GenericAccessibleInterfaces.h

Include

#include "GenericPlatform/Accessibility/GenericAccessibleInterfaces.h"

Syntax

class FGenericAccessibleMessageHandler

Remarks

Platform and application-agnostic messaging system for accessible events. The message handler lives in GenericApplication and any subclass that wishes to support accessibility should subclass this and use GenericAppliation::SetAccessibleMessageHandler to enable functionality.

GetAccessibleWindow() is tne entry point to all accessible widgets. Once the window is retrieved, it can be queried for children in various ways. RaiseEvent() allows messages to bubble back up to the native OS through anything bound to the AccessibleEventDelegate.

Callers can use ApplicationIsAccessible() to see if accessibility is supported or not. Alternatively, calling GetAccessibleWindow and seeing if the result is valid should provide the same information.

Variables

Name Description

Protected variable

bool

 

bApplicationIsAccessible

Subclasses should override this to indicate that they support accessibility.

Public variable

 

FVariant

If this was a property changed event, the 'after' value.

Constructors

Destructors

Functions

Name Description

Public function Const

bool

 

ApplicationIsAccessible()

Subclasses should return true to indicate that they support accessibility.

Public function Virtual Const

TSharedPtr< ...

 

GetAccessibleWidgetFromId

(
    AccessibleWidgetId Id
)

Retrieves an accessible widget that matches the given identifier.

Public function Virtual Const

TSharedPtr< ...

 

GetAccessibleWindow

(
    const TSharedRef< FGenericWindow > ...
)

Creates or retrieves an accessible object for a native OS window.

Public function Virtual Const

AccessibleWi...

 

GetAccessibleWindowId

(
    const TSharedRef< FGenericWindow > ...
)

Creates or retrieves the identifier for an accessible object for a native OS window.

Public function Const

bool

 

IsActive()

Checks if accessibility is enabled in the application.

Public function Virtual

void

 

MakeAccessibleAnnouncement

(
    const FString& AnnouncementString
)

Request a string to be announced to the user.

Protected function Virtual

void

 

OnActivate()

Triggered when bIsActive changes from false to true.

Protected function Virtual

void

 

OnDeactivate()

Triggered when bIsActive changes from true to false.

Public function

void

 

RaiseEvent

(
    TSharedRef< IAccessibleWidget > Wid...,
    EAccessibleEvent Event,
    FVariant OldValue,
    FVariant NewValue
)

Push an event from an accessible widget back to the platform layer.

Public function Virtual

void

 

RunInThread

(
    const TFunction< void()>& Function,
    bool bWaitForCompletion,
    ENamedThreads::Type Thread
)

Request a function to be run in a particular thread.

Public function

void

 

SetAccessibleEventDelegate

(
    const FAccessibleEvent& Delegate
)

Assign a function to be called whenever an accessible event is raised.

Public function

void

 

SetActive

(
    bool bActive
)

Notify the application to start or stop processing accessible messages from the platform layer.

Typedefs

Name

Description

FAccessibleEvent

A widget raised an event to pass to the native OS implementation.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss