Qt Widgets: QTabBar::tabWhatsThis() 関数でタブに "What's This" ヘルプテキストを追加する方法

Qt Widgets の QTabBar::tabWhatsThis() 関数について

QTabBar::tabWhatsThis() 関数は、指定されたタブの "What's This" ヘルプテキストを取得します。 "What's This" ヘルプテキストは、ユーザーがタブにマウスカーソルを合わせたときに表示される短い説明テキストです。

関数宣言

QString QTabBar::tabWhatsThis(int index) const;

引数

• index: ヘルプテキストを取得したいタブのインデックス

戻り値

• 指定されたタブの "What's This" ヘルプテキスト

コード例

QTabBar tabBar;

// タブに "What's This" ヘルプテキストを設定
tabBar.setTabWhatsThis(0, "This is the first tab");
tabBar.setTabWhatsThis(1, "This is the second tab");

// マウスカーソルをタブに合わせたときに "What's This" ヘルプテキストを表示
QString whatsThisText = tabBar.tabWhatsThis(tabBar.currentIndex());

// ヘルプテキストを表示
statusBar()->showMessage(whatsThisText);

詳細

• QTabBar::tabWhatsThis() 関数は、Qt 4.1 で導入されました。
• タブに "What's This" ヘルプテキストを設定するには、QTabBar::setTabWhatsThis() 関数を使用します。

補足

• "What's This" ヘルプテキストは、ツールチップとは異なり、ウィンドウ内にポップアップウィンドウとして表示されます。
• "What's This" ヘルプテキストは、ユーザーインターフェースの各要素について、より詳細な情報を提供するために使用できます。

QTabBar::tabWhatsThis() 関数のサンプルコード

タブに "What's This" ヘルプテキストを設定する

QTabBar tabBar;

// タブに "What's This" ヘルプテキストを設定
tabBar.setTabWhatsThis(0, "これは最初のタブです");
tabBar.setTabWhatsThis(1, "これは2番目のタブです");

マウスカーソルをタブに合わせたときに "What's This" ヘルプテキストを表示する

QTabBar tabBar;

// マウスカーソルをタブに合わせたときに "What's This" ヘルプテキストを表示
QString whatsThisText = tabBar.tabWhatsThis(tabBar.currentIndex());

// ヘルプテキストを表示
statusBar()->showMessage(whatsThisText);

"What's This" ヘルプテキストを Qt のヘルプシステムと統合する

QTabBar tabBar;

// "What's This" ヘルプテキストを Qt のヘルプシステムと統合
tabBar.setWhatsThisHelpEnabled(true);

// ヘルプファイルを設定
QHelpEngine helpEngine("myHelp.qhc");
tabBar.setHelpEngine(&helpEngine);

// タブに "What's This" ヘルプテキストを設定
tabBar.setTabWhatsThis(0, "This is the first tab");
tabBar.setTabWhatsThis(1, "This is the second tab");

タブにカスタム "What's This" ウィジェットを表示する

QTabBar tabBar;

// タブにカスタム "What's This" ウィジェットを表示
QWidget *whatsThisWidget = new QWidget;
whatsThisWidget->setWindowTitle("What's This?");
whatsThisWidget->setLayout(new QVBoxLayout);
whatsThisWidget->layout()->addWidget(new QLabel("This is a custom What's This widget"));

tabBar.setTabWhatsThis(0, whatsThisWidget);

QTabBar::tabWhatsThis() 関数の代替方法

QToolTip::showText() 関数を使用する

QTabBar tabBar;

// タブにツールチップを設定
tabBar.setToolTip(0, "This is the first tab");
tabBar.setToolTip(1, "This is the second tab");

// マウスカーソルをタブに合わせたときにツールチップを表示
QPoint pos = tabBar.mapFromGlobal(QCursor::pos());
int index = tabBar.tabAt(pos);
if (index >= 0) {
  QToolTip::showText(pos, tabBar.toolTip(index));
}

QWidget::whatsThis() 関数をオーバーライドする

class MyTabBar : public QTabBar {
 public:
  MyTabBar(QWidget *parent = nullptr) : QTabBar(parent) {}

  QString whatsThis() const override {
    int index = currentIndex();
    if (index >= 0) {
      return tabWhatsThis(index);
    } else {
      return QString();
    }
  }
};

// ...

MyTabBar tabBar;

// タブに "What's This" ヘルプテキストを設定
tabBar.setTabWhatsThis(0, "This is the first tab");
tabBar.setTabWhatsThis(1, "This is the second tab");

// マウスカーソルをタブに合わせたときに "What's This" ヘルプテキストを表示
QString whatsThisText = tabBar.whatsThis();

// ヘルプテキストを表示
statusBar()->showMessage(whatsThisText);

カスタム "What's This" ウィジェットを作成する

class MyWhatsThisWidget : public QWidget {
 public:
  MyWhatsThisWidget(QWidget *parent = nullptr) : QWidget(parent) {
    setWindowTitle("What's This?");
    setLayout(new QVBoxLayout);
    layout()->addWidget(new QLabel("This is a custom What's This widget"));
  }
};

// ...

QTabBar tabBar;

// タブにカスタム "What's This" ウィジェットを表示
MyWhatsThisWidget *whatsThisWidget = new MyWhatsThisWidget;

tabBar.setTabWhatsThis(0, whatsThisWidget);

これらの方法は、それぞれ異なる利点と欠点があります。

• QToolTip::showText() 関数は最も簡単な方法ですが、ツールチップは "What's This" ヘルプテキストよりも制限があります。
• QWidget::whatsThis() 関数をオーバーライドする方法は、より柔軟ですが、より複雑です。
• カスタム "What's This" ウィジェットを作成する方法は、最も柔軟な方法ですが、最も多くの作業が必要です。