QMainWindow Class

멤버 함수 문서

[explicit] QMainWindow::QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

주어진 parent 와 지정된 위젯 flags 으로 QMainWindow를 생성합니다.

QMainWindow는 Qt::Window 플래그 자체를 설정하므로 항상 최상위 위젯으로 생성됩니다.

[virtual noexcept] QMainWindow::~QMainWindow()

메인 창을 삭제합니다.

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget)

지정된 area 에 지정된 dockwidget 을 추가합니다.

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget, Qt::Orientation orientation)

orientation 에서 지정한 방향으로 주어진 area 에 dockwidget 을 추가합니다.

void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar)

이 기본 창에서 지정된 area 에 toolbar 을 추가합니다. toolbar 은 현재 도구 모음 블록의 끝(즉, 줄)에 배치됩니다. 기본 창에서 이미 toolbar 을 관리하고 있는 경우에는 도구 모음만 area 으로 이동합니다.

insertToolBar(), addToolBarBreak() 및 insertToolBarBreak()도 참조하세요 .

void QMainWindow::addToolBar(QToolBar *toolbar)

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

추가 도구 모음(Qt::TopToolBarArea, toolbar)을 호출하는 것과 동일합니다.

QToolBar *QMainWindow::addToolBar(const QString &title)

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

QToolBar 개체를 생성하고 창 제목을 title 으로 설정하여 상단 도구 모음 영역에 삽입합니다.

setWindowTitle()도 참조하세요 .

void QMainWindow::addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea)

존재하는 다른 모든 개체 뒤에 지정된 area 에 툴바 나누기를 추가합니다.

QWidget *QMainWindow::centralWidget() const

메인 창의 중앙 위젯을 반환합니다. 이 함수는 중앙 위젯이 설정되지 않은 경우 nullptr 을 반환합니다.

setCentralWidget()도 참조하세요 .

[override virtual protected] void QMainWindow::contextMenuEvent(QContextMenuEvent *event)

다시 구현합니다: QWidget::contextMenuEvent(QContextMenuEvent * 이벤트).

Qt::DockWidgetArea QMainWindow::corner(Qt::Corner corner) const

지정된 corner 을 차지하는 도크 위젯 영역을 반환합니다.

setCorner()도 참조하세요 .

[virtual] QMenu *QMainWindow::createPopupMenu()

메인 창에 있는 도구 모음과 도크 위젯에 대해 체크 가능한 항목이 포함된 팝업 메뉴를 반환합니다. 도구 모음과 독 위젯이 없는 경우 이 함수는 nullptr 을 반환합니다.

기본적으로 이 함수는 사용자가 일반적으로 도구 모음이나 독 위젯을 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 활성화할 때 기본 창에서 호출됩니다.

사용자 지정 팝업 메뉴를 만들려면 이 함수를 다시 구현하여 새로 만든 팝업 메뉴를 반환하세요. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.

addDockWidget(), addToolBar() 및 menuBar()도 참조하세요 .

Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const

dockwidget 에 대해 Qt::DockWidgetArea 를 반환합니다. dockwidget 이 기본 창에 추가되지 않은 경우 이 함수는 Qt::NoDockWidgetArea 을 반환합니다.

addDockWidget(), splitDockWidget() 및 Qt::DockWidgetArea 를참조하십시오 .

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

다시 구현합니다: QWidget::event(QEvent * 이벤트).

[signal] void QMainWindow::iconSizeChanged(const QSize &iconSize)

이 신호는 창에서 사용되는 아이콘의 크기가 변경될 때 발생합니다. 새 아이콘 크기는 iconSize 에 전달됩니다.

이 신호를 다른 컴포넌트에 연결하여 애플리케이션의 일관된 모양을 유지할 수 있습니다.

setIconSize()도 참조하세요 .

void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar)

before 툴바가 차지하고 있는 영역에 toolbar 을 삽입하여 그 앞에 표시되도록 합니다. 예를 들어 일반적인 왼쪽에서 오른쪽 레이아웃 작업에서 이는 가로 툴바 영역에서 before 으로 지정된 툴바의 왼쪽에 toolbar 이 표시됨을 의미합니다.

insertToolBarBreak(), addToolBar() 및 addToolBarBreak()도 참조하세요 .

void QMainWindow::insertToolBarBreak(QToolBar *before)

before 으로 지정된 도구 모음 앞에 도구 모음 나누기를 삽입합니다.

QMenuBar *QMainWindow::menuBar() const

메인 창의 메뉴 모음을 반환합니다. 이 함수는 메뉴 표시줄이 없는 경우 빈 메뉴 표시줄을 생성하여 반환합니다.

Mac 애플리케이션의 모든 창에서 하나의 메뉴 모음을 공유하려는 경우 여기에서 생성된 메뉴 모음은 QMainWindow 을 부모로 가지므로 이 함수를 사용하여 메뉴 모음을 만들지 마세요. 대신 부모가 없는 메뉴 모음을 만든 다음 모든 Mac 창에서 공유할 수 있도록 해야 합니다. 이 방법으로 부모가 없는 메뉴 모음을 만듭니다:

