C#: come rilevare se lo screen reader è in esecuzione?

Question

Come rilevare se lo screen reader è in esecuzione (JAWS)?

Come ho capito in .NET 4 possiamo usare AutomationInteropProvider.ClientsAreListening dallo spazio dei nomi System.Windows.Automation.Provider, ma cosa succede se devo farlo per .NET 2.0?

Ho provato a ispezionare il codice sorgente ClientsAreListening, chiama il metodo esterno RawUiaClientsAreListening dalla libreria UIAutomationCore.dll.

Avete qualche idea su come implementare il rilevamento JAWS in .NET 2.0?

Answer 1

Utilizzare SystemParametersInfo function passando un uiAction di SPI_GETSCREENREADER.

Sarà necessario utilizzare P/Invoke per questo, ad esempio:

internal class UnsafeNativeMethods 
{ 
    public const uint SPI_GETSCREENREADER = 0x0046; 

    [DllImport("user32.dll", SetLastError = true)] 
    [return: MarshalAs(UnmanagedType.Bool)] 
    public static extern bool SystemParametersInfo(uint uiAction, uint uiParam, ref bool pvParam, uint fWinIni); 
} 

public static class ScreenReader 
{ 
    public static bool IsRunning 
    { 
     get 
     { 
      bool returnValue = false; 
      if (!UnsafeNativeMethods.SystemParametersInfo(UnsafeNativeMethods.SPI_GETSCREENREADER, 0, ref returnValue, 0)) 
      { 
       throw new Win32Exception(Marshal.GetLastWin32Error(), "error calling SystemParametersInfo"); 
      } 
      return returnValue; 
     } 
    } 
} 

Questa è forse meglio che usare la proprietà ClientsAreListening come questa proprietà sembra di tornare vero per qualsiasi client di automazione, non solo screen reader.

Vedi anche:

• Using SystemParametersInfo from C# (SPI_GETSCREENREADER SPI_SETSCREENREADER) (Stack Overflow)
• INFO: How Clients and Servers Should Use SPI_SETSCREENREADER and SPI_GETSCREENREADER (Microsoft KB)

Si dovrebbe anche ascoltare il messaggio WM_SETTINGCHANGE per rilevare se uno screen reader inizia/interrompe l'esecuzione.

---

aggiornamento (in risposta ai commenti di BrendanMcK):

Anche se questo non viene mai esplicitamente documentata in altrettante parole, guardando la descrizione della bandiera penso che lo scopo di questo flag è relativamente chiara :

Determina se è in esecuzione un'utilità di revisione dello schermo. Un'utilità di revisione dello schermo indirizza le informazioni testuali a un dispositivo di output, ad esempio un sintetizzatore vocale o un display braille. Quando questo flag è impostato, un'applicazione dovrebbe fornire informazioni testuali in situazioni in cui altrimenti presenterebbe le informazioni graficamente.

Ciò sta dicendo è che le applicazioni impostare questo flag ogni volta che un'applicazione vuole l'interfaccia utente a comportarsi come se un lettore di schermo è in esecuzione, indipendentemente dal fatto o meno che l'applicazione è in realtà uno screen reader o no .

Le cose appropriate da fare in risposta a questo flag sono add text in order to "read" otherwise intuitive UI state to the user. Se sono necessarie modifiche radicali per rendere accessibile lo screen reader per l'interfaccia utente, è probabile che anche l'interfaccia utente non sia intuitiva per gli utenti e potrebbe probabilmente fare con un ripensamento.