QWidget Class

멤버 함수 문서

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

parent 의 자식인 위젯을 생성하며, 위젯 플래그는 f 로 설정됩니다.

parent 가 nullptr 인 경우, 새 위젯은 창이 됩니다. parent 가 다른 위젯인 경우, 이 위젯은 parent 내부의 자식 창이 됩니다. 새 위젯은 해당 parent 가 삭제되면 함께 삭제됩니다.

위젯 플래그 인수( f)는 일반적으로 0이지만, 창 프레임을 사용자 정의하기 위해 설정할 수 있습니다(즉, parent 는 반드시 nullptr 여야 함). 프레임을 사용자 정의하려면 window flags 중 하나와 비트별 OR 연산을 통해 생성된 값을 사용하십시오.

이미 표시된 위젯에 자식 위젯을 추가하는 경우, 자식 위젯을 표시하려면 명시적으로 show를 호출해야 합니다.

X11 버전의 Qt는 모든 시스템에서 스타일 플래그의 모든 조합을 지원하지 못할 수도 있습니다. 이는 X11 환경에서 Qt가 윈도우 매니저에만 요청할 수 있으며, 윈도우 매니저가 애플리케이션의 설정을 재정의할 수 있기 때문입니다. Windows에서는 Qt가 원하는 플래그를 자유롭게 설정할 수 있습니다.

windowFlags도 참조하십시오 .

[virtual noexcept] QWidget::~QWidget()

위젯을 삭제합니다.

먼저 이 위젯의 모든 자식 요소가 삭제됩니다. 이 위젯이 메인 위젯인 경우, 애플리케이션이 종료됩니다.

[virtual protected] void QWidget::actionEvent(QActionEvent *event)

위젯의 동작이 변경될 때마다, 지정된 event 와 함께 이 이벤트 핸들러가 호출됩니다.

addAction(), insertAction(), removeAction(), actions() 및 QActionEvent도 참조하십시오 .

QList<QAction *> QWidget::actions() const

이 위젯의 액션 목록(비어 있을 수도 있음)을 반환합니다.

contextMenuPolicy, insertAction() 및 removeAction()도 참조하십시오 .

void QWidget::activateWindow()

이 위젯을 포함하는 최상위 위젯을 활성 창으로 설정합니다.

활성 창이란 키보드 입력 포커스를 가지고 있는, 화면에 표시된 최상위 창을 말합니다.

이 함수는 최상위 창의 제목 표시줄을 마우스로 클릭하는 것과 동일한 작업을 수행합니다. X11 환경에서는 결과에 따라 창 관리자에 따라 달라집니다. 창이 최상위에 배치되도록 하려면 raise()도 호출해야 합니다. 창이 표시되어 있어야 하며, 그렇지 않으면 activateWindow()는 아무런 효과도 없습니다.

Windows에서, 애플리케이션이 현재 활성 상태가 아닐 때 이 함수를 호출하면 해당 창을 활성 창으로 만들지는 않습니다. 대신, 창에 어떤 변화가 있었음을 나타내기 위해 작업 표시줄 항목의 색상을 변경합니다. 이는 Microsoft가 애플리케이션이 사용자가 다른 애플리케이션에서 현재 수행 중인 작업을 방해하는 것을 허용하지 않기 때문입니다.

isActiveWindow(), window() 및 show()도 참조하십시오 .

void QWidget::addAction(QAction *action)

action 액션을 이 위젯의 액션 목록에 추가합니다.

모든 QWidget에는 QAction목록이 있습니다. 그러나 이 목록은 그래픽적으로 다양한 방식으로 표현될 수 있습니다. QAction 목록( actions() 함수가 반환하는 값)의 기본 용도는 컨텍스트 QMenu 를 생성하는 것입니다.

QWidget 에는 각 액션이 하나씩만 포함되어야 하며, 이미 존재하는 액션을 추가하더라도 해당 액션이 위젯에 두 번 포함되지는 않습니다.

action 의 소유권은 이 QWidget 로 이전되지 않습니다.

removeAction(), insertAction(), actions() 및 QMenu도 참조하십시오 .

이 편의 함수들은 “ text ”라는 텍스트, “ icon ”라는 아이콘, 그리고 “ shortcut ”라는 바로가기(있는 경우)를 가진 새로운 액션을 생성합니다.

이 함수들은 새로 생성된 액션을 위젯의 액션 목록에 추가하고, 해당 액션을 반환합니다.

QWidget 반환된 QAction 의 소유권을 인수합니다.

이 함수들은 Qt 6.3에서 도입되었습니다.

이 편의 함수들은 텍스트 text, 아이콘 icon, 그리고 단축키 shortcut(있는 경우)을 가진 새로운 액션을 생성합니다.

액션의 ` triggered()` 신호는 마치 ` QObject::connect(action, &QAction::triggered, args...)`를 호출한 것처럼 연결되며, ` Qt::ConnectionType`를 포함하여 ` args`를 완벽하게 전달합니다.

이 함수는 새로 생성된 액션을 위젯의 액션 목록에 추가하고 이를 반환합니다.

QWidget 반환된 QAction 의 소유권을 인수합니다.

이 함수들은 Qt 6.3에서 도입되었습니다.

이 편의 함수는 텍스트 text, 아이콘 icon, 그리고 단축키 shortcut(있는 경우)를 가진 새로운 액션을 생성합니다.

이 액션의 triggered() 신호는 receiver 의 member 슬롯에 연결됩니다. 이 함수는 새로 생성된 액션을 위젯의 액션 목록에 추가한 후 이를 반환합니다.

QWidget 반환된 QAction 의 소유권을 인수합니다.

이 함수들은 Qt 6.3에서 도입되었습니다.

void QWidget::addActions(const QList<QAction *> &actions)

actions 작업을 이 위젯의 작업 목록에 추가합니다.

removeAction(), QMenu 및 addAction()도 참조하십시오 .

void QWidget::adjustSize()

위젯의 크기를 내용물에 맞게 조정합니다.

이 함수는 ` sizeHint()`가 유효한 경우(즉, 크기 힌트의 너비와 높이가 0 이상인 경우) 이를 사용합니다. 그렇지 않은 경우, 모든 자식 위젯을 포함하는 자식 사각형(모든 자식 위젯 사각형의 합집합)의 크기로 설정합니다.

창의 경우 화면 크기도 고려됩니다. ` sizeHint()`가 (200, 100)보다 작고 크기 정책이 ` expanding`인 경우, 창의 크기는 최소 (200, 100)이 됩니다. 창의 최대 크기는 화면 너비와 높이의 2/3입니다.

sizeHint() 및 childrenRect()도 참조하십시오 .

QPalette::ColorRole QWidget::backgroundRole() const

위젯의 배경 역할을 반환합니다.

배경 역할은 배경을 렌더링하는 데 사용되는 위젯의 ' palette ' 속성에 정의된 브러시를 지정합니다.

명시적인 배경 역할이 설정되지 않은 경우, 위젯은 상위 위젯의 배경 역할을 상속받습니다.

setBackgroundRole() 및 foregroundRole()도 참조하십시오 .

QBackingStore *QWidget::backingStore() const

이 위젯이 그려질 ` QBackingStore `을 반환합니다.

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

이 이벤트 핸들러는 상태 변화를 처리하도록 재구현할 수 있습니다.

이 이벤트에서 변경되는 상태는 제공된 event 를 통해 가져올 수 있습니다.

변경 이벤트에는 다음이 포함됩니다: QEvent::ToolBarChange, QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::WindowTitleChange, QEvent::IconTextChange, QEvent::ModifiedChange, QEvent::MouseTrackingChange, QEvent::ParentChange, QEvent::WindowStateChange, QEvent::LanguageChange, QEvent::LocaleChange, QEvent::LayoutDirectionChange, QEvent::ReadOnlyChange.

QWidget *QWidget::childAt(int x, int y) const

위젯의 좌표계에서 (x, y) 위치에 있는 표시된 자식 위젯을 반환합니다. 지정된 위치에 표시된 자식 위젯이 없는 경우, 이 함수는 nullptr 을 반환합니다.

QWidget *QWidget::childAt(const QPoint &p) const

위젯 자체의 좌표계에서 점 ( p )에 위치한 표시된 자식 위젯을 반환합니다.

[since 6.8] QWidget *QWidget::childAt(const QPointF &p) const

위젯 자체의 좌표계에서 점 p 에 위치한 표시된 자식 위젯을 반환합니다.

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

void QWidget::clearFocus()

위젯에서 키보드 입력 포커스를 제거합니다.

위젯이 활성 포커스를 가지고 있는 경우, 포커스를 잃었음을 알리기 위해 ` focus out event ` 이벤트가 이 위젯으로 전송됩니다.

이 위젯은 키보드 입력 포커스를 얻으려면 포커스 설정을 활성화해야 합니다. 즉, setFocusPolicy()를 호출해야 합니다.

hasFocus(), setFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), QApplication::focusWidget()도 참조하십시오 .

void QWidget::clearMask()

setMask() 함수로 설정된 모든 마스크를 제거합니다.

setMask()도 참조하십시오 .

[slot] bool QWidget::close()

이 위젯을 닫습니다. 위젯이 닫혀 있는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

먼저 위젯에 QCloseEvent 를 전송합니다. 위젯이 close 이벤트를 accepts 하면 위젯은 hidden 상태가 됩니다. 이벤트를 ignores 하면 아무 일도 일어나지 않습니다. QWidget::closeEvent()의 기본 구현은 close 이벤트를 수락합니다.

위젯에 Qt::WA_DeleteOnClose 플래그가 설정되어 있으면, 위젯도 삭제됩니다. 위젯이 표시되어 있든 아니든 상관없이 close 이벤트가 위젯에 전달됩니다.

