lib_ui/ui/widgets/menu/menu_action.h
Reza Bakhshi Laktasaraei 6042852edc feat(accessibility): add screen reader support for menu items
- Set Menu role to PopupMenu for proper accessibility tree structure
- Fire QAccessible::Focus event when menu items are selected so
  screen readers announce the focused item
- Skip separators and disabled items in initial keyboard selection
- Conditionally set focus policy on menu items only when a screen
  reader is active to avoid affecting sighted users
- Override key events on ItemBase to preserve keyboard navigation
  flow through Menu's existing delegate mechanism
- Report virtual PopupMenu child on submenu Action items so Qt's
  UIA bridge activates ExpandCollapsePattern for screen readers
2026-02-23 13:42:31 +04:00

80 lines
1.9 KiB
C++

// This file is part of Desktop App Toolkit,
// a set of libraries for developing nice desktop applications.
//
// For license and copyright information please follow this link:
// https://github.com/desktop-app/legal/blob/master/LEGAL
//
#pragma once
#include "ui/text/text.h"
#include "ui/widgets/menu/menu_item_base.h"
#include "styles/style_widgets.h"
class Painter;
namespace Ui::Menu {
class Action : public ItemBase {
public:
Action(
not_null<Menu*> parent,
const style::Menu &st,
not_null<QAction*> action,
const style::icon *icon,
const style::icon *iconOver);
QAccessible::Role accessibilityRole() override {
return QAccessible::MenuItem;
}
QString accessibilityName() override {
return _action->text();
}
int accessibilityChildCount() const override;
QAccessible::Role accessibilityChildRole() const override;
QAccessible::State accessibilityChildState(int index) const override;
[[nodiscard]] const style::Menu &st() const;
bool isEnabled() const override;
not_null<QAction*> action() const override;
void handleKeyPress(not_null<QKeyEvent*> e) override;
void setIcon(
const style::icon *icon,
const style::icon *iconOver = nullptr);
void setMarkedText(
TextWithEntities text,
QString shortcut,
const Text::MarkedContext &context = {});
protected:
void paintEvent(QPaintEvent *e) override;
QPoint prepareRippleStartPosition() const override;
QImage prepareRippleMask() const override;
int contentHeight() const override;
void paintBackground(QPainter &p, bool selected);
void paintText(Painter &p);
private:
void processAction();
void paint(Painter &p);
bool hasSubmenu() const;
Text::String _text;
QString _shortcut;
const not_null<QAction*> _action;
const style::Menu &_st;
const style::icon *_icon;
const style::icon *_iconOver;
// std::unique_ptr<ToggleView> _toggle;
int _textWidth = 0;
const int _height;
};
} // namespace Ui::Menu