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)

지정된 area 에 orientation 에서 지정한 방향으로 dockwidget 를 추가합니다.

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

이 메인 창에서 지정된 area 에 toolbar 을 추가합니다. toolbar 은 현재 툴바 블록(즉, 줄)의 끝에 배치됩니다. 메인 창이 이미 toolbar 를 관리하고 있는 경우, 툴바를 area 로만 이동시킵니다.

insertToolBar(), addToolBarBreak(), insertToolBarBreak()도 참조하십시오 .

void QMainWindow::addToolBar(QToolBar *toolbar)

addToolBar(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 *event)를 재구현합니다.

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 *event)를 재구현합니다.

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

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

이 신호를 다른 컴포넌트에 연결하여 애플리케이션의 일관된 외관을 유지하는 데 도움을 줄 수 있습니다.

setIconSize()도 참조하십시오 .

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

toolbar 를 before 툴바가 차지하는 영역에 삽입하여, 해당 툴바보다 앞에 표시되도록 합니다. 예를 들어, 일반적인 좌우 방향 레이아웃 환경에서는, toolbar 가 수평 툴바 영역 내에서 before 로 지정된 툴바의 왼쪽에 표시됩니다.

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

파란색 위젯과 노란색 위젯이 같은 수준에 중첩되어 있는 경우, yellowWidget의 크기가 blueWidget의 두 배가 되도록 크기가 조정됩니다.

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

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()에 전달하십시오.

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

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 도크 위젯 위로 이동시켜, first 의 현재 위치에 탭이 있는 도크 영역을 생성합니다.

이 함수를 호출하기 전에 두 도크 위젯 모두 addDockWidget()을 사용하여 메인 창에 추가되어 있어야 하며, 둘 중 어느 것도 이미 탭 형태로 구성되어 있어서는 안 됩니다.

tabifiedDockWidgets() 및 addDockWidget()도 참조하십시오 .

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()도 참조하십시오 .