QGuiApplication::lastWindowClosed() 신호는 Qt::WA_QuitOnClose 속성이 설정된 마지막 가시적인 기본 창(즉, 부모가 없는 창)이 닫힐 때 발생합니다. 기본적으로 이 속성은 스플래시 화면, 도구 창, 팝업 메뉴와 같은 일시적인 창을 제외한 모든 위젯에 설정되어 있습니다.

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

이 이벤트 핸들러는 Qt가 윈도우 시스템으로부터 최상위 위젯에 대한 창 닫기 요청을 수신할 때, 지정된 ` event `와 함께 호출됩니다.

기본적으로 이 이벤트는 수락되고 위젯이 닫힙니다. 이 함수를 재구현하여 위젯이 창 닫기 요청에 반응하는 방식을 변경할 수 있습니다. 예를 들어, 모든 이벤트에서 ` ignore()`를 호출하여 창이 닫히는 것을 방지할 수 있습니다.

메인 윈도우 애플리케이션은 일반적으로 이 함수를 재구현하여 사용자의 작업이 저장되었는지 확인하고, 닫기 전에 사용자의 동의를 구합니다.

event(), hide(), close() 및 QCloseEvent도 참조하십시오 .

QMargins QWidget::contentsMargins() const

contentsMargins 함수는 위젯의 콘텐츠 여백을 반환합니다.

setContentsMargins() 및 contentsRect()도 참조하십시오 .

QRect QWidget::contentsRect() const

위젯의 여백 안쪽 영역의 면적을 반환합니다.

setContentsMargins() 및 contentsMargins()도 참조하십시오 .

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

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯 컨텍스트 메뉴 이벤트를 수신할 수 있습니다.

이 핸들러는 위젯의 ` contextMenuPolicy `가 ` Qt::DefaultContextMenu`일 때 호출됩니다.

기본 구현은 컨텍스트 이벤트를 무시합니다. 자세한 내용은 QContextMenuEvent 문서를 참조하십시오.

event(), QContextMenuEvent 및 customContextMenuRequested()도 참조하십시오 .

[protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)

새로운 위젯 창을 생성합니다.

Qt 5에서는 ` window`, ` initializeWindow`, ` destroyOldWindow ` 매개변수가 무시됩니다. 대신 외부 창을 감싸는 ` QWindow `를 생성하려면 ` QWindow::fromWinId()`를 사용하고, 이를 ` QWidget::createWindowContainer()`에 전달하십시오.

createWindowContainer() 및 QWindow::fromWinId()도 참조하십시오 .