QMenuBar *menuBar = new QMenuBar(nullptr);

setMenuBar()도 참조하세요 .

QWidget *QMainWindow::menuWidget() const

메인 창의 메뉴 표시줄을 반환합니다. 메뉴 표시줄이 아직 구성되지 않은 경우 이 함수는 null을 반환합니다.

setMenuWidget()도 참조하세요 .

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

기본 창 레이아웃에서 dockwidget 을 제거하고 숨깁니다. dockwidget 링크는 삭제되지 않습니다.

void QMainWindow::removeToolBar(QToolBar *toolbar)

기본 창 레이아웃에서 toolbar 을 제거하고 숨깁니다. toolbar 링크는 삭제되지 않습니다.

void QMainWindow::removeToolBarBreak(QToolBar *before)

before 으로 지정된 도구 모음 앞에 이전에 삽입된 도구 모음 나누기를 제거합니다.

void QMainWindow::resizeDocks(const QList<QDockWidget *> &docks, const QList<int> &sizes, Qt::Orientation orientation)

목록 docks 의 도크 위젯 크기를 sizes 목록의 해당 크기(픽셀)로 조정합니다. orientation 이 Qt::Horizontal 인 경우 너비를 조정하고, 그렇지 않으면 도크 위젯의 높이를 조정합니다. 최대 크기와 최소 크기를 준수하도록 크기가 조정되며 QMainWindow 자체의 크기는 조정되지 않습니다. 추가/누락된 공간은 크기의 상대적 가중치에 따라 위젯 간에 분배됩니다.

예시:

    resizeDocks({blueWidget, yellowWidget}, {20 , 40}, Qt::Horizontal);

파란색 위젯과 노란색 위젯이 같은 레벨에 중첩되어 있는 경우 노란색 위젯이 파란색 위젯보다 두 배 커지도록 크기가 조정됩니다.

일부 위젯이 탭으로 그룹화되어 있는 경우 그룹당 하나의 위젯만 지정해야 합니다. 목록에 없는 위젯은 제약 조건을 준수하기 위해 변경될 수 있습니다.

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

restoreState() 호출 이후에 생성된 경우 dockwidget 상태를 복원합니다. 상태가 복원된 경우 true 를 반환하고, 그렇지 않으면 false 을 반환합니다.

restoreState() 및 saveState()도 참조하세요 .

bool QMainWindow::restoreState(const QByteArray &state, int version = 0)

이 메인창의 도구 모음 및 독 위젯의 state 을 복원합니다. 모서리 설정도 복원합니다. version 번호는 state 에 저장된 번호와 비교됩니다. 일치하지 않으면 메인창의 상태가 변경되지 않고 이 함수는 false 을 반환하고, 그렇지 않으면 상태가 복원되고 이 함수는 true 을 반환합니다.

QSettings 를 사용하여 저장한 지오메트리를 복원하려면 다음과 같은 코드를 사용할 수 있습니다:

void MainWindow::readSettings()
{
    QSettings settings("MyCompany", "MyApp");
    restoreGeometry(settings.value("myWidget/geometry").toByteArray());
    restoreState(settings.value("myWidget/windowState").toByteArray());
}

saveState(), QWidget::saveGeometry(), QWidget::restoreGeometry() 및 restoreDockWidget()도 참조하세요 .

QByteArray QMainWindow::saveState(int version = 0) const

이 메인창의 도구 모음 및 독 위젯의 현재 상태를 저장합니다. 여기에는 setCorner()로 설정할 수 있는 모서리 설정이 포함됩니다. version 번호는 데이터의 일부로 저장됩니다.

objectName 속성은 각 QToolBar 및 QDockWidget 을 식별하는 데 사용됩니다. 이 속성이 추가하는 QToolBar 및 QDockWidget 각각에 대해 고유한지 확인해야 합니다. QMainWindow

저장된 상태를 복원하려면 반환 값과 version 번호를 restoreState()에 전달합니다.

창이 닫힐 때 지오메트리를 저장하려면 다음과 같은 닫기 이벤트를 구현할 수 있습니다:

void MyMainWindow::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    settings.setValue("windowState", saveState());
    QMainWindow::closeEvent(event);
}

restoreState(), QWidget::saveGeometry() 및 QWidget::restoreGeometry()도 참조하세요 .

void QMainWindow::setCentralWidget(QWidget *widget)

지정된 widget 을 메인 창의 중앙 위젯으로 설정합니다.

참고: QMainWindow 은 widget 포인터의 소유권을 가져와 적절한 시점에 삭제합니다.

centralWidget()도 참조하세요 .

void QMainWindow::setCorner(Qt::Corner corner, Qt::DockWidgetArea area)

지정된 도크 위젯 area 이 지정된 corner 을 차지하도록 설정합니다.

