Qt GUI アプリケーションにおけるアクセシビリティ：QAccessibleTableInterface::selectedRows() の詳細解説

Qt GUIにおけるQAccessibleTableInterface::selectedRows()

この関数は以下の情報を提供します:

• 選択された行のインデックス番号
• 選択された行の数

QAccessibleTableInterface::selectedRows() の使い方:

1. QAccessibleTableInterface オブジェクトを取得します。これは、テーブルウィジェットなどのアクセシビリティインターフェースを実装するオブジェクトから取得できます。
2. selectedRows() メソッドを呼び出します。
3. メソッドは、選択された行のインデックス番号を含む QModelIndex オブジェクトのリストを返します。

例:

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// アクセシビリティインターフェースを取得
QAccessibleTableInterface *tableInterface = tableWidget->accessibleInterface();

// 選択された行のリストを取得
QModelIndexList selectedRows = tableInterface->selectedRows();

// 選択された行の数を出力
qDebug() << "Selected rows:" << selectedRows.count();

// 各選択された行のインデックス番号を出力
foreach (const QModelIndex &index, selectedRows) {
  qDebug() << "  " << index.row();
}

補足:

• QAccessibleTableInterface クラスには、他にもテーブル操作に関する様々なメソッドが用意されています。詳細は Qt ドキュメントを参照してください。
• スクリーンリーダーなどのアクセシビリティツールは、QAccessible インターフェースを使用して、アプリケーションのユーザーインターフェースとやり取りします。

QAccessibleTableInterface::selectedRows() のサンプルコード

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// アクセシビリティインターフェースを取得
QAccessibleTableInterface *tableInterface = tableWidget->accessibleInterface();

// 選択された行のリストを取得
QModelIndexList selectedRows = tableInterface->selectedRows();

// 選択された行の数を出力
qDebug() << "Selected rows:" << selectedRows.count();

// 各選択された行のインデックス番号を出力
foreach (const QModelIndex &index, selectedRows) {
  qDebug() << "  " << index.row();
}

複数のテーブルウィジェットの選択された行を取得する

// テーブルウィジェットのリストを取得
QList<QTableWidget *> tableWidgets = ...;

// 各テーブルウィジェットの選択された行を取得
foreach (QTableWidget *tableWidget, tableWidgets) {
  QAccessibleTableInterface *tableInterface = tableWidget->accessibleInterface();
  QModelIndexList selectedRows = tableInterface->selectedRows();

  // 選択された行の数を出力
  qDebug() << "Selected rows for " << tableWidget << ":" << selectedRows.count();

  // 各選択された行のインデックス番号を出力
  foreach (const QModelIndex &index, selectedRows) {
    qDebug() << "  " << index.row();
  }
}

選択された行の情報を取得する

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// アクセシビリティインターフェースを取得
QAccessibleTableInterface *tableInterface = tableWidget->accessibleInterface();

// 選択された行のリストを取得
QModelIndexList selectedRows = tableInterface->selectedRows();

// 各選択された行の情報を取得
foreach (const QModelIndex &index, selectedRows) {
  // 行のインデックス番号
  int row = index.row();

  // 行のテキスト
  QString text = tableWidget->model()->data(index, Qt::DisplayRole).toString();

  // その他の情報 (チェックボックスの状態など)

  // ...

  // 情報を出力
  qDebug() << "Row " << row << ":" << text;
}

スクリーンリーダーで選択された行を読み上げる

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// アクセシビリティインターフェースを取得
QAccessibleTableInterface *tableInterface = tableWidget->accessibleInterface();

// 選択された行のリストを取得
QModelIndexList selectedRows = tableInterface->selectedRows();

// スクリーンリーダーに読み上げる
foreach (const QModelIndex &index, selectedRows) {
  // 行のテキストを取得
  QString text = tableWidget->model()->data(index, Qt::DisplayRole).toString();

  // スクリーンリーダーに読み上げる
  QAccessible::announce

QAccessibleTableInterface::selectedRows() 以外の方法

QTableWidget::selectedIndexes()

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// 選択されたインデックスのリストを取得
QModelIndexList selectedIndexes = tableWidget->selectedIndexes();

// 選択された行のインデックス番号を取得
foreach (const QModelIndex &index, selectedIndexes) {
  if (index.column() == 0) {
    // 行のインデックス番号
    int row = index.row();

    // ...
  }
}

QItemSelectionModel::selectedRows()

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// 選択モデルを取得
QItemSelectionModel *selectionModel = tableWidget->selectionModel();

// 選択された行のリストを取得
QModelIndexList selectedRows = selectionModel->selectedRows();

// ...

独自のコード

上記の方法では不十分な場合、独自のコードを使用して選択された行を取得することもできます。

// テーブルウィジェットを取得
QTableWidget *tableWidget = ...;

// 選択された行のリストを取得
for (int row = 0; row < tableWidget->rowCount(); ++row) {
  if (tableWidget->isRowSelected(row)) {
    // ...
  }
}

QAccessibleTableInterface::selectedRows() は、アクセシビリティ機能に最適化されています。

QTableWidget::selectedIndexes() は、最もシンプルで効率的な方法です。

QItemSelectionModel::selectedRows() は、より柔軟な方法です。

独自のコード は、高度なカスタマイズが必要な場合に使用します。