Qt GUI アプリケーションにおけるアクセシビリティに関するベストプラクティス

Qt GUIにおける QAccessibleTableInterface クラス

主な機能:

• テーブルの行と列の数
• 各セルの内容
• セルのヘッダーテキスト
• テーブルの選択範囲
• テーブルの属性 (ソート順序、編集可能かどうかなど)

実装方法:

1. QAccessibleTableInterface クラスを継承するクラスを作成します。
2. 必要な仮想関数をオーバーライドします。
3. QAccessible::registerAccessible() 関数を使用して、アクセシビリティオブジェクトを登録します。

#include <QtAccessible>

class MyTable : public QTableWidget, public QAccessibleTableInterface
{
  Q_OBJECT
public:
  MyTable(QWidget *parent = nullptr) : QTableWidget(parent) {}

  // QAccessibleTableInterface の仮想関数をオーバーライド
  int accessibleRowCount() const override { return rowCount(); }
  int accessibleColumnCount() const override { return columnCount(); }
  QAccessible::TableCell accessibleCellAt(int row, int column) const override {
    return QAccessible::TableCell(item(row, column)->text());
  }

  // ...
};

int main(int argc, char *argv[])
{
  QApplication app(argc, argv);

  MyTable table;
  table.resize(4, 4);

  // アクセシビリティオブジェクトを登録
  QAccessible::registerAccessible(&table);

  table.show();

  return app.exec();
}

• QAccessibleTableInterface クラスは、Qt 5 以降で使用できます。
• Qt Accessibility プラットフォームプラグインが必要です。

補足:

• スクリーンリーダーは、QAccessibleTableInterface クラスを使用してテーブルの内容を取得し、ユーザーに読み上げます。
• テーブルヘッダーやセルのツールチップも、アクセシビリティ情報として提供できます。
• アクセシビリティ機能を向上させるには、Qt Accessibility モジュールを使用することをお勧めします。

QAccessibleTableInterface クラスのサンプルコード

シンプルなテーブル

#include <QtAccessible>

class MyTable : public QTableWidget, public QAccessibleTableInterface
{
  Q_OBJECT
public:
  MyTable(QWidget *parent = nullptr) : QTableWidget(parent) {}

  // QAccessibleTableInterface の仮想関数をオーバーライド
  int accessibleRowCount() const override { return rowCount(); }
  int accessibleColumnCount() const override { return columnCount(); }
  QAccessible::TableCell accessibleCellAt(int row, int column) const override {
    return QAccessible::TableCell(item(row, column)->text());
  }

  // ...
};

int main(int argc, char *argv[])
{
  QApplication app(argc, argv);

  MyTable table;
  table.resize(4, 4);

  // アクセシビリティオブジェクトを登録
  QAccessible::registerAccessible(&table);

  table.show();

  return app.exec();
}

ヘッダーテキストを持つテーブル

#include <QtAccessible>

class MyTable : public QTableWidget, public QAccessibleTableInterface
{
  Q_OBJECT
public:
  MyTable(QWidget *parent = nullptr) : QTableWidget(parent) {}

  // QAccessibleTableInterface の仮想関数をオーバーライド
  int accessibleRowCount() const override { return rowCount(); }
  int accessibleColumnCount() const override { return columnCount(); }
  QAccessible::TableCell accessibleCellAt(int row, int column) const override {
    if (row == 0 || column == 0) {
      return QAccessible::TableCell(horizontalHeaderItem(column)->text(),
                                   verticalHeaderItem(row)->text());
    } else {
      return QAccessible::TableCell(item(row, column)->text());
    }
  }

  // ...
};

int main(int argc, char *argv[])
{
  QApplication app(argc, argv);

  MyTable table;
  table.resize(4, 4);

  // ヘッダーを設定
  table.setHorizontalHeaderLabels({"A", "B", "C", "D"});
  table.setVerticalHeaderLabels({"1", "2", "3", "4"});

  // アクセシビリティオブジェクトを登録
  QAccessible::registerAccessible(&table);

  table.show();

  return app.exec();
}

選択範囲を持つテーブル

#include <QtAccessible>

class MyTable : public QTableWidget, public QAccessibleTableInterface
{
  Q_OBJECT
public:
  MyTable(QWidget *parent = nullptr) : QTableWidget(parent) {}

  // QAccessibleTableInterface の仮想関数をオーバーライド
  int accessibleRowCount() const override { return rowCount(); }
  int accessibleColumnCount() const override { return columnCount(); }
  QAccessible::TableCell accessibleCellAt(int row, int column) const override {
    QAccessible::TableCell cell = item(row, column)->text();
    if (cell.isSelected()) {
      cell.setSelected(true);
    }
    return cell;
  }

  // ...
};

int main(int argc, char *argv[])
{
  QApplication app(argc, argv);

  MyTable table;
  table.resize(4, 4);

  // セルを選択
  table.selectItem(1, 2);

  // アクセシビリティオブジェクトを登録
  QAccessible::registerAccessible(&table);

  table.show();

  return app.exec();
}

ソートされたテーブル

#include <QtAccessible>

class MyTable : public QTableWidget, public QAccessibleTableInterface
{
  Q_OBJECT
public:
  MyTable(QWidget *parent = nullptr) : QTableWidget(parent) {}

  // QAccessibleTableInterface の仮想関数をオーバーライド
  int accessibleRowCount() const override { return rowCount(); }
  int accessibleColumnCount() const override { return columnCount(); }
  QAccessible::

QAccessibleTableInterface クラスを使用する以外の方法

QAccessibleTableModel クラスは、QAbstractTableModel クラスを継承し、アクセシビリティ情報を提供するための仮想関数を提供します。

カスタムアクセシビリティオブジェクトを作成する

QAccessible::registerAccessible() 関数を使用して、カスタムアクセシビリティオブジェクトを登録できます。

スクリーンリーダー固有の API を使用する

NVDA や JAWS などのスクリーンリーダーには、テーブルのアクセシビリティを提供するための独自の API があります。

各方法の利点と欠点:

QAccessibleTableInterface クラスを使用する:

• 利点:
  • Qt フレームワークに組み込まれているため、簡単に使用できます。
  • 多くのスクリーンリーダーでサポートされています。
• 欠点:
  • テーブルの構造と内容を完全に理解する必要があります。
  • 複雑なテーブルには適していない場合があります。

QAccessibleTableModel クラスを使用する:

• 利点:
  • テーブルモデルを抽象化するため、実装が簡単です。
  • 複雑なテーブルにも対応できます。
• 欠点:
  • Qt フレームワークに組み込まれていないため、追加の作業が必要です。
  • すべてのスクリーンリーダーでサポートされているわけではありません。

カスタムアクセシビリティオブジェクトを作成する:

• 利点:
  • テーブルのアクセシビリティを完全に制御できます。
  • すべてのスクリーンリーダーでサポートできます。
• 欠点:
  • 実装が複雑になる場合があります。
  • Qt フレームワークの知識が必要となります。

スクリーンリーダー固有の API を使用する:

• 利点:
• 欠点:
  • スクリーンリーダーごとに異なる API を使用する必要があります。

• シンプルなテーブルの場合は、QAccessibleTableInterface クラスを使用するのが最善です。
• 複雑なテーブルの場合は、QAccessibleTableModel クラスを使用するか、カスタムアクセシビリティオブジェクトを作成する必要があります。
• 特定のスクリーンリーダーで最適なアクセシビリティを提供したい場合は、そのスクリーンリーダー固有の API を使用する必要があります。