Fehlerbehebungsanleitung

Lösungen für häufige Probleme mit ControlNav.

Installationsprobleme

Windows Defender SmartScreen-Warnung

Problem: SmartScreen blockiert die Anwendung

Lösung:

1. Klicken Sie auf "Weitere Informationen" im Warndialog
2. Klicken Sie auf "Trotzdem ausführen"
3. Dies ist normal für neue Anwendungen ohne weitverbreitete Download-Historie

ControlNav startet nicht

Problem: Anwendung startet nicht

Lösung:

1. Stellen Sie sicher, dass Sie 64-Bit-Windows 10 oder später verwenden
2. Prüfen Sie, ob bereits eine andere Instanz läuft (im System Tray nachsehen)
3. Versuchen Sie, mit der rechten Maustaste zu klicken und "Als Administrator ausführen" auszuwählen

Tastenkombinationsprobleme

Tastenkombination funktioniert nicht

Problem: Strg+Alt+L aktiviert ControlNav nicht

Mögliche Ursachen und Lösungen:

1. Konfliktierende Anwendung

   • Eine andere Anwendung verwendet dieselbe Tastenkombination
   • Schließen Sie andere Anwendungen nacheinander, um den Konflikt zu identifizieren
   • Häufige Konflikte: Remote-Desktop-Tools, Makroprogramme, andere Barrierefreiheitssoftware

2. ControlNav läuft nicht

   • Prüfen Sie, ob das ControlNav-Symbol im System Tray ist
   • Falls nicht, starten Sie ControlNav

3. Tastenkombination durch Vollbildanwendung blockiert

   • Einige Vollbildanwendungen blockieren globale Tastenkombinationen
   • Versuchen Sie, in den Fenstermodus zu wechseln

Ändern der Tastenkombination

1. Klicken Sie mit der rechten Maustaste auf das System Tray-Symbol
2. Wählen Sie "Einstellungen"
3. Klicken Sie in das Tastenkombinations-Eingabefeld
4. Drücken Sie Ihre gewünschte Tastenkombination
5. Klicken Sie auf OK oder Übernehmen

Steuerelementlistenprobleme

Keine Steuerelemente gefunden

Problem: Steuerelementliste ist leer

Mögliche Ursachen:

1. Anwendung verwendet nicht unterstütztes UI-Framework

   • Einige Anwendungen unterstützen keine Windows UI Automation
   • Tkinter-Apps haben keine Barrierefreiheitsunterstützung
   • Java Swing-Apps benötigen aktivierte Java Access Bridge (JAB)
   • Siehe Anwendungskompatibilität für Details

2. Falsches Fenster ausgewählt

   • ControlNav hat einen Begrüßungsbildschirm oder Hintergrundfenster erfasst
   • Versuchen Sie, aus dem Hauptanwendungsfenster zu aktivieren

3. Administrative Anwendung

   • Anwendung läuft als Administrator, ControlNav nicht
   • Starten Sie ControlNav als Administrator neu

4. Defekter UIA-Baum

   • Einige Frameworks (wie wxPython) haben defekte UIA-Bäume
   • ControlNav v1.1.2+ enthält HWND-Fallback für diese Fälle
   • Stellen Sie sicher, dass Sie die neueste Version verwenden

Steuerelemente reagieren nicht auf Aktionen

Problem: Klicken/Fokussieren funktioniert nicht beim ausgewählten Steuerelement

Lösungen:

1. Anderen Aktionstyp ausprobieren

   • Einige Steuerelemente unterstützen kein Klicken
   • Versuchen Sie stattdessen Fokussieren oder Doppelklick

2. Benutzerdefinierte Steuerelementimplementierung

   • Anwendung hat möglicherweise nicht standardmäßige Steuerelementimplementierung
   • Versuchen Sie, Fokussieren zu verwenden, dann Tastatur zur Interaktion

3. Deaktiviertes Steuerelement

   • Steuerelement ist möglicherweise in der Anwendung deaktiviert
   • ControlNav zeigt alle Steuerelemente, einschließlich deaktivierter

Langsames Laden von Steuerelementen

Problem: Steuerelemente erscheinen erst nach langer Zeit

Erklärung:

• Große Anwendungen mit Hunderten von Steuerelementen benötigen länger zur Aufzählung
• ControlNav verwendet Lazy Loading - Steuerelemente erscheinen progressiv
• Sie können sofort mit dem Filtern beginnen, während mehr Steuerelemente geladen werden

Tipps:

• Tippen Sie im Suchfeld während Steuerelemente laden, um früh zu filtern
• Komplexe Anwendungen (wie Microsoft Office) haben möglicherweise viele Steuerelemente

Suchfilterprobleme

Filter funktioniert nicht

Problem: Eingabe filtert die Liste nicht

