QDockWidget Class

멤버 함수 문서

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

부모가 ` parent `이고 창 플래그가 ` flags`인 `QDockWidget`을 생성합니다. 이 도크 위젯은 왼쪽 도크 위젯 영역에 배치됩니다.

[explicit] QDockWidget::QDockWidget(const QString &title, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

부모가 ` parent `이고 창 플래그가 ` flags`인 `QDockWidget`을 생성합니다. 이 도크 위젯은 왼쪽 도크 위젯 영역에 배치됩니다.

창 제목은 title 로 설정됩니다. 이 제목은 QDockWidget이 도킹되거나 도킹 해제될 때 사용됩니다. 또한 QMainWindow 에서 제공하는 컨텍스트 메뉴에서도 사용됩니다.

setWindowTitle()도 참조하십시오 .

[virtual noexcept] QDockWidget::~QDockWidget()

도크 위젯을 제거합니다.

[signal] void QDockWidget::allowedAreasChanged(Qt::DockWidgetAreas allowedAreas)

이 신호는 allowedAreas 속성이 변경될 때 발생합니다. allowedAreas 매개변수는 해당 속성의 새로운 값을 반환합니다.

[override virtual protected] void QDockWidget::changeEvent(QEvent *event)

QWidget::changeEvent(QEvent *event)를 재구현합니다.

[override virtual protected] void QDockWidget::closeEvent(QCloseEvent *event)

QWidget::closeEvent(QCloseEvent *event)를 재구현합니다.

[signal] void QDockWidget::dockLocationChanged(Qt::DockWidgetArea area)

이 신호는 도크 위젯이 다른 도크 area 로 이동하거나, 현재 도크 영역 내의 다른 위치로 이동할 때 발생합니다. 이는 도크 위젯이 프로그래밍 방식으로 이동되거나 사용자가 드래그하여 새로운 위치로 옮길 때 발생합니다.

dockLocation() 및 setDockLocation()도 참조하십시오 .

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

QWidget::event(QEvent *event)를 재구현합니다.

[signal] void QDockWidget::featuresChanged(QDockWidget::DockWidgetFeatures features)

이 신호는 features 속성이 변경될 때 발생합니다. features 매개변수는 해당 속성의 새로운 값을 반환합니다.

[virtual protected] void QDockWidget::initStyleOption(QStyleOptionDockWidget *option) const

option 를 QDockWidget 에 있는 값들로 초기화합니다. 이 방법은 하위 클래스에서 QStyleOptionDockWidget 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.

QStyleOption::initFrom()도 참조하십시오 .

bool QDockWidget::isAreaAllowed(Qt::DockWidgetArea area) const

이 도크 위젯을 지정된 ` area`에 배치할 수 있는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

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

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

[since 6.9] void QDockWidget::setDockLocation(Qt::DockWidgetArea area)

이 도크 위젯을 area 에 할당합니다. 다른 도크 위치에 도킹되어 있는 경우, area 로 이동합니다. 플로팅 상태이거나 플로팅 탭의 일부인 경우, 다음에 setFloating(false)를 호출하면 area 에 도킹됩니다.

이 함수는 Qt 6.9에서 도입되었습니다.

dockLocation() 및 dockLocationChanged()도 참조하십시오 .

void QDockWidget::setTitleBarWidget(QWidget *widget)

도크 위젯의 제목 표시줄로 임의의 widget 를 설정합니다. widget 가 nullptr 인 경우, 도크 위젯에 이전에 설정된 사용자 정의 제목 표시줄 위젯은 제거되지만 삭제되지는 않으며, 대신 기본 제목 표시줄이 사용됩니다.

제목 표시줄 위젯이 설정된 경우, QDockWidget 는 플로팅 상태일 때 네이티브 창 장식을 사용하지 않습니다.

사용자 정의 제목 표시줄을 구현할 때 참고할 몇 가지 팁은 다음과 같습니다:

• 제목 표시줄 위젯에서 명시적으로 처리되지 않는 마우스 이벤트는 ` QMouseEvent::ignore()`를 호출하여 무시해야 합니다. 그러면 이러한 이벤트는 ` QDockWidget ` 부모로 전달되며, 부모는 일반적인 방식으로 이를 처리합니다(예: 제목 표시줄을 드래그할 때 이동, 더블 클릭 시 도킹 및 도킹 해제 등).
• QDockWidget 에 DockWidgetVerticalTitleBar 가 설정되면, 타이틀 바 위젯은 그에 따라 위치가 조정됩니다. resizeEvent()에서 타이틀 바는 어떤 방향을 취해야 할지 확인해야 합니다:

  QDockWidget *dockWidget = qobject_cast<QDockWidget*>(parentWidget());
  if (dockWidget->features() & QDockWidget::DockWidgetVerticalTitleBar) {
      // I need to be vertical
  } else {
      // I need to be horizontal
  }

• 제목 표시줄 위젯은 유효한 QWidget::sizeHint() 및 QWidget::minimumSizeHint()을 가져야 합니다. 이 함수들은 제목 표시줄의 현재 방향을 고려해야 합니다.
• 도크 위젯에서 제목 표시줄을 제거할 수는 없습니다. 그러나 기본 생성된 QWidget 을 제목 표시줄 위젯으로 설정함으로써 유사한 효과를 얻을 수 있습니다.

위와 같이 qobject_cast()을 사용하면, 제목 표시줄 위젯은 상위 QDockWidget 에 대한 완전한 접근 권한을 갖게 됩니다. 따라서 사용자 동작에 반응하여 도킹 및 숨기기 등의 작업을 수행할 수 있습니다.

titleBarWidget() 및 DockWidgetVerticalTitleBar도 참조하십시오 .

void QDockWidget::setWidget(QWidget *widget)

도크 위젯의 위젯을 ` widget`로 설정합니다.

widget 가 추가될 때 도크 위젯이 표시되어 있다면, 명시적으로 show()를 호출해야 합니다.

이 함수를 호출하기 전에 widget 의 레이아웃을 추가해야 합니다. 그렇지 않으면 widget 가 표시되지 않습니다.

widget()도 참조하십시오 .

QWidget *QDockWidget::titleBarWidget() const

QDockWidget 에 설정된 사용자 정의 제목 표시줄 위젯을 반환하며, 사용자 정의 제목 표시줄이 설정되지 않은 경우에는 nullptr 를 반환합니다.

setTitleBarWidget()도 참조하십시오 .

QAction *QDockWidget::toggleViewAction() const

사용자가 이 도크 위젯을 표시하거나 닫을 수 있도록 메뉴 및 툴바에 추가할 수 있는 체크 가능한 액션을 반환합니다.

이 액션의 텍스트는 도크 위젯의 창 제목으로 설정됩니다.

QAction 객체는 QDockWidget 가 소유합니다. QDockWidget 가 소멸되면 이 객체는 자동으로 삭제됩니다.

QAction::text 및 QWidget::windowTitle도 참조하십시오 .

[signal] void QDockWidget::topLevelChanged(bool topLevel)

이 신호는 floating 속성이 변경될 때 발생합니다. topLevel 매개변수는 도크 위젯이 현재 플로팅 상태일 경우 true를, 그렇지 않을 경우 false를 반환합니다.

참조: isWindow() 함수.

[signal] void QDockWidget::visibilityChanged(bool visible)

이 신호는 도크 위젯이 ‘ visible ’(또는 보이지 않는 상태)가 될 때 발생합니다. 이는 위젯이 숨겨지거나 표시될 때뿐만 아니라, 탭이 있는 도크 영역에 도킹된 상태에서 해당 탭이 선택되거나 선택 해제될 때도 발생합니다.

QWidget *QDockWidget::widget() const

도크 위젯에 해당하는 위젯을 반환합니다. 이 함수는 위젯이 설정되지 않은 경우 0을 반환합니다.

setWidget()도 참조하십시오 .