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 * 이벤트).

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 * 이벤트).

[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)

지정된 index 에 있는 탭 위젯에 지정된 label 및 page 의 탭을 삽입하고 탭 표시줄에 삽입된 탭의 인덱스를 반환합니다. page 의 소유권은 QTabWidget 으로 전달됩니다.

레이블은 탭에 표시되며 탭 위젯의 구성에 따라 모양이 달라질 수 있습니다.

탭의 label 에 앰퍼샌드가 포함된 경우 앰퍼샌드 뒤에 오는 문자가 탭의 바로 가기로 사용됩니다(예: 레이블이 'Bro&wse'인 경우 Alt+W는 이 탭으로 초점을 이동하는 바로 가기가 됩니다).

index 이 범위를 벗어나면 탭이 단순히 추가됩니다. 그렇지 않으면 지정된 위치에 탭이 삽입됩니다.

이 함수를 호출하기 전에 QTabWidget 이 비어 있으면 새 페이지가 현재 페이지가 됩니다. 현재 인덱스보다 작거나 같은 인덱스에 새 탭을 삽입하면 현재 인덱스는 증가하지만 현재 페이지는 유지됩니다.

addTab()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

지정된 index 에 지정된 label, page, icon 로 탭 위젯을 삽입하고 탭 표시줄에 삽입된 탭의 인덱스를 반환합니다. 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 * 이벤트).

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

속성에 대한 액세스 함수를 다시 구현합니다: QWidget::minimumSizeHint.

탭 위젯에 적합한 최소 크기를 반환합니다.

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

다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).

페인트에 대한 응답으로 탭 위젯의 탭 바를 페인트합니다 event.

void QTabWidget::removeTab(int index)

이 위젯 스택에서 index 위치에 있는 탭을 제거합니다. 페이지 위젯 자체는 삭제되지 않습니다.

addTab() 및 insertTab()도 참조하세요 .

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

다시 구현합니다: QWidget::resizeEvent(QResizeEvent * 이벤트).

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 은 그 중 하나를 표시합니다.

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 이 참이면 index 위치에 있는 페이지가 표시되고, 그렇지 않으면 index 위치에 있는 페이지가 숨겨집니다. 페이지의 탭이 적절하게 다시 그려집니다.

isTabVisible()도 참조하세요 .

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

index 위치에 있는 페이지의 도움말 텍스트를 text 으로 설정합니다.

tabWhatsThis()도 참조하세요 .

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

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

[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 에 있는 탭 페이지를 반환합니다.