[static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

window 를 QWidget 기반 애플리케이션에 임베드할 수 있도록 하는 QWidget 를 생성합니다.

이 창 컨테이너는 parent 의 자식 요소로 생성되며, 창 플래그로 flags 가 지정됩니다.

창이 컨테이너에 내장되면, 컨테이너가 창의 기하학적 속성과 가시성을 제어합니다. 내장된 창에 대해 QWindow::setGeometry(), QWindow::show() 또는 QWindow::hide()을 명시적으로 호출하는 것은 권장되지 않습니다.

컨테이너는 window 의 소유권을 인수합니다. QWindow::setParent()를 호출하여 창 컨테이너에서 창을 제거할 수 있습니다.

창 컨테이너는 자식인 최상위 창에 네이티브 자식 창으로 연결됩니다. 창 컨테이너가 QAbstractScrollArea 또는 QMdiArea 의 자식으로 사용될 경우, 이 사용 사례에서 적절한 스태킹 및 클리핑이 이루어지도록 부모 체인에 있는 모든 위젯에 대해 native window 를 생성합니다. 윈도우 컨테이너에 대한 네이티브 윈도우를 생성하면 적절한 스태킹 및 클리핑이 가능해집니다. 이는 윈도우 컨테이너를 표시하기 전에 수행해야 합니다. 네이티브 자식 윈도우가 많은 애플리케이션에서는 성능 문제가 발생할 수 있습니다.

윈도우 컨테이너에는 다음과 같은 몇 가지 알려진 제한 사항이 있습니다:

• 겹침 순서: 내장된 창은 불투명한 상자로 위젯 계층 구조의 최상단에 겹쳐집니다. 여러 개의 겹치는 창 컨테이너 인스턴스 간의 겹침 순서는 정의되지 않습니다.
• 렌더링 통합: 윈도우 컨테이너는 ` QGraphicsProxyWidget`, ` QWidget::render()` 또는 이와 유사한 기능과 상호 운용되지 않습니다.
• 포커스 처리: 윈도우 컨테이너 인스턴스에 임의의 포커스 정책을 적용할 수 있으며, 이 인스턴스는 ` QWindow::requestActivate()` 호출을 통해 포커스를 윈도우로 위임합니다. 그러나 ` QWindow ` 인스턴스에서 일반 포커스 체인으로의 복귀 여부는 ` QWindow ` 인스턴스 구현 자체에 달려 있습니다. 또한, ` QWindow::requestActivate()`가 실제로 윈도우에 포커스를 부여하는지는 플랫폼에 따라 다릅니다.

  Qt Quick 기반 창을 임베드하는 경우, Qt는 탭 키를 누를 때 임베드된 QML 창으로 포커스가 이동하거나 창에서 벗어나도록 자동으로 보장하여, 창 컨테이너 체인 내의 다음 또는 이전 포커스 가능한 객체로 포커스가 이동할 수 있게 합니다.

• QWidget 기반 애플리케이션에서 많은 창 컨테이너 인스턴스를 사용하면 애플리케이션의 전반적인 성능이 크게 저하될 수 있습니다.

[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

이 신호는 위젯의 ` contextMenuPolicy ` 속성이 ` Qt::CustomContextMenu`로 설정되어 있고, 사용자가 위젯에서 컨텍스트 메뉴를 요청했을 때 발생합니다. 위치 ` pos `는 위젯이 수신하는 컨텍스트 메뉴 이벤트의 위치입니다. 일반적으로 이 위치는 위젯 좌표계로 표시됩니다. 이 규칙의 예외는 ` QAbstractScrollArea ` 및 그 하위 클래스로, 이들은 컨텍스트 메뉴 이벤트를 ` viewport()`의 좌표로 매핑합니다.

mapToGlobal(), QMenu 및 contextMenuPolicy도 참조하십시오 .

[protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)

윈도우 시스템 리소스를 해제합니다. ` destroyWindow `가 `true`인 경우 위젯 윈도우를 제거합니다.

destroy()는 모든 자식 위젯에 대해 재귀적으로 호출되며, ` destroyWindow ` 매개변수에 ` destroySubWindows `를 전달합니다. 하위 위젯의 소멸을 더 세밀하게 제어하려면, 먼저 하위 위젯을 선택적으로 소멸시키십시오.

이 함수는 일반적으로 QWidget 의 소멸자에서 호출됩니다.

[virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)

이 이벤트 핸들러는 드래그가 진행 중일 때 마우스가 이 위젯 영역에 진입하면 호출됩니다. 이 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

이 이벤트를 무시하면 위젯은 drag move events 를 수신하지 못합니다.

애플리케이션에서 드래그 앤 드롭 기능을 구현하는 방법에 대한 개요는 드래그 앤 드롭 문서를 참조하십시오.

QDrag 및 QDragEnterEvent도 참조하십시오 .

[virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)

이 이벤트 핸들러는 드래그가 진행 중일 때 마우스가 이 위젯을 벗어나면 호출됩니다. 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

애플리케이션에서 드래그 앤 드롭 기능을 구현하는 방법에 대한 개요는 드래그 앤 드롭 문서를 참조하십시오.

QDrag 및 QDragLeaveEvent도 참조하십시오 .

[virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)

이 이벤트 핸들러는 드래그가 진행 중일 때, 그리고 커서가 이 위젯에 진입하거나, 커서가 이 위젯 내에서 이동하거나, 이 위젯이 포커스를 가지고 있는 상태에서 키보드의 수정 키가 눌리는 등 다음 조건 중 하나가 발생할 때 호출됩니다. 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

애플리케이션에서 드래그 앤 드롭 기능을 구현하는 방법에 대한 개요는 드래그 앤 드롭 문서를 참조하십시오.

QDrag 및 QDragMoveEvent도 참조하십시오 .

[virtual protected] void QWidget::dropEvent(QDropEvent *event)

이 이벤트 핸들러는 이 위젯에 드래그된 항목이 놓일 때 호출됩니다. 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

애플리케이션에서 드래그 앤 드롭 기능을 구현하는 방법에 대한 개요는 드래그 앤 드롭 문서를 참조하십시오.

QDrag 및 QDropEvent도 참조하십시오 .

WId QWidget::effectiveWinId() const

위젯의 유효한 윈도우 시스템 식별자, 즉 네이티브 상위 위젯의 윈도우 시스템 식별자를 반환합니다.

위젯이 네이티브인 경우, 이 함수는 네이티브 위젯 ID를 반환합니다. 그렇지 않은 경우, 첫 번째 네이티브 부모 위젯, 즉 이 위젯을 포함하는 최상위 위젯의 창 ID가 반환됩니다.

참조: ` nativeParentWidget()` 함수.

void QWidget::ensurePolished() const

위젯과 그 자식 요소들이 ‘ QStyle ’를 통해 다듬어졌는지(즉, 적절한 글꼴과 색상 팔레트가 적용되었는지) 확인합니다.

QWidget 이 함수는 위젯이 완전히 생성된 후, 그러나 처음 표시되기 전에 호출됩니다. 어떤 작업을 수행하기 전에 위젯이 'polished' 상태인지 확인하고 싶다면 이 함수를 호출할 수 있습니다. 예를 들어, 위젯의 sizeHint() 재구현에서 올바른 글꼴 크기가 필요할 수 있습니다. 이 함수는 sizeHint()의 기본 구현에서 호출된다는 점에 유의하십시오.

폴리싱은 (기초 클래스와 하위 클래스의) 모든 생성자가 호출된 후에 이루어져야 하는 최종 초기화에 유용합니다.

위젯이 폴리싱될 때 일부 설정을 변경해야 하는 경우, ` event()`를 재구현하고 ` QEvent::Polish ` 이벤트 유형을 처리하십시오.

참고: 이 함수는 다른 const 함수(예: sizeHint())에서 호출될 수 있도록 const로 선언되었습니다.

event()도 참조하십시오 .

[virtual protected] void QWidget::enterEvent(QEnterEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여, ` event ` 매개변수를 통해 전달되는 위젯 진입 이벤트를 수신할 수 있습니다.

마우스 커서가 위젯 영역에 진입하면 위젯으로 이벤트가 전송됩니다.

leaveEvent(), mouseMoveEvent(), event()도 참조하십시오 .

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

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

이 함수는 주요 이벤트 핸들러로, event 이벤트를 처리합니다. 하위 클래스에서 이 함수를 재구현할 수 있지만, 대신 특화된 이벤트 핸들러 중 하나를 사용하는 것을 권장합니다.

키 누름 및 뗄 때 이벤트는 다른 이벤트와 다르게 처리됩니다. event()는 Tab 및 Shift+Tab을 확인하고 포커스를 적절하게 이동시키려고 시도합니다. 포커스를 이동할 위젯이 없거나(또는 누른 키가 Tab이나 Shift+Tab이 아닌 경우), event()는 keyPressEvent()를 호출합니다.

마우스 및 태블릿 이벤트 처리도 약간 특별합니다. 위젯이 enabled 인 경우에만 event()는 mousePressEvent()와 같은 특화된 핸들러를 호출하며, 그렇지 않으면 이벤트를 무시합니다.

이 함수는 이벤트가 인식된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다. 인식된 이벤트가 수락된 경우( QEvent::accepted 참조), 부모 위젯으로의 이벤트 전파와 같은 추가 처리는 중단됩니다.

closeEvent(), focusInEvent(), focusOutEvent(), enterEvent(), keyPressEvent(), keyReleaseEvent(), leaveEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveEvent(), paintEvent(), resizeEvent(), QObject::event() 및 QObject::timerEvent()도 참조하십시오.

[static] QWidget *QWidget::find(WId id)

창 식별자/핸들 id 을 가진 위젯에 대한 포인터를 반환합니다.

창 식별자의 유형은 기본이 되는 창 시스템에 따라 다르며, 실제 정의는 qwindowdefs.h 을 참조하십시오. 이 식별자를 가진 위젯이 없는 경우, nullptr 이 반환됩니다.

[virtual protected] void QWidget::focusInEvent(QFocusEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯에 대한 키보드 포커스 이벤트(포커스 수신)를 수신할 수 있습니다. 이 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

위젯은 일반적으로 포커스 이벤트를 수신하려면 ` setFocusPolicy()`를 ` Qt::NoFocus ` 이외의 값으로 설정해야 합니다. (단, 애플리케이션 프로그래머는 일반적으로 포커스를 허용하지 않는 위젯을 포함하여 어떤 위젯에서든 ` setFocus()`를 호출할 수 있습니다.)

기본 구현은 위젯을 업데이트합니다( focusPolicy()를 지정하지 않은 창은 제외).

focusOutEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event() 및 QFocusEvent도 참조하십시오 .

[protected] bool QWidget::focusNextChild()

Tab 에 적합한 새로운 위젯을 찾아 키보드 포커스를 부여하며, 새로운 위젯을 찾을 수 있으면 true 를 반환하고, 찾을 수 없으면 false를 반환합니다.

focusPreviousChild()도 참조하십시오 .

[virtual protected] bool QWidget::focusNextPrevChild(bool next)

Tab 및 Shift+Tab 키에 따라 키보드 포커스를 줄 새로운 위젯을 찾으며, 새로운 위젯을 찾으면 ` true `를 반환하고, 찾지 못하면 `false`를 반환합니다.

next 가 true인 경우 이 함수는 앞으로 검색하고, next 가 false인 경우 뒤로 검색합니다.

때로는 이 함수를 재구현해야 할 수도 있습니다. 예를 들어, 웹 브라우저는 “현재 활성화된 링크”를 앞뒤로 이동시키기 위해 이 함수를 재구현하고, “페이지”의 마지막 또는 첫 번째 링크에 도달했을 때만 focusNextPrevChild()를 호출할 수 있습니다.

자식 위젯은 부모 위젯에 대해 focusNextPrevChild()를 호출하지만, 포커스를 어디로 이동시킬지는 자식 위젯을 포함하는 창만이 결정합니다. 따라서 객체에 대해 이 함수를 재구현함으로써 모든 자식 위젯의 포커스 이동 경로를 제어할 수 있게 됩니다.

focusNextChild() 및 focusPreviousChild()도 참조하십시오 .

[virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)

이 이벤트 핸들러는 위젯에 대한 키보드 포커스 이벤트(포커스 상실)를 수신하기 위해 하위 클래스에서 재구현할 수 있습니다. 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

위젯은 일반적으로 포커스 이벤트를 수신하려면 setFocusPolicy()을 Qt::NoFocus 이외의 값으로 설정해야 합니다. (단, 애플리케이션 프로그래머는 일반적으로 포커스를 허용하지 않는 위젯을 포함하여 어떤 위젯에 대해서도 setFocus()을 호출할 수 있습니다.)

기본 구현은 위젯을 업데이트합니다( focusPolicy()를 지정하지 않은 창은 제외).

focusInEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event() 및 QFocusEvent도 참조하십시오 .

[protected] bool QWidget::focusPreviousChild()

Shift+Tab 에 적합한 새로운 위젯을 찾아 키보드 포커스를 부여하며, 새로운 위젯을 찾을 수 있으면 true 를 반환하고, 찾을 수 없으면 false를 반환합니다.

focusNextChild()도 참조하십시오 .

QWidget *QWidget::focusProxy() const

포커스 프록시를 반환하거나, 포커스 프록시가 없는 경우 ` nullptr `를 반환합니다.

setFocusProxy()도 참조하십시오 .

QWidget *QWidget::focusWidget() const

setFocus 가 호출된 이 위젯의 마지막 자식 위젯을 반환합니다. 최상위 위젯의 경우, 이 창이 활성화될 때 포커스를 받게 될 위젯입니다.

이는 현재 활성화된 창에서 포커스를 받고 있는 위젯을 반환하는 ` QApplication::focusWidget()` 함수와는 다릅니다.

QFontInfo QWidget::fontInfo() const

위젯의 현재 글꼴에 대한 글꼴 정보를 반환합니다. QFontInfo(widget->font()) 과 동일합니다.

font(), fontMetrics(), setFont()도 참조하십시오 .

QFontMetrics QWidget::fontMetrics() const

위젯의 현재 글꼴에 대한 글꼴 메트릭을 반환합니다. QFontMetrics(widget->font()) 와 동일합니다.

font(), fontInfo() 및 setFont()도 참조하십시오 .

QPalette::ColorRole QWidget::foregroundRole() const

전경 색상을 반환합니다.

전경 역할은 위젯의 ' palette '에서 전경을 그리는 데 사용되는 색상을 정의합니다.

명시적인 전경 역할이 설정되지 않은 경우, 이 함수는 배경 역할과 대비되는 역할을 반환합니다.

setForegroundRole() 및 backgroundRole()도 참조하십시오 .

[invokable] QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))

지정된 ` rectangle`로 제한된 픽스맵에 위젯을 렌더링합니다. 위젯에 자식 요소가 있는 경우, 해당 요소들도 적절한 위치에 그려집니다.

유효하지 않은 크기의 사각형이 지정된 경우(기본값), 위젯 전체가 그려집니다.

render() 및 QPixmap도 참조하십시오 .

void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

지정된 gesture 에 특정 flags 를 사용하여 위젯을 구독합니다.

ungrabGesture() 및 QGestureEvent도 참조하십시오 .

void QWidget::grabKeyboard()

키보드 입력을 가로챕니다.

이 위젯은 releaseKeyboard()이 호출될 때까지 모든 키보드 이벤트를 수신하며, 다른 위젯들은 키보드 이벤트를 전혀 수신하지 못합니다. 마우스 이벤트는 영향을 받지 않습니다. 마우스 이벤트를 가로채려면 grabMouse()을 사용하십시오.

포커스가 있는 위젯은 키보드 이벤트를 전혀 수신하지 않는다는 점을 제외하면 영향을 받지 않습니다. ` setFocus()`는 평소와 같이 포커스를 이동시키지만, 새로운 포커스 위젯은 ` releaseKeyboard()`가 호출된 후에만 키보드 이벤트를 수신합니다.

현재 다른 위젯이 키보드 입력을 확보하고 있는 경우, 해당 위젯의 확보 상태가 먼저 해제됩니다.

releaseKeyboard(), grabMouse(), releaseMouse(), focusWidget()도 참조하십시오 .

void QWidget::grabMouse()

마우스 입력을 포착합니다.

이 위젯은 ` releaseMouse()`가 호출될 때까지 모든 마우스 이벤트를 수신하며, 다른 위젯들은 마우스 이벤트를 전혀 수신하지 못합니다. 키보드 이벤트에는 영향을 미치지 않습니다. 키보드 입력을 가로채려면 ` grabKeyboard()`를 사용하십시오.

Qt를 사용할 때는 마우스를 캡처할 필요가 거의 없습니다. Qt가 마우스를 적절하게 캡처하고 해제하기 때문입니다. 특히, Qt는 마우스 버튼이 눌릴 때 마우스를 캡처하고 마지막 버튼이 풀릴 때까지 유지합니다.

releaseMouse(), grabKeyboard(), releaseKeyboard()도 참조하십시오 .

void QWidget::grabMouse(const QCursor &cursor)

마우스 입력을 확보하고 커서 모양을 변경합니다.

커서는 cursor 모양을 가지게 되며(마우스 포커스가 캡처된 동안), releaseMouse()이 호출될 때까지 이 위젯만이 마우스 이벤트를 수신하게 됩니다.

releaseMouse(), grabKeyboard(), releaseKeyboard() 및 setCursor()도 참조하십시오 .

int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)

지정된 context 내에서 지정된 key 시퀀스를 감시하는 바로가기를 Qt의 바로가기 시스템에 추가합니다. context 이 Qt::ApplicationShortcut 인 경우, 바로가기는 애플리케이션 전체에 적용됩니다. 그렇지 않은 경우, 이 위젯에만 국한되거나( Qt::WidgetShortcut), 창 자체에만 국한됩니다( Qt::WindowShortcut).

동일한 key 시퀀스가 여러 위젯에 의해 캡처된 경우, key 시퀀스가 발생하면 QEvent::Shortcut 이벤트가 해당 이벤트가 적용되는 모든 위젯으로 비결정적인 순서대로 전송되지만, ``ambiguous'' 플래그는 true로 설정됩니다.

releaseShortcut() 및 setShortcutEnabled()도 참조하십시오 .

QGraphicsEffect *QWidget::graphicsEffect() const

graphicsEffect 함수는 위젯의 그래픽 효과에 대한 포인터를 반환합니다.

위젯에 Graphical Effects가 없는 경우, ` nullptr `가 반환됩니다.

setGraphicsEffect()도 참조하십시오 .

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

그래픽 뷰 내의 해당 임베디드 위젯에 대한 프록시 위젯을 반환합니다. 그렇지 않은 경우 ` nullptr`를 반환합니다.

QGraphicsProxyWidget::createProxyForChildWidget() 및 QGraphicsScene::addWidget()도 참조하십시오 .

[virtual] bool QWidget::hasHeightForWidth() const

위젯의 선호 높이가 너비에 따라 달라지는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

[virtual] int QWidget::heightForWidth(int w) const

w 로 지정된 너비를 기준으로 이 위젯의 선호 높이를 반환합니다.

이 위젯에 레이아웃이 있는 경우, 기본 구현은 레이아웃의 선호 높이를 반환합니다. 레이아웃이 없는 경우, 기본 구현은 선호 높이가 너비에 의존하지 않음을 나타내는 -1을 반환합니다.

[slot] void QWidget::hide()

위젯을 숨깁니다. 이 함수는 ` setVisible(false)`와 동일합니다.

참조: hideEvent(), isHidden(), show(), setVisible(), isVisible(), close().

[virtual protected] void QWidget::hideEvent(QHideEvent *event)

이 이벤트 핸들러는 위젯 숨김 이벤트를 수신하기 위해 하위 클래스에서 재구현할 수 있습니다. 이벤트는 ` event ` 매개변수를 통해 전달됩니다.

숨김 이벤트는 위젯이 숨겨진 직후 해당 위젯으로 전송됩니다.

참고: 위젯은 윈도우 시스템에 의해 매핑 상태가 변경될 때 자발적인 표시 및 숨김 이벤트를 수신합니다. 예를 들어, 사용자가 창을 최소화하면 자발적인 숨김 이벤트가 발생하고, 창이 다시 복원되면 자발적인 표시 이벤트가 발생합니다. 자발적인 숨김 이벤트를 수신한 후에도 위젯은 isVisible()의 관점에서 여전히 표시된 것으로 간주됩니다.

visible, event() 및 QHideEvent도 참조하십시오 .

[override virtual protected] void QWidget::initPainter(QPainter *painter) const

painter 의 펜, 배경 및 글꼴을 지정된 위젯의 설정과 동일하게 초기화합니다. 이 함수는 QWidget 에서 페인터가 열릴 때 자동으로 호출됩니다.

[virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 입력 방식 조합 이벤트를 수신할 수 있습니다. 이 핸들러는 입력 방식의 상태가 변경될 때 호출됩니다.

사용자 정의 텍스트 편집 위젯을 생성할 때는 입력 방식 이벤트를 수신하기 위해 Qt::WA_InputMethodEnabled 창 속성을 ( setAttribute() 함수를 사용하여) 명시적으로 설정해야 한다는 점에 유의하십시오.

기본 구현은 event->ignore()를 호출하여 입력 방식 이벤트를 거부합니다. 자세한 내용은 QInputMethodEvent 문서를 참조하십시오.

event() 및 QInputMethodEvent도 참조하십시오 .

[virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const

이 메서드는 입력 위젯에만 적용됩니다. 입력 방식은 이 메서드를 사용하여 위젯의 일련의 속성을 조회함으로써, 주변 텍스트 처리 및 재변환과 같은 복잡한 입력 방식 작업을 지원할 수 있습니다.

query 어떤 속성을 조회할지 지정합니다.

inputMethodEvent(), QInputMethodEvent, QInputMethodQueryEvent 및 inputMethodHints도 참조하십시오 .

void QWidget::insertAction(QAction *before, QAction *action)

이 위젯의 액션 목록에 ‘ action ’ 액션을 ‘ before ’ 액션 바로 앞에 삽입합니다. ‘ before ’가 ‘ nullptr ’이거나 ‘ before ’가 이 위젯에 대해 유효한 액션이 아닌 경우, 해당 액션을 목록 끝에 추가합니다.

QWidget 에는 각 액션이 하나씩만 포함되어야 합니다.

removeAction(), addAction(), QMenu, contextMenuPolicy 및 actions()도 참조하십시오 .

void QWidget::insertActions(QAction *before, const QList<QAction *> &actions)

이 위젯의 동작 목록에 ‘ actions ’ 동작을 ‘ before ’ 동작 바로 앞에 삽입합니다. ‘ before ’이 ‘ nullptr ’인 경우, 또는 ‘ before ’이 이 위젯에 대해 유효한 동작이 아닌 경우, 해당 동작을 목록 끝에 추가합니다.

QWidget 에는 각 액션 유형별로 최대 하나씩만 포함될 수 있습니다.

removeAction(), QMenu, insertAction(), contextMenuPolicy도 참조하십시오 .

bool QWidget::isAncestorOf(const QWidget *child) const

이 위젯이 주어진 child 의 부모(또는 조부모 등 어떤 수준이든)이고, 두 위젯이 모두 동일한 창 내에 있는 경우 true 를 반환하며, 그렇지 않은 경우 false 를 반환합니다.

bool QWidget::isEnabledTo(const QWidget *ancestor) const

ancestor 가 활성화되면 이 위젯도 활성화될 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

이는 위젯 자체나 ancestor 까지( 은 제외)의 모든 상위 위젯 중 어느 것도 명시적으로 비활성화되지 않은 경우에 해당합니다.

isEnabledTo(0)는 이 위젯이나 그 조상 중 어느 하나라도 명시적으로 비활성화된 경우 false를 반환합니다.

여기서 ‘조상’이란 동일한 창 내의 부모 위젯을 의미합니다.

따라서 isEnabledTo(0)은 상위 창도 고려하는 isEnabled()과 달리, 이 위젯의 창에서 검색을 중단합니다.

setEnabled() 및 enabled도 참조하십시오 .

bool QWidget::isHidden() const

위젯이 숨겨져 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

숨겨진 위젯은 show()가 호출될 때만 표시됩니다. 부모 위젯이 표시될 때 자동으로 표시되지는 않습니다.

표시 여부를 확인하려면 대신 !isVisible()를 사용하십시오(느낌표에 유의하십시오).

isHidden()은 !isVisible()을 의미하지만, 위젯은 보이지 않으면서도 숨겨지지 않은 상태일 수 있습니다. 이는 보이지 않는 위젯의 자식인 위젯의 경우입니다.

위젯은 다음과 같은 경우 숨겨집니다:

• 독립된 창으로 생성된 경우,
• 보이는 위젯의 자식으로 생성된 경우,
• hide() 또는 setVisible(false)가 호출된 경우.

bool QWidget::isVisibleTo(const QWidget *ancestor) const

ancestor 가 표시될 경우 이 위젯이 보이게 된다면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

위젯 자체나 ancestor 을 제외한 모든 상위 부모가 명시적으로 숨겨지지 않은 경우 true를 반환합니다.

이 위젯이 화면상의 다른 창에 가려져 있더라도, 해당 창이나 위젯을 이동하면 물리적으로 표시될 수 있는 경우에는 이 함수는 여전히 true를 반환합니다.

isVisibleTo(0)는 isVisible()와 동일합니다.

show(), hide() 및 isVisible()도 참조하십시오 .

bool QWidget::isWindow() const

위젯이 독립적인 창인 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

창은 시각적으로 다른 위젯의 자식이 아니며, 일반적으로 프레임과 window title 을 갖는 위젯입니다.

창은 parent widget 을 가질 수 있습니다. 이 경우 해당 창은 부모와 그룹화되어, 부모가 삭제되면 함께 삭제되고, 부모가 최소화되면 함께 최소화되는 등의 동작을 보입니다. 또한, 창 관리자가 지원하는 경우, 부모와 공통된 작업 표시줄 항목을 갖게 됩니다.

QDialog 또한 QMainWindow 위젯은 생성자에서 부모 위젯이 지정된 경우라도 기본적으로 창으로 간주됩니다. 이 동작은 Qt::Window 플래그에 의해 지정됩니다.

window(), isModal(), parentWidget()도 참조하십시오 .

[virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯의 키 입력 이벤트를 수신할 수 있습니다.

위젯은 키 누름 이벤트를 수신하기 위해 처음에 setFocusPolicy()를 호출하여 포커스를 수락하고 포커스를 유지해야 합니다.

이 핸들러를 재구현하는 경우, 키에 대한 처리를 수행하지 않는다면 기본 클래스의 구현을 호출하는 것이 매우 중요합니다.

기본 구현은 사용자가 QKeySequence::Cancel 에 해당하는 키 조합(일반적으로 Escape 키)을 누르면 팝업 위젯을 닫습니다. 그렇지 않은 경우 이벤트는 무시되어 위젯의 부모가 이를 해석할 수 있도록 합니다.

QKeyEvent 는 isAccepted() == true로 시작하므로, QKeyEvent::accept()를 호출할 필요는 없습니다. 단, 키에 대한 처리를 하는 경우에는 기본 클래스의 구현을 호출하지 마십시오.

keyReleaseEvent(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event() 및 QKeyEvent도 참조하십시오 .

[virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 위젯의 키 릴리스 이벤트를 수신하기 위해 하위 클래스에서 재구현할 수 있습니다.

위젯이 키 릴리스 이벤트를 수신하려면 처음에 ` accept focus `를 호출하고, ` have focus `를 호출해야 합니다.

이 핸들러를 재구현하는 경우, 키에 대한 처리를 수행하지 않는다면 기본 클래스의 구현을 호출하는 것이 매우 중요합니다.

기본 구현은 이벤트를 무시하므로, 위젯의 부모가 이를 해석할 수 있습니다.

QKeyEvent 는 isAccepted() == true로 시작하므로, QKeyEvent::accept()를 호출할 필요가 없습니다. 단, 키에 대한 처리를 수행하는 경우에는 기본 클래스 구현을 호출하지 마십시오.

keyPressEvent(), QEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event() 및 QKeyEvent도 참조하십시오 .

[static] QWidget *QWidget::keyboardGrabber()

현재 키보드 입력을 점유하고 있는 위젯을 반환합니다.

이 애플리케이션에서 현재 키보드 입력을 확보하고 있는 위젯이 없는 경우, ` nullptr `가 반환됩니다.

grabMouse() 및 mouseGrabber()도 참조하십시오 .

QLayout *QWidget::layout() const

이 위젯에 설치된 레이아웃 관리자를 반환하며, 레이아웃 관리자가 설치되어 있지 않은 경우에는 ` nullptr `를 반환합니다.

레이아웃 관리자는 레이아웃에 추가된 위젯의 자식 요소들의 기하학적 크기를 설정합니다.

setLayout(), sizePolicy() 및 레이아웃 관리항목도 참조하십시오 .

[virtual protected] void QWidget::leaveEvent(QEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 ` event ` 매개변수를 통해 전달되는 위젯 이탈 이벤트를 수신할 수 있습니다.

마우스 커서가 위젯을 벗어나면 위젯으로 이탈 이벤트가 전송됩니다.

enterEvent(), mouseMoveEvent(), event()도 참조하십시오 .

[slot] void QWidget::lower()

위젯을 부모 위젯 스택의 맨 아래로 내려놓습니다.

이 호출 후에는 위젯이 겹치는 형제 위젯들 뒤에 위치하게 되어(따라서 가려지게 됩니다).

raise() 및 stackUnder()도 참조하십시오 .

[since 6.0] QPointF QWidget::mapFrom(const QWidget *parent, const QPointF &pos) const

위젯 좌표 pos 를 좌표계 parent 에서 이 위젯의 좌표계로 변환합니다. parent 는 nullptr 가 아니어야 하며, 호출하는 위젯의 부모여야 합니다.

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

mapTo(), mapFromParent(), mapFromGlobal(), underMouse()도 참조하십시오 .

QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const

[since 6.0] QPointF QWidget::mapFromGlobal(const QPointF &pos) const

전역 화면 좌표 pos 를 위젯 좌표로 변환합니다.

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

mapToGlobal(), mapFrom(), mapFromParent()도 참조하십시오 .

QPoint QWidget::mapFromGlobal(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapFromParent(const QPointF &pos) const

부모 위젯의 좌표 pos 를 위젯 좌표로 변환합니다.

위젯에 부모가 없는 경우 mapFromGlobal()과 동일합니다.

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

mapToParent(), mapFrom(), mapFromGlobal(), underMouse()도 참조하십시오 .

QPoint QWidget::mapFromParent(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapTo(const QWidget *parent, const QPointF &pos) const

위젯 좌표계 pos 를 좌표계 parent 로 변환합니다. parent 는 nullptr 가 아니어야 하며, 호출하는 위젯의 부모여야 합니다.

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

mapFrom(), mapToParent(), mapToGlobal(), underMouse()도 참조하십시오 .

QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const

[since 6.0] QPointF QWidget::mapToGlobal(const QPointF &pos) const

위젯 좌표 pos 를 전체 화면 좌표로 변환합니다. 예를 들어, ` mapToGlobal(QPointF(0,0)) `는 위젯의 왼쪽 상단 픽셀에 해당하는 전체 화면 좌표를 반환합니다.

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

mapFromGlobal(), mapTo(), mapToParent()도 참조하십시오 .

QPoint QWidget::mapToGlobal(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapToParent(const QPointF &pos) const

위젯 좌표 pos 를 상위 위젯의 좌표로 변환합니다.

위젯에 부모가 없는 경우 mapToGlobal()와 동일합니다.

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

mapFromParent(), mapTo(), mapToGlobal(), underMouse()도 참조하십시오 .

QPoint QWidget::mapToParent(const QPoint &pos) const

QRegion QWidget::mask() const

위젯에 현재 설정된 마스크를 반환합니다. 마스크가 설정되어 있지 않으면 반환 값은 빈 영역이 됩니다.

setMask(), clearMask(), QRegion::isEmpty()도 참조하십시오 .

[override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const

QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const를 재구현합니다.

가상 함수 QPaintDevice::metric()의 내부 구현입니다.

m 는 가져올 메트릭입니다.

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯에 대한 마우스 더블 클릭 이벤트를 수신할 수 있습니다.

기본 구현은 mousePressEvent()을 호출합니다.

mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(), event() 및 QMouseEvent도 참조하십시오 .

[static] QWidget *QWidget::mouseGrabber()

현재 마우스 입력을 포착하고 있는 위젯을 반환합니다.

이 애플리케이션에서 현재 마우스 입력을 확보하고 있는 위젯이 없는 경우, ` nullptr `가 반환됩니다.

grabMouse() 및 keyboardGrabber()도 참조하십시오 .

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯의 마우스 이동 이벤트를 수신할 수 있습니다.

마우스 추적 기능이 꺼져 있는 경우, 마우스 이동 이벤트는 마우스를 이동하는 동안 마우스 버튼이 눌려 있을 때만 발생합니다. 마우스 추적 기능이 켜져 있는 경우, 마우스 버튼이 눌려 있지 않아도 마우스 이동 이벤트가 발생합니다.

QMouseEvent::position()는 이 위젯을 기준으로 한 마우스 커서의 위치를 보고합니다. 누름 및 놓음 이벤트의 경우, 위치는 대개 마지막 마우스 이동 이벤트의 위치와 동일하지만, 사용자의 손이 떨리는 경우에는 다를 수 있습니다. 이는 Qt가 아닌 기본 윈도우 시스템의 기능입니다.

마우스가 이동하는 동안 즉시 툴팁을 표시하려면(예: QMouseEvent::position()을 사용하여 마우스 좌표를 가져와 툴팁으로 표시하는 경우), 앞서 설명한 대로 먼저 마우스 추적 기능을 활성화해야 합니다. 그런 다음 툴팁이 즉시 업데이트되도록 하려면, mouseMoveEvent() 구현에서 setToolTip() 대신 QToolTip::showText()을 호출해야 합니다.

setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent 및 Scribble 예제도참조하십시오 .

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯에 대한 마우스 누름 이벤트를 수신할 수 있습니다.

mousePressEvent() 내에서 새로운 위젯을 생성하는 경우, 기본이 되는 윈도우 시스템(또는 X11 윈도우 매니저), 위젯의 위치 및 기타 요인에 따라 mouseReleaseEvent()이 예상한 위치에서 종료되지 않을 수 있습니다.

기본 구현은 창 바깥쪽을 클릭할 때 팝업 위젯을 닫도록 되어 있습니다. 다른 위젯 유형의 경우 아무 작업도 수행하지 않습니다.

mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent 및 Scribble 예제도참조하십시오 .

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

event 이벤트에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯의 마우스 릴리스 이벤트를 수신할 수 있습니다.

mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent 및 Scribble 예제도참조하십시오 .

void QWidget::move(int x, int y)

이는 move(QPoint(x, y))에 해당합니다.

[virtual protected] void QWidget::moveEvent(QMoveEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 event 매개변수를 통해 전달되는 위젯 이동 이벤트를 수신할 수 있습니다. 위젯이 이 이벤트를 수신할 때, 위젯은 이미 새로운 위치에 있습니다.

이전 위치는 ` QMoveEvent::oldPos()`를 통해 확인할 수 있습니다.

resizeEvent(), event(), move() 및 QMoveEvent도 참조하십시오 .

[virtual protected] bool QWidget::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

eventType 이 특수 이벤트 핸들러는 하위 클래스에서 재구현하여, message 로 식별되는 네이티브 플랫폼 이벤트를 매개변수를 통해 수신할 수 있습니다.

이 함수를 재구현할 때, Qt가 이벤트를 처리하는 것을 중지하려면 true를 반환하고 result 를 설정하십시오. result 매개변수는 Windows에서만 의미가 있습니다. false를 반환하면 이 네이티브 이벤트는 Qt로 다시 전달되며, Qt는 해당 이벤트를 Qt 이벤트로 변환하여 위젯으로 보냅니다.

QAbstractNativeEventFilter도 참조하십시오 .

QWidget *QWidget::nativeParentWidget() const

이 위젯의 네이티브 부모, 즉 시스템 식별자를 가진 바로 위 조상 위젯을 반환하며, 네이티브 부모가 없는 경우에는 nullptr 를 반환합니다.

effectiveWinId()도 참조하십시오 .

QWidget *QWidget::nextInFocusChain() const

이 위젯의 포커스 체인에 있는 다음 위젯을 반환합니다.

previousInFocusChain()도 참조하십시오 .

void QWidget::overrideWindowFlags(Qt::WindowFlags flags)

윈도우 시스템에 알리지 않고 위젯의 창 플래그를 ` flags`로 설정합니다.

setWindowFlags()도 참조하십시오 .

[override virtual] QPaintEngine *QWidget::paintEngine() const

QPaintDevice::paintEngine() const를 재구현합니다.

위젯의 페인트 엔진을 반환합니다.

이 함수는 재구현 목적으로만 사용되도록 설계되었으므로, 사용자가 명시적으로 호출해서는 안 됩니다. 이 함수는 Qt 내부에서 호출되며, 기본 구현이 항상 유효한 포인터를 반환하는 것은 아닙니다.

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

이 이벤트 핸들러는 하위 클래스에서 재구현하여 ` event`를 통해 전달되는 페인트 이벤트를 수신할 수 있습니다.

페인트 이벤트는 위젯의 전체 또는 일부를 다시 그리도록 요청하는 것입니다. 이는 다음 이유 중 하나로 인해 발생할 수 있습니다:

• repaint() 또는 ` update()`가 호출되었거나,
• 위젯이 가려졌다가 다시 드러난 경우, 또는
• 그 밖의 여러 가지 이유.

많은 위젯은 요청을 받으면 전체 표면을 간단히 다시 그리지만, 일부 처리 속도가 느린 위젯은 요청된 영역만 그리도록 최적화해야 합니다: ` QPaintEvent::region()`. 이 속도 최적화는 이벤트 처리 중에 그리기가 해당 영역으로 제한되므로 결과에는 영향을 미치지 않습니다. 예를 들어, ` QListView `와 ` QTableView `가 이와 같은 방식을 사용합니다.

Qt는 또한 여러 페인트 이벤트를 하나로 병합하여 페인트 속도를 높이려고 시도합니다. update()가 여러 번 호출되거나 윈도우 시스템에서 여러 페인트 이벤트를 보낼 경우, Qt는 이러한 이벤트를 더 넓은 영역을 가진 하나의 이벤트로 병합합니다( QRegion::united() 참조). repaint() 함수는 이러한 최적화를 허용하지 않으므로, 가능한 한 update()를 사용할 것을 권장합니다.

페인트 이벤트가 발생하면 일반적으로 업데이트 영역은 이미 지워진 상태이므로, 위젯의 배경 위에 그리게 됩니다.

배경은 setBackgroundRole() 및 setPalette()을 사용하여 설정할 수 있습니다.

Qt 4.0부터는 QWidget 가 자동으로 더블 버퍼링 처리하므로, 깜빡임을 방지하기 위해 paintEvent() 내에서 더블 버퍼링 코드를 작성할 필요가 없습니다.

관련 항목: event(), repaint(), update(), QPainter, QPixmap, QPaintEvent 및 Analog Clock.

QWidget *QWidget::parentWidget() const

이 위젯의 상위 위젯을 반환하며, 상위 위젯이 없는 경우에는 ` nullptr `를 반환합니다.

QWidget *QWidget::previousInFocusChain() const

previousInFocusChain 함수는 이 위젯의 포커스 체인에서 바로 앞의 위젯을 반환합니다.

nextInFocusChain()함수도 참조하십시오 .

[slot] void QWidget::raise()

이 위젯을 부모 위젯 스택의 최상단으로 올립니다.

이 호출 후, 해당 위젯은 겹치는 모든 형제 위젯보다 시각적으로 앞에 표시됩니다.

lower() 및 stackUnder()도 참조하십시오 .

void QWidget::releaseKeyboard()

키보드 잠금을 해제합니다.

grabKeyboard(), grabMouse(), releaseMouse()도 참조하십시오 .

void QWidget::releaseMouse()

마우스 그랩을 해제합니다.

grabMouse(), grabKeyboard(), releaseKeyboard()도 참조하십시오 .

void QWidget::releaseShortcut(int id)

지정된 키 시퀀스( id )를 가진 단축키를 Qt의 단축키 시스템에서 제거합니다. 위젯은 더 이상 해당 단축키의 키 시퀀스에 대한 키 입력 이벤트( QEvent::Shortcut )를 수신하지 않게 됩니다(동일한 키 시퀀스를 가진 다른 단축키가 있는 경우는 제외).

grabShortcut() 및 setShortcutEnabled()도 참조하십시오 .

void QWidget::removeAction(QAction *action)

이 위젯의 동작 목록에서 ‘ action ’ 동작을 제거합니다.

insertAction() 및 actions()도 참조하십시오 .

void QWidget::render(QPaintDevice *target, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

이 위젯의 ` sourceRegion `를 ` target `로 렌더링하며, 렌더링 방식을 결정하기 위해 ` renderFlags `를 사용합니다. 렌더링은 ` target`의 ` targetOffset `에서 시작됩니다. 예를 들어:

QPixmap pixmap(widget->size());
widget->render(&pixmap);

sourceRegion 가 null 영역인 경우, 이 함수는 QWidget::rect()을 영역(즉, 위젯 전체)으로 사용합니다.

렌더링 전에 target 디바이스의 활성 페인터(있는 경우)에 대해 QPainter::end()를 호출해야 합니다. 예를 들어:

QPainter painter(this);
...
painter.end();
myWidget->render(this);

void QWidget::render(QPainter *painter, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

위젯을 painter 의 QPainter::device()에 렌더링합니다.

painter 에 적용된 변환 및 설정이 렌더링 시 사용됩니다.

QPainter::device()도 참조하십시오 .

[slot] void QWidget::repaint()

업데이트가 비활성화되어 있거나 위젯이 숨겨져 있지 않은 한, 즉시 ` paintEvent()`를 호출하여 위젯을 직접 다시 그립니다.

애니메이션 실행 중과 같이 즉각적인 다시 그리기가 필요한 경우에만 repaint()를 사용하는 것이 좋습니다. 대부분의 경우 update()를 사용하는 것이 더 낫습니다. Qt가 속도를 최적화하고 깜빡임을 최소화할 수 있기 때문입니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        widget, qOverload<>(&QWidget::repaint));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        widget, [receiver = widget]() { receiver->repaint(); });

update(), paintEvent(), setUpdatesEnabled()도 참조하십시오 .

void QWidget::repaint(const QRect &rect)

이 버전은 위젯 내부에 있는 사각형 rect 을 다시 그립니다.

void QWidget::repaint(const QRegion &rgn)

이 버전은 위젯 내부의 특정 영역 rgn 을 다시 그립니다.

void QWidget::repaint(int x, int y, int w, int h)

이 버전은 위젯 내부의 사각형(x, y, w, h)을 다시 그립니다.

w 이 음수인 경우 width() - x 으로 대체되고, h 이 음수인 경우 height() - y 으로 대체됩니다.

void QWidget::resize(int w, int h)

이는 resize(QSize(w, h))와 동일합니다.

[virtual protected] void QWidget::resizeEvent(QResizeEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여, ` event ` 매개변수를 통해 전달되는 위젯 크기 조정 이벤트를 수신할 수 있습니다. `resizeEvent()`가 호출될 때, 위젯은 이미 새로운 기하학적 구조를 가지고 있습니다. 이전 크기는 ` QResizeEvent::oldSize()`를 통해 확인할 수 있습니다.

위젯은 크기 조정 이벤트를 처리한 직후 지워지고 페인트 이벤트를 수신합니다. 이 핸들러 내부에서는 그리기 작업을 수행할 필요가 없으며(또는 수행해서는 안 됩니다).

moveEvent(), event(), resize(), QResizeEvent, paintEvent() 및 Scribble 예제도참조하십시오 .

bool QWidget::restoreGeometry(const QByteArray &geometry)

바이트 배열 geometry 에 저장된 최상위 위젯의 형상과 상태를 복원합니다. 성공 시 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

복원된 지오메트리가 화면 밖인 경우, 사용 가능한 화면 지오메트리 내부로 수정됩니다.

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

QSettings settings("MyCompany", "MyApp");
myWidget->restoreGeometry(settings.value("myWidget/geometry").toByteArray());

창과 관련된 지오메트리 문제에 대한 개요는 ‘창 지오메트리(Window Geometry )’ 문서를 참조하십시오.

QMainWindow::restoreState()를 사용하여 지오메트리와 툴바 및 도킹 위젯의 상태를 복원하십시오.

saveGeometry(), QSettings, QMainWindow::saveState() 및 QMainWindow::restoreState()도 참조하십시오 .

QByteArray QWidget::saveGeometry() const

최상위 위젯의 현재 지오메트리와 상태를 저장합니다.

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

void MyWidget::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    QWidget::closeEvent(event);
}

창의 지오메트리 관련 문제에 대한 개요는 ‘창 지오메트리(Window Geometry )’ 문서를 참조하십시오.

QMainWindow::saveState()을 사용하여 툴바 및 도크 위젯의 기하 구조와 상태를 저장하십시오.

restoreGeometry(), QMainWindow::saveState(), QMainWindow::restoreState()도 참조하십시오 .

QScreen *QWidget::screen() const

위젯이 위치한 화면을 반환합니다.

setScreen() 및 windowHandle()도 참조하십시오 .

void QWidget::scroll(int dx, int dy)

위젯과 그 자식 요소들을 포함하여 dx 픽셀만큼 오른쪽으로, dy 만큼 아래로 스크롤합니다. dx 와 dy 모두 음수 값을 가질 수 있습니다.

스크롤이 완료된 후, 위젯들은 다시 그려져야 하는 영역에 대한 페인트 이벤트를 수신합니다. Qt가 불투명하다고 인식하는 위젯의 경우, 새로 노출된 부분만 해당됩니다. 예를 들어, 불투명한 위젯이 왼쪽으로 8 픽셀 스크롤된 경우, 오른쪽 가장자리에 있는 8 픽셀 너비의 띠 부분만 업데이트하면 됩니다.

위젯은 기본적으로 부모의 내용을 전파하므로, 위젯을 불투명하게 만들려면 ` autoFillBackground ` 속성을 설정하거나 ` setAttribute()`를 사용하여 ` Qt::WA_OpaquePaintEvent ` 속성을 설정해야 합니다.

콘텐츠 전파를 사용하는 위젯의 경우, 스크롤이 발생하면 전체 스크롤 영역이 업데이트됩니다.

Transparency and Double Buffering도 참조하십시오 .

void QWidget::scroll(int dx, int dy, const QRect &r)

이 버전은 r 만 스크롤하며, 위젯의 자식 요소는 이동시키지 않습니다.

r 가 비어 있거나 유효하지 않은 경우, 결과는 정의되지 않습니다.

QScrollArea도 참조하십시오 .

void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

on 가 true인 경우 이 위젯의 attribute 속성을 설정하고, 그렇지 않은 경우 해당 속성을 지웁니다.

testAttribute()도 참조하십시오 .

void QWidget::setBackgroundRole(QPalette::ColorRole role)

위젯의 배경 역할을 ` role`로 설정합니다.

background 역할은 위젯의 palette 에서 배경을 렌더링하는 데 사용되는 브러시를 정의합니다.

role 가 QPalette::NoRole 인 경우, 위젯은 부모의 배경 역할을 상속받습니다.

스타일은 팔레트에서 원하는 색상을 자유롭게 선택할 수 있습니다. setBackgroundRole()을 사용하여 원하는 결과를 얻지 못한 경우, 팔레트를 수정하거나 스타일시트를 설정할 수 있습니다.

backgroundRole() 및 foregroundRole()도 참조하십시오 .

void QWidget::setBaseSize(int basew, int baseh)

이는 setBaseSize(QSize(basew, baseh))와 동일합니다. 위젯의 기본 크기를 너비 basew, 높이 baseh 로 설정합니다.

baseSize()도 참조하십시오 .

void QWidget::setContentsMargins(int left, int top, int right, int bottom)

위젯 콘텐츠 주변의 여백 크기를 left, top, right, bottom 로 설정합니다. 이 여백은 레이아웃 시스템에서 사용되며, 하위 클래스에서 그리기 영역(예: 프레임 제외)을 지정하는 데 사용될 수 있습니다.

여백을 변경하면 ` resizeEvent()`가 호출됩니다.

contentsRect() 및 contentsMargins()도 참조하십시오 .

void QWidget::setContentsMargins(const QMargins &margins)

setContentsMargins 함수는 위젯 콘텐츠 주변의 여백을 설정합니다.

위젯 콘텐츠 주변의 여백을 margins 에서 결정된 크기로 설정합니다. 이 여백은 레이아웃 시스템에서 사용되며, 하위 클래스에서 그리기 영역(예: 프레임 제외)을 지정하는 데 사용될 수 있습니다.

여백을 변경하면 resizeEvent()이 호출됩니다.

contentsRect() 및 contentsMargins()도 참조하십시오 .

[slot] void QWidget::setDisabled(bool disable)

disable 가 true인 경우 위젯 입력 이벤트를 비활성화하고, 그렇지 않은 경우 입력 이벤트를 활성화합니다.

자세한 내용은 enabled 문서를 참조하십시오.

isEnabledTo(), QKeyEvent, QMouseEvent 및 changeEvent()도 참조하십시오 .

void QWidget::setFixedHeight(int h)

위젯의 너비는 변경하지 않은 채 높이를 최소값과 최대값 모두 h 로 설정합니다. 편의상 제공되는 기능입니다.

sizeHint(), minimumSize(), maximumSize(), setFixedSize()도 참조하십시오 .

void QWidget::setFixedSize(const QSize &s)

위젯의 최소 및 최대 크기를 모두 s 로 설정하여, 위젯이 커지거나 줄어들지 못하도록 합니다.

이렇게 하면 ` QLayout`로 설정된 기본 크기 제약 조건이 재정의됩니다.

제약 조건을 제거하려면 크기를 QWIDGETSIZE_MAX 로 설정하십시오.

또는 위젯이 내용에 따라 고정된 크기를 갖도록 하려면 QLayout::setSizeConstraint(QLayout::SetFixedSize)를 호출할 수 있습니다.

maximumSize 및 minimumSize도 참조하십시오 .

void QWidget::setFixedSize(int w, int h)

위젯의 너비를 w 로, 높이를 h 로 설정합니다.

void QWidget::setFixedWidth(int w)

위젯의 높이를 변경하지 않고 너비를 모두 w 로 설정합니다. 편의상 제공됩니다.

sizeHint(), minimumSize(), maximumSize(), setFixedSize()도 참조하십시오 .

void QWidget::setFocus(Qt::FocusReason reason)

이 위젯이나 그 상위 위젯 중 하나가 ‘ active window ’인 경우, 키보드 입력 포커스를 이 위젯(또는 그 포커스 프록시)에 부여합니다. ‘ reason ’ 인수는 이 함수에서 전송되는 모든 포커스 이벤트에 전달되며, 위젯이 포커스를 얻게 된 원인을 설명하는 데 사용됩니다. 창이 비활성 상태인 경우, 창이 활성화되면 위젯에 포커스가 주어집니다.

먼저, 포커스가 변경될 예정이라는 이벤트가 포커스 위젯(있는 경우)으로 전송되어 포커스를 잃게 될 것임을 알립니다. 그런 다음 포커스가 변경되면, 이전 포커스 항목에 포커스 아웃 이벤트가 전송되고, 새로운 항목에는 포커스 인 이벤트가 전송되어 방금 포커스를 받았음을 알립니다. (포커스 인 및 포커스 아웃 위젯이 동일한 경우에는 아무 일도 일어나지 않습니다.)

setFocus()는 위젯의 포커스 정책과 관계없이 해당 위젯에 포커스를 부여하지만, 키보드 그랩은 해제하지 않습니다( grabKeyboard() 참조).

위젯이 숨겨져 있는 경우, 표시될 때까지 포커스를 받을 수 없다는 점에 유의하십시오.

hasFocus(), clearFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), focusWidget(), QApplication::focusWidget(), grabKeyboard(), grabMouse(), 위젯의 키보드 포커스, QEvent::RequestSoftwareInputPanel도 참조하십시오 .

[slot] void QWidget::setFocus()

이 위젯이나 그 상위 위젯 중 하나가 ‘ active window ’인 경우, 키보드 입력 포커스를 이 위젯(또는 해당 위젯의 포커스 프록시)에 부여합니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        widget, qOverload<>(&QWidget::setFocus));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        widget, [receiver = widget]() { receiver->setFocus(); });

void QWidget::setFocusProxy(QWidget *w)

위젯의 포커스 프록시를 w 위젯으로 설정합니다. w 가 nullptr 인 경우, 이 함수는 해당 위젯의 포커스 프록시를 없음으로 재설정합니다.

일부 위젯은 “포커스를 가질” 수 있지만, 실제로 포커스를 처리하기 위해 QLineEdit 와 같은 자식 위젯을 생성하기도 합니다. 이 경우, 해당 위젯은 라인 에디트를 자신의 포커스 프록시로 설정할 수 있습니다.

setFocusProxy()는 “이 위젯”이 포커스를 받을 때 실제로 포커스를 받게 될 위젯을 설정합니다. 포커스 프록시가 있는 경우, setFocus() 및 hasFocus()는 포커스 프록시를 대상으로 작동합니다. “이 위젯”이 포커스 위젯인 경우, setFocusProxy()는 포커스를 새로운 포커스 프록시로 이동시킵니다.

focusProxy()도 참조하십시오 .

void QWidget::setForegroundRole(QPalette::ColorRole role)

위젯의 전경 역할을 role 로 설정합니다.

전경 역할은 위젯의 ' palette '에서 전경을 그리는 데 사용되는 색상을 정의합니다.

role 가 QPalette::NoRole 인 경우, 위젯은 배경 역할과 대비되는 전경 역할을 사용합니다.

스타일은 팔레트에서 원하는 색상을 자유롭게 선택할 수 있습니다. setForegroundRole()을 사용하여 원하는 결과를 얻지 못한 경우, 팔레트를 수정하거나 스타일 시트를 설정할 수 있습니다.

foregroundRole() 및 backgroundRole()도 참조하십시오 .

void QWidget::setGeometry(int x, int y, int w, int h)

이는 setGeometry(QRect(x, y, w, h))에 해당합니다.

geometry()도 참조하십시오 .

void QWidget::setGraphicsEffect(QGraphicsEffect *effect)

setGraphicsEffect 함수는 위젯의 그래픽 효과를 설정하는 데 사용됩니다.

effect 를 위젯의 효과로 설정합니다. 이 위젯에 이미 효과가 적용되어 있는 경우, QWidget 는 새로운 effect 를 적용하기 전에 기존 효과를 삭제합니다.

effect 가 다른 위젯에 설치된 효과인 경우, setGraphicsEffect()는 해당 위젯에서 효과를 제거하고 이 위젯에 설치합니다. .

QWidget effect 의 소유권을 가져옵니다.

graphicsEffect()도 참조하십시오 .

[slot] void QWidget::setHidden(bool hidden)

setVisible(!hidden)와 동등한 편의 함수입니다.

isHidden()도 참조하십시오 .

void QWidget::setLayout(QLayout *layout)

이 위젯의 레이아웃 관리자를 ` layout`로 설정합니다.

이 위젯에 이미 레이아웃 관리자가 설정되어 있는 경우, ` QWidget `을 사용하면 다른 레이아웃 관리자를 설정할 수 없습니다. 새로운 레이아웃으로 `setLayout()`을 호출하기 전에 먼저 기존 레이아웃 관리자(` layout()`에서 반환된 것)를 삭제해야 합니다.

layout 가 다른 위젯의 레이아웃 관리자인 경우, setLayout()은 레이아웃의 부모를 변경하여 이를 이 위젯의 레이아웃 관리자로 설정합니다.

예시:

QVBoxLayout *layout = new QVBoxLayout;
layout->addWidget(formWidget);
formWidget->setLayout(layout);

이 함수를 호출하는 대신, 이 위젯을 레이아웃의 생성자에 전달할 수도 있습니다.

QWidget 는 layout 의 소유권을 인수합니다.

layout() 및 레이아웃 관리항목도 참조하십시오 .

void QWidget::setMask(const QBitmap &bitmap)

bitmap 에 1 비트가 설정된 위젯의 픽셀만 표시되도록 합니다. 해당 영역에 위젯의 rect() 범위를 벗어난 픽셀이 포함된 경우, 플랫폼에 따라 해당 영역의 윈도우 시스템 컨트롤이 표시될 수도 있고 표시되지 않을 수도 있습니다.

영역이 특히 복잡한 경우 이 효과가 느려질 수 있다는 점에 유의하십시오.

다음 코드는 알파 채널이 있는 이미지를 사용하여 위젯의 마스크를 생성하는 방법을 보여줍니다:

QLabel topLevelLabel;
QPixmap pixmap(":/images/tux.png");
topLevelLabel.setPixmap(pixmap);
topLevelLabel.setMask(pixmap.mask());

이 코드가 표시하는 레이블은 포함된 이미지를 사용하여 마스킹되므로, 불규칙한 모양의 이미지가 화면에 직접 그려지는 것처럼 보입니다.

마스크된 위젯은 보이는 부분에서만 마우스 이벤트를 수신합니다.

mask(), clearMask(), windowOpacity()도 참조하십시오 .

void QWidget::setMask(const QRegion &region)

위젯 중 ‘ region ’ 영역과 겹치는 부분만 표시되도록 합니다. 해당 영역에 위젯의 ‘ rect()’ 범위를 벗어난 픽셀이 포함된 경우, 플랫폼에 따라 해당 영역의 창 시스템 컨트롤이 표시될 수도 있고 표시되지 않을 수도 있습니다.

QRegion 을 사용하면 임의로 복잡한 영역을 생성할 수 있으므로, 위젯 마스크를 통해 가장 비정형적인 모양의 창에도 맞출 수 있을 뿐만 아니라, 위젯에 구멍이 뚫린 상태로 표시하는 것도 가능합니다. 단, 영역이 특히 복잡한 경우 이 처리 속도가 느려질 수 있습니다.

위젯 마스크는 마스크 외부의 영역에 대해 애플리케이션이 마우스 이벤트를 원하지 않음을 윈도우 시스템에 알리는 데 사용됩니다. 대부분의 시스템에서 마스크는 또한 대략적인 시각적 클리핑을 유발합니다. 매끄러운 창 테두리를 얻으려면 ‘반투명 배경’ 예제에서 보여준 것처럼 반투명 배경과 앤티앨리어싱 렌더링을 대신 사용하십시오.

windowOpacity도 참조하십시오 .

void QWidget::setMaximumSize(int maxw, int maxh)

이 함수는 setMaximumSize(QSize(maxw, maxh))에 해당합니다. 최대 너비를 maxw 로, 최대 높이를 maxh 로 설정합니다.

maximumSize()도 참조하십시오 .

void QWidget::setMinimumSize(int minw, int minh)

이 함수는 setMinimumSize(QSize(minw, minh))와 동일합니다. 최소 너비를 minw 로, 최소 높이를 minh 로 설정합니다.

minimumSize()도 참조하십시오 .

void QWidget::setParent(QWidget *parent)

위젯의 부모를 parent 로 설정하고, 창 플래그를 초기화합니다. 위젯은 새로운 부모 창 내의 (0, 0) 위치로 이동됩니다.

새로운 부모 위젯이 다른 창에 있는 경우, 부모가 변경된 위젯과 그 자식 위젯들은 이전과 동일한 내부 순서대로 새로운 부모 위젯의 tab chain 끝에 추가됩니다. 이동된 위젯 중 하나에 키보드 포커스가 설정되어 있었다면, setParent()는 해당 위젯에 대해 clearFocus()를 호출합니다.

새로운 부모 위젯이 기존 부모 위젯과 같은 창에 있는 경우, 부모를 설정해도 탭 순서나 키보드 포커스는 변경되지 않습니다.

"새로운" 부모 위젯이 기존 부모 위젯인 경우, 이 함수는 아무 작업도 수행하지 않습니다.

참조: setWindowFlags().

void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)

이 함수는 위젯 플래그인 ` f `도 인수로 받습니다.

void QWidget::setScreen(QScreen *screen)

위젯이 표시될 화면을 screen 로 설정합니다.

화면 설정은 창에 대해서만 의미가 있습니다. 필요한 경우, 위젯의 창이 screen 에서 다시 생성됩니다.

screen() 및 QWindow::setScreen()도 참조하십시오 .

void QWidget::setShortcutAutoRepeat(int id, bool enable = true)

enable 가 true인 경우, 지정된 id 를 사용하는 단축키의 자동 반복 기능이 활성화되며, 그렇지 않은 경우 비활성화됩니다.

grabShortcut() 및 releaseShortcut()도 참조하십시오 .

void QWidget::setShortcutEnabled(int id, bool enable = true)

enable 가 true인 경우, 지정된 id 를 가진 단축키가 활성화되며, 그렇지 않은 경우 단축키는 비활성화됩니다.

grabShortcut() 및 releaseShortcut()도 참조하십시오 .

void QWidget::setSizeIncrement(int w, int h)

x(너비) 크기 증가량을 w 로, y(높이) 크기 증가량을 h 로 설정합니다.

sizeIncrement()도 참조하십시오 .

void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

위젯의 크기 정책을 ‘ horizontal ’ 및 ‘ vertical ’으로 설정하며, 표준 신축 모드를 적용하고 ‘height-for-width’는 사용하지 않습니다.

sizePolicy() 및 QSizePolicy::QSizePolicy()도 참조하십시오 .

void QWidget::setStyle(QStyle *style)

위젯의 GUI 스타일을 ` style`로 설정합니다. 스타일 객체의 소유권은 이전되지 않습니다.

스타일이 설정되지 않은 경우, 위젯은 대신 애플리케이션의 스타일인 ` QApplication::style()`을 사용합니다.

위젯의 스타일을 설정해도 기존 또는 향후 생성될 자식 위젯에는 아무런 영향도 미치지 않습니다.

style(), QStyle, QApplication::style() 및 QApplication::setStyle()도 참조하십시오 .

[static] void QWidget::setTabOrder(QWidget *first, QWidget *second)

포커스 순서에서 ‘ second ’ 위젯을 ‘ first ’ 위젯 뒤에 배치합니다.

이는 효과적으로 second 위젯을 포커스 체인에서 제거하고, first 위젯 뒤에 삽입합니다.

second 위젯의 탭 순서가 변경되므로, 체인을 다음과 같이 구성해야 합니다:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

다음과 같이 정렬해서는안 됩니다:

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

first 또는 second 에 포커스 프록시가 있는 경우, setTabOrder()는 해당 프록시를 올바르게 대체합니다.

setFocusPolicy(), setFocusProxy() 및 ‘위젯의 키보드 포커스’항목도 참조하십시오 .

[static, since 6.6] void QWidget::setTabOrder(std::initializer_list<QWidget *> widgets)

widgets 목록에 있는 위젯들의 탭 순서를 설정하기 위해, 연속된 위젯 쌍마다 QWidget::setTabOrder(QWidget *, QWidget *)를 호출합니다.

다음과 같이 각 쌍을 수동으로 설정하는 대신:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

다음과 같이 호출할 수 있습니다:

setTabOrder({a, b, c, d}); // a to b to c to d

이 호출은 닫힌 탭 포커스 루프를 생성하지 않습니다. ' Qt::TabFocus ' 포커스 정책을 가진 위젯이 더 있는 경우, d 에서 탭 키를 누르면 a 로 돌아가지 않고 해당 위젯 중 하나로 포커스가 이동합니다.

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

setFocusPolicy(), setFocusProxy() 및 위젯의 키보드 포커스항목도 참조하십시오 .

void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)

on 가 true인 경우 이 위젯에 flag 창 플래그를 설정하고, 그렇지 않은 경우 해당 플래그를 해제합니다.

관련 항목: setWindowFlags(), windowFlags(), windowType().

void QWidget::setWindowRole(const QString &role)

창의 역할을 ` role`로 설정합니다. 이 설정은 X11 환경의 창에서만 의미가 있습니다.

windowRole()도 참조하십시오 .

void QWidget::setWindowState(Qt::WindowStates windowState)

창 상태를 windowState 로 설정합니다. 창 상태는 Qt::WindowState: Qt::WindowMinimized, Qt::WindowMaximized, Qt::WindowFullScreen 및 Qt::WindowActive 의 논리 OR 연산 조합입니다.

창이 보이지 않는 상태(즉, ` isVisible()`가 ` false`를 반환하는 경우)라면, ` show()`가 호출될 때 창 상태가 적용됩니다. 보이는 창의 경우 변경 사항은 즉시 적용됩니다. 예를 들어, 전체 화면 모드와 일반 모드 사이를 전환하려면 다음 코드를 사용하십시오:

w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);

최소화된 창을 복원하고 활성화하려면(최대화 및/또는 전체 화면 상태는 유지한 채로), 다음을 사용하십시오:

w->setWindowState((w->windowState() & ~Qt::WindowMinimized) | Qt::WindowActive);

이 함수를 호출하면 위젯이 숨겨집니다. 위젯을 다시 표시하려면 show()를 호출해야 합니다.