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 위치이며, 새로운 위치가 없는 경우(예: QTabWidget 에 위젯이 없는 경우)에는 -1입니다.

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 위치에 있는 페이지가 표시되면 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 는 그중 하나를 표시합니다.

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 위치에 있는 페이지의 ‘이게 뭐죠?’ 도움말 텍스트를 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 를 반환합니다.