QTabWidget Class

メンバー関数ドキュメント

[explicit] QTabWidget::QTabWidget(QWidget *parent = nullptr)

parent を親とするタブウィジェットを構築します。

[virtual noexcept] QTabWidget::~QTabWidget()

タブウィジェットを破壊する。

int QTabWidget::addTab(QWidget *page, const QString &label)

与えられたpage とlabel を持つタブをタブウィジェットに追加し、タブバー内のタブのインデックスを返す。page の所有権はQTabWidget に渡される。

タブのlabel にアンパサンドが含まれている場合、アンパサンドに続く文字がタブのショートカットとして使用されます。例えば、ラベルが "Bro&wse" の場合、Alt+W がこのタブにフォーカスを移動させるショートカットになります。

insertTab()も参照してください 。

int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label)

これはオーバーロードされた関数です。

与えられたpage,icon,label のタブをタブウィジェットに追加し、タブバー内のタブのインデックスを返します。page の所有権はQTabWidget に渡されます。

この関数は addTab() と同じだが、icon が追加される。

[override virtual protected] void QTabWidget::changeEvent(QEvent *ev)

再実装：QWidget::changeEvent(QEvent *event)。

void QTabWidget::clear()

すべてのページを削除するが、削除はしない。この関数を呼び出すことは，タブ・ウィジェットが空になるまでremoveTab() を呼び出すことと同じです．

QWidget *QTabWidget::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

タブ・ウィジェットまたはnullptr のcorner に表示されているウィジェットを返します。

setCornerWidget()も参照してください 。

[signal] void QTabWidget::currentChanged(int index)

このシグナルは、現在のページインデックスが変更されるたびに発行される。パラメータは、新しい現在のページindex の位置、または新しいものがない場合は -1 です (例えば、QTabWidget にウィジェットがない場合など)。

currentWidget() およびcurrentIndexも参照してください 。

QWidget *QTabWidget::currentWidget() const

タブダイアログが現在表示しているページへのポインタを返します。タブダイアログは、この値が決して0にならないように最善を尽くします（しかし、十分に努力すれば、0になることもあります）。

currentIndex() およびsetCurrentWidget()も参照 。

[override virtual protected] bool QTabWidget::event(QEvent *ev)

再実装：QWidget::event(QEvent *event)。

[override virtual] bool QTabWidget::hasHeightForWidth() const

再実装：QWidget::hasHeightForWidth() const.

[override virtual] int QTabWidget::heightForWidth(int width) const

再インプリメント：QWidget::heightForWidth(int w) const.

int QTabWidget::indexOf(const QWidget *w) const

ウィジェットw が占めるページのインデックス位置を返すか、ウィジェットが見つからない場合は -1 を返します。

[virtual protected] void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const

QTabWidget の値でoption を初期化する。このメソッドは、サブクラスがQStyleOptionTabWidgetFrame を必要とするが、すべての情報を自分で入力したくない場合に便利です。

QStyleOption::initFrom() およびQTabBar::initStyleOption()も参照して ください。

int QTabWidget::insertTab(int index, QWidget *page, const QString &label)

指定されたlabel とpage を持つタブを、指定されたindex のタブウィジェットに挿入し、挿入されたタブのタブバーのインデックスを返す。page の所有権はQTabWidget に渡される。

ラベルはタブに表示され、タブ・ウィジェットの構成によって外観が異なる場合がある。

タブのlabel にアンパサンドが含まれている場合、アンパサンドの後に続く文字がタブのショートカットとして使用される。例えば、ラベルが「Bro&wse」の場合、Alt+Wがこのタブにフォーカスを移動するショートカットになる。

index が範囲外の場合、タブは単に追加される。そうでなければ、指定された位置に挿入される。

この関数が呼ばれる前にQTabWidget が空だった場合、新しいページが現在のページになる。現在のインデックス以下のインデックスに新しいタブを挿入すると、現在のインデックスがインクリメントされますが、現在のページは維持されます。

addTab()も参照してください 。

int QTabWidget::insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)

これはオーバーロードされた関数です。

指定されたlabel 、page 、icon のタブを、指定されたindex のタブウィジェットに挿入し、挿入されたタブのタブバーのインデックスを返す。page の所有権はQTabWidget に渡される。

この関数は、insertTab() と同じですが、icon が追加されています。

bool QTabWidget::isTabEnabled(int index) const

位置index のページが有効な場合はtrue を返し、そうでない場合はfalse を返す。

setTabEnabled() およびQWidget::isEnabled()も参照のこと 。

bool QTabWidget::isTabVisible(int index) const

位置index にあるページが表示されていれば真を返し、そうでなければ偽を返す。

setTabVisible()も参照 。

[override virtual protected] void QTabWidget::keyPressEvent(QKeyEvent *e)

再実装：QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual] QSize QTabWidget::minimumSizeHint() const

プロパティ:QWidget::minimumSizeHint のアクセス関数を再インプリメントします。

タブウィジェットの適切な最小サイズを返します。

[override virtual protected] void QTabWidget::paintEvent(QPaintEvent *event)

再実装：QWidget::paintEvent(QPaintEvent *event)。

paintevent に応答してタブウィジェットのタブバーをペイントします。

void QTabWidget::removeTab(int index)

位置index にあるタブをウィジェットのスタックから削除します。ページ・ウィジェット自体は削除されません。

addTab() およびinsertTab()も参照してください 。

[override virtual protected] void QTabWidget::resizeEvent(QResizeEvent *e)

