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

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

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

option を、このQTabWidget の値で初期化します。この方法は、サブクラスが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 の位置にあるページが表示されている場合は true を返し、そうでない場合は false を返します。

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) を再実装します。

event へのペイント要求に応じて、タブウィジェットのタブバーを描画します。

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 が true の場合、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 を返します。