Lösung:

1. Stellen Sie sicher, dass der Fokus im Filterfeld ist (sollte standardmäßig Fokus haben)
2. Leeren Sie das Feld (Strg+A, dann Entf)
3. Versuchen Sie erneut zu tippen

Zu viele/zu wenige Ergebnisse

Problem: Filter zeigt unerwartete Ergebnisse

Tipps:

• Suche ist nicht groß-/kleinschreibungsabhängig
• Suche findet Teilwörter ("spei" findet "Speichern unter")
• Text- und Fenstersteuerelemente werden immer herausgefiltert

Screenreader-Probleme

Screenreader sagt Änderungen nicht an

Problem: JAWS/NVDA/Narrator sagt Auswahlen nicht an

Lösungen:

1. Screenreader neu starten

   • Beenden und starten Sie Ihren Screenreader neu
   • Versuchen Sie ControlNav erneut

2. Screenreader aktualisieren

   • Stellen Sie sicher, dass Sie die neueste Version haben
   • NVDA 2019.3 oder später empfohlen

3. Screenreader-Einstellungen prüfen

   • "Auswahlwechsel ansagen" aktivieren
   • "Listenelemente ansagen" aktivieren

Screenreader und erhöhte Anwendungen

Problem: ControlNav kann nicht auf Steuerelemente in Anwendungen zugreifen, die als Administrator laufen

Erklärung: Windows User Interface Privilege Isolation (UIPI) verhindert, dass nicht erhöhte Prozesse auf erhöhte Fenstersteuerelemente zugreifen.

Lösung: Führen Sie ControlNav als Administrator aus, um auf erhöhte Anwendungen zuzugreifen.

Dunkelmodus-Probleme

Dunkelmodus wird nicht angewendet

Problem: ControlNav erscheint im hellen Modus trotz dunklem Windows-Theme

Lösung:

1. Prüfen Sie Windows-Einstellungen → Personalisierung → Farben → "Standard-App-Modus auswählen"
2. Starten Sie ControlNav nach Änderung des Themes neu
3. Dunkelmodus erfordert Windows 10 Version 1809 oder später

Leistungsprobleme

ControlNav verwendet zu viel Speicher

Problem: Hohe Speichernutzung

Hinweis: ControlNav verwendet typischerweise weniger als 10 MB RAM. Wenn Sie höhere Nutzung sehen:

1. Schließen und öffnen Sie ControlNav neu
2. Melden Sie es, falls persistente hohe Speichernutzung auftritt

Einstellungsprobleme

Einstellungen werden nicht gespeichert

Problem: Änderungen im Einstellungsdialog bleiben nicht erhalten

Lösungen:

1. Auf OK oder Übernehmen klicken - Stellen Sie sicher, dass Sie auf OK oder Übernehmen klicken, nicht auf Abbrechen
2. Registrierungszugriff - Führen Sie ControlNav einmal als Administrator aus, um Registrierungsschlüssel zu erstellen
3. Einstellungen zurücksetzen - Verwenden Sie die Schaltfläche "Auf Standard zurücksetzen" und konfigurieren Sie neu

Autostart funktioniert nicht

Problem: ControlNav startet nicht mit Windows

Lösungen:

1. Einstellungen prüfen

   • Öffnen Sie den Einstellungsdialog
   • Verifizieren Sie, dass "Mit Windows starten" aktiviert ist
   • Klicken Sie auf OK zum Speichern

2. Registrierung verifizieren

   • Schlüssel: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
   • Wert: ControlNav sollte auf exe-Pfad zeigen

3. Windows-Autostart-Einstellungen

   • Windows-Einstellungen → Apps → Autostart
   • ControlNav finden und aktivieren

Hilfe erhalten

Haben Sie weiterhin Probleme?

1. GitHub-Issues prüfen

   • Suchen Sie nach bestehenden Issues für Ihr Problem
   • Jemand hat möglicherweise bereits eine Lösung gefunden

2. Bug melden

   • Erstellen Sie ein neues GitHub-Issue
   • Fügen Sie bei:
     • Windows-Version (führen Sie winver aus)
     • ControlNav-Version (aus Info-Dialog)
     • Screenreader-Name und -Version (falls zutreffend)
     • Zielanwendungsname
     • Schritte zur Reproduktion des Problems
     • Alle Fehlermeldungen

3. Support kontaktieren

   • Besuchen Sie die ControlNav-Website
   • Verwenden Sie das Kontaktformular für direkten Support

Nächste Schritte

• Installationsanleitung - Neuinstallation bei Bedarf
• Einstellungsreferenz - Einstellungen neu konfigurieren
• Tastenkombinationen - Tastenkombinationen überprüfen
• Funktionsübersicht - Anwendungskompatibilität prüfen