corner()도 참조하세요 .

void QMainWindow::setMenuBar(QMenuBar *menuBar)

메인 창의 메뉴 표시줄을 menuBar 로 설정합니다.

참고: QMainWindow 은 menuBar 포인터의 소유권을 가져와 적절한 시점에 포인터를 삭제합니다.

menuBar()도 참조하세요 .

void QMainWindow::setMenuWidget(QWidget *menuBar)

메인 창의 메뉴 표시줄을 menuBar 로 설정합니다.

QMainWindow menuBar 포인터의 소유권을 가져와 적절한 시점에 삭제합니다.

menuWidget()도 참조하세요 .

void QMainWindow::setStatusBar(QStatusBar *statusbar)

기본 창의 상태 표시줄을 statusbar 로 설정합니다.

상태 표시줄을 nullptr 로 설정하면 기본 창에서 상태 표시줄이 제거됩니다. QMainWindow 은 statusbar 포인터의 소유권을 가져와 적절한 시점에 포인터를 삭제합니다.

statusBar()도 참조하세요 .

void QMainWindow::setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition)

지정된 도크 위젯 areas 의 탭 위치를 지정된 tabPosition 으로 설정합니다. 기본적으로 모든 도크 영역의 탭은 하단에 표시됩니다.

tabPosition() 및 setTabShape()도 참조하세요 .

void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation)

first 독 위젯이 차지하는 공간을 두 부분으로 분할하여 first 독 위젯을 첫 번째 부분으로 이동하고 second 독 위젯을 두 번째 부분으로 이동합니다.

orientation 은 공간을 분할하는 방법을 지정합니다: Qt::Horizontal 분할은 두 번째 도크 위젯을 첫 번째 도크 위젯의 오른쪽에 배치하고 Qt::Vertical 분할은 두 번째 도크 위젯을 첫 번째 도크 위젯 아래에 배치합니다.

참고: first 가 현재 탭 도킹 영역에 있는 경우 second 은 first 의 이웃이 아닌 새 탭으로 추가됩니다. 이는 단일 탭에는 하나의 도크 위젯만 포함할 수 있기 때문입니다.

참고: Qt::LayoutDirection 은 분할된 영역의 두 부분에 있는 도크 위젯의 순서에 영향을 줍니다. 오른쪽에서 왼쪽 레이아웃 방향을 활성화하면 도크 위젯의 배치가 반대로 바뀝니다.

tabifyDockWidget(), addDockWidget() 및 removeDockWidget()도 참조하세요 .

QStatusBar *QMainWindow::statusBar() const

메인 창의 상태 표시줄을 반환합니다. 이 함수는 상태 표시줄이 없는 경우 빈 상태 표시줄을 생성하여 반환합니다.

setStatusBar()도 참조하세요 .

QTabWidget::TabPosition QMainWindow::tabPosition(Qt::DockWidgetArea area) const

area 에 대한 탭 위치를 반환합니다.

setTabPosition() 및 tabShape()도 참조하세요 .

[signal] void QMainWindow::tabifiedDockWidgetActivated(QDockWidget *dockWidget)

이 신호는 탭을 선택하여 탭화된 도크 위젯이 활성화될 때 발생합니다. 활성화된 도크 위젯은 dockWidget 에 전달됩니다.

tabifyDockWidget() 및 tabifiedDockWidgets()도 참조하세요 .

QList<QDockWidget *> QMainWindow::tabifiedDockWidgets(QDockWidget *dockwidget) const

dockwidget 와 함께 탭화된 도크 위젯을 반환합니다.

tabifyDockWidget()도 참조하세요 .

void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second)

second 도크 위젯을 first 도크 위젯 위로 이동하여 메인 창에 탭으로 된 도크 영역을 만듭니다.

tabifiedDockWidgets()도 참조하세요 .

QWidget *QMainWindow::takeCentralWidget()

이 메인 창에서 중앙 위젯을 제거합니다.

제거된 위젯의 소유권은 호출자에게 전달됩니다.

Qt::ToolBarArea QMainWindow::toolBarArea(const QToolBar *toolbar) const

toolbar 에 대해 Qt::ToolBarArea 를 반환합니다. toolbar 이 기본 창에 추가되지 않은 경우 이 함수는 Qt::NoToolBarArea 을 반환합니다.

addToolBar(), addToolBarBreak() 및 Qt::ToolBarArea 를참조하십시오 .

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

toolbar 앞에 툴바 나누기가 있는지 여부를 반환합니다.

addToolBarBreak() 및 insertToolBarBreak()도 참조하세요 .

[signal] void QMainWindow::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

이 신호는 창에서 도구 버튼에 사용되는 스타일이 변경될 때 발생합니다. 새 스타일은 toolButtonStyle 에 전달됩니다.

이 신호를 다른 구성 요소에 연결하여 애플리케이션의 일관된 모양을 유지할 수 있습니다.

setToolButtonStyle()도 참조하세요 .