再実装：QWidget::resizeEvent(QResizeEvent *event)。

void QTabWidget::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

指定されたwidget をタブウィジェットの指定されたcorner に表示するように設定する。ウィジェットのジオメトリは、ウィジェットのsizeHint() とstyle() に基づいて決定されます。

corner の水平要素のみが使用されます。

nullptr を渡すと、コーナーにウィジェットは表示されません。

以前に設定されたコーナーウィジェットは非表示になります。

ここで設定されたすべてのウィジェットは、他のコーナーウィジェット（またはnullptr ）を設定した後に別途ウィジェットを再保護しない限り、タブウィジェットが破棄されるときに削除されます。

注意: コーナー・ウィジェットは、North とSouth のタブ位置用に設計されています。他の方向では正しく動作しないことが知られています。

cornerWidget() とsetTabPosition()も参照してください 。

[slot] void QTabWidget::setCurrentWidget(QWidget *widget)

widget を現在のウィジェットにする。使用されるwidget は、このタブ・ウィジェットのページでなければなりません。

addTab(),setCurrentIndex(),currentWidget()も参照 。

[protected] void QTabWidget::setTabBar(QTabBar *tb)

ダイアログのQTabBar の見出しをタブバーtb で置き換えます。これはタブが追加される前に呼び出されなければならないことに注意してください。

tabBar()も参照してください 。

void QTabWidget::setTabEnabled(int index, bool enable)

もしenable が真なら、位置index のページが有効になり、そうでなければ位置index のページが無効になる。ページのタブは適切に再描画されます。

QTabWidget は、別のフラグを保持するのではなく、内部的に () を使用します。QWidget::setEnabled

無効化されたタブ/ページでも表示される可能性があることに注意。ページがすでに表示されている場合、QTabWidget はそれを隠さない。すべてのページが無効になっている場合、QTabWidget はそのうちの1つを表示する。

isTabEnabled() およびQWidget::setEnabled()も参照の こと。

void QTabWidget::setTabIcon(int index, const QIcon &icon)

index の位置にあるタブのicon を設定する。

tabIcon()も参照のこと 。

void QTabWidget::setTabText(int index, const QString &label)

index'のタブの位置にあるページの新しいlabel を定義します。

指定されたテキストにアンパサンド文字 ('&') が含まれている場合、ショートカットが自動的に作成されます。'&'に続く文字がショートカットキーとして使われます。以前のショートカットは上書きされ、テキストでショートカットが定義されていない場合はクリアされます。詳細はQShortcut のドキュメントを参照のこと（実際のアンパサンドを表示するには '&&' を使用する）。

tabText()も参照のこと 。

void QTabWidget::setTabToolTip(int index, const QString &tip)

ページのタブツールチップを位置index からtip に設定します。

tabToolTip()も参照 。

void QTabWidget::setTabVisible(int index, bool visible)

もしvisible がtrueなら、位置index のページが表示され、そうでなければ位置index のページが非表示になる。ページのタブは適切に再描画されます。

isTabVisible()も参照のこと 。

void QTabWidget::setTabWhatsThis(int index, const QString &text)

位置index にあるページの What's This ヘルプテキストをtext に設定します。

tabWhatsThis()も参照してください 。

[override virtual protected] void QTabWidget::showEvent(QShowEvent *)

再実装：QWidget::showEvent(QShowEvent *event)。

[override virtual] QSize QTabWidget::sizeHint() const

QWidget::sizeHint 。

QTabBar *QTabWidget::tabBar() const

現在のQTabBar を返す。

setTabBar()も参照 。

[signal] void QTabWidget::tabBarClicked(int index)

このシグナルは、index でユーザーがタブをクリックしたときに発せられる。

index はクリックされたタブを指し、カーソル下にタブがない場合は-1。

[signal] void QTabWidget::tabBarDoubleClicked(int index)

このシグナルは、ユーザがindex のタブをダブルクリックしたときに発せられる。

index はクリックされたタブのインデックスで、カーソル下にタブがない場合は-1です。

[signal] void QTabWidget::tabCloseRequested(int index)

このシグナルは、タブのクローズボタンがクリックされたときに発せられる。index は削除されるべきインデックスである。

setTabsClosable()も参照のこと 。

QIcon QTabWidget::tabIcon(int index) const

位置index にあるページのタブのアイコンを返します。

setTabIcon()も参照 。

[virtual protected] void QTabWidget::tabInserted(int index)

この仮想ハンドラは、新しいタブがindex の位置に追加または挿入された後に呼び出される。

tabRemoved()も参照のこと 。

[virtual protected] void QTabWidget::tabRemoved(int index)

この仮想ハンドラは、index の位置からタブが取り除かれた後に呼び出される。

tabInserted()も参照のこと 。

QString QTabWidget::tabText(int index) const

位置index にあるページのタブのラベルテキストを返します。

setTabText()も参照 。

QString QTabWidget::tabToolTip(int index) const

位置index にあるページのタブツールチップ、またはツールチップが設定されていない場合は空文字列を返します。

setTabToolTip()も参照 。

QString QTabWidget::tabWhatsThis(int index) const

位置index にあるページの What's This ヘルプ・テキストを返すか、ヘルプ・テキストが設定されていない場合は空文字列を返す。

setTabWhatsThis()も参照してください 。

QWidget *QTabWidget::widget(int index) const

インデックス位置index またはindex が範囲外の場合はnullptr のタブページを返す。