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

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

다시 구현합니다: QWidget::closeEvent(QCloseEvent * 이벤트).

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

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

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

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

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

이 신호는 features 속성이 변경될 때 발생합니다. features 매개 변수는 속성의 새 값을 제공합니다.

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

QDockWidget 의 값으로 option 을 초기화합니다. 이 메서드는 하위 클래스에 QStyleOptionDockWidget 이 필요하지만 모든 정보를 직접 채우고 싶지 않을 때 유용합니다.

QStyleOption::initFrom()도 참조하세요 .

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

이 도크 위젯을 주어진 area 에 배치할 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

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

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 매개 변수는 도크 위젯이 현재 플로팅 상태이면 참이고, 그렇지 않으면 거짓입니다.

isWindow()도 참조하세요 .

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

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

QWidget *QDockWidget::widget() const

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

setWidget()도 참조하세요 .