QWidget Class

멤버 함수 문서

이러한 편의 함수는 텍스트 text, 아이콘 icon 및 바로 가기 shortcut(있는 경우)가 포함된 새 작업을 만듭니다.

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

QWidget 는 반환된 QAction 의 소유권을 가져옵니다.

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

이 기능은 과부하된 기능입니다.

이 편의 기능은 텍스트 text, 아이콘 icon, 바로가기 shortcut(있는 경우)가 포함된 새 액션을 만듭니다.

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

QWidget 반환된 QAction 의 소유권을 가져옵니다.

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

이 기능은 오버로드된 기능입니다.

이러한 편의 함수는 텍스트 text, 아이콘 icon, 바로 가기 shortcut(있는 경우)가 포함된 새 액션을 만듭니다.

액션의 triggered() 신호는 QObject::connect(액션, &QAction::triggered, args...)에 대한 호출처럼 연결되어 args, 가능한 Qt::ConnectionType 을 포함하여 완벽하게 전달됩니다.

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

QWidget 반환된 QAction 의 소유권을 가져옵니다.

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

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

위젯 플래그를 f 으로 설정하여 parent 의 자식인 위젯을 생성합니다.

parent 가 nullptr 인 경우 새 위젯은 창이 됩니다. parent 가 다른 위젯인 경우 이 위젯은 parent 안에 있는 자식 창이 됩니다. 새 위젯은 parent 이 삭제되면 삭제됩니다.

위젯 플래그 인수인 f 은 일반적으로 0이지만 창 프레임을 사용자 지정하도록 설정할 수 있습니다(예: parent 은 nullptr 여야 합니다). 프레임을 사용자 지정하려면 window flags 의 비트별 OR로 구성된 값을 사용합니다.

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

Qt의 X11 버전은 모든 시스템에서 스타일 플래그의 모든 조합을 제공하지 못할 수도 있습니다. 이는 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도 참조하세요 .

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. 위젯이 accepts 이벤트가 닫히면 위젯은 hidden 입니다. 이벤트를 ignores 하면 아무 일도 일어나지 않습니다. QWidget::closeEvent ()의 기본 구현은 닫기 이벤트를 받아들입니다.

위젯에 Qt::WA_DeleteOnClose 플래그가 있는 경우 위젯도 삭제됩니다. 위젯이 표시되는지 여부에 관계없이 위젯 닫기 이벤트가 위젯에 전달됩니다.

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::fromWinId()를 사용하여 외부 창을 감싸는 QWindow 을 생성하고 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 인스턴스 구현 자체에 달려 있습니다. 예를 들어, 탭 포커스가 있는 Qt Quick 기반 창에 들어갈 때 추가 탭 누름은 QML 애플리케이션 내부에서만 순환할 가능성이 높습니다. 또한 QWindow::requestActivate()가 실제로 창 포커스를 제공하는지 여부는 플랫폼에 따라 다릅니다.
• QWidget 기반 애플리케이션에서 많은 윈도우 컨테이너 인스턴스를 사용하면 애플리케이션의 전반적인 성능이 크게 저하될 수 있습니다.
• 6.7부터 window 가 위젯에 속하는 경우(즉, window 이 windowHandle() 호출에서 수신된 경우) 컨테이너가 생성되지 않습니다. 대신 이 함수는 parent 로 리부모된 후 위젯 자체를 반환합니다. 컨테이너가 생성되지 않으므로 flags 은 무시됩니다. 즉, window 이 위젯에 속한 경우 이 함수를 사용하는 대신 해당 위젯을 parent 으로 리패런팅하는 것이 좋습니다.

[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 가 참이면 위젯 창을 삭제합니다.

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 는 위젯이 완전히 구성된 후 처음 표시되기 전에 이 함수를 호출합니다. 위젯의 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 가 참이면 이 함수는 앞으로 검색하고 next 가 거짓이면 뒤로 검색합니다.

이 함수를 다시 구현하고 싶을 때가 있습니다. 예를 들어, 웹 브라우저에서 "현재 활성 링크"를 앞뒤로 이동하고 "페이지"의 마지막 또는 첫 번째 링크에 도달할 때만 focusNextPrevChild()를 호출하도록 재구현할 수 있습니다.

자식 위젯은 부모 위젯에서 focusNextPrevChild()를 호출하지만, 자식 위젯이 포함된 창에서만 포커스를 리디렉션할 위치를 결정합니다. 따라서 객체에 대해 이 함수를 다시 구현하면 모든 자식 위젯에 대한 포커스 이동을 제어할 수 있습니다.

focusNextChild() 및 focusPreviousChild()도 참조하세요 .

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

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

위젯이 포커스 이벤트를 받으려면 일반적으로 Qt::NoFocus 이외의 다른 곳에 setFocusPolicy()를 전달해야 합니다. (애플리케이션 프로그래머는 일반적으로 포커스를 받지 않는 위젯을 포함하여 모든 위젯에서 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())

특정 flags 으로 지정된 gesture 에 위젯을 구독합니다.

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)

이 함수는 grabMouse()를 오버로드합니다.

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

커서는 마우스 포커스가 잡혀 있는 동안 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 이벤트가 비결정적 순서로 적용되지만 '모호한' 플래그가 true로 설정된 모든 위젯에 전송됩니다.

releaseShortcut() 및 setShortcutEnabled()도 참조하세요 .

QGraphicsEffect *QWidget::graphicsEffect() const

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

위젯에 그래픽 효과가 없는 경우 nullptr 이 반환됩니다.

setGraphicsEffect()도 참조하세요 .

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

그래픽 보기에서 해당 임베디드 위젯의 프록시 위젯을 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

QGraphicsProxyWidget::createProxyForChildWidget() 및 QGraphicsScene::addWidget()도 참조하세요 .

bool QWidget::hasEditFocus() const

이 위젯에 현재 편집 포커스가 있으면 true, 그렇지 않으면 false를 반환합니다.

이 기능은 임베디드 리눅스용 Qt에서만 사용할 수 있습니다.

setEditFocus() 및 QApplication::navigationMode()도 참조하십시오 .

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

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

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

removeAction(), addAction(), QMenu, contextMenuPolicy, actions()도 참조하세요 .

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

before 액션 앞에 actions 액션을 이 위젯의 액션 목록에 삽입합니다. 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)는 거짓을 반환합니다.

여기서 상위 위젯이란 같은 창 내의 상위 위젯을 의미합니다.

따라서 부모 창도 고려하는 isEnabled()와 달리 isEnabledTo(0)은 이 위젯의 창에서 멈춥니다.

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 까지의 부모가 명시적으로 숨겨져 있지 않은 경우에 발생합니다.

이 함수는 위젯이 화면의 다른 창에 가려져 있지만 위젯 또는 위젯이 이동하면 물리적으로 표시될 수 있는 경우에도 참을 반환합니다.

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::페인트 장치 메트릭 메트릭) 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::pos()는 이 위젯을 기준으로 마우스 커서의 위치를 보고합니다. 누르기 및 놓기 이벤트의 경우 위치는 일반적으로 마지막 마우스 이동 이벤트의 위치와 동일하지만 사용자의 손이 흔들리면 위치가 달라질 수 있습니다. 이것은 Qt가 아닌 기본 창 시스템의 기능입니다.

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

setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent, 및 낙서 예시도참조하세요 .

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

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

마우스 프레스 이벤트()에서 새 위젯을 만들면 기본 창 시스템(또는 X11 창 관리자), 위젯의 위치 등에 따라 mouseReleaseEvent()가 예상한 위치에 오지 않을 수 있습니다.

기본 구현은 창 외부를 클릭하면 팝업 위젯이 닫히는 것을 구현합니다. 다른 위젯 유형의 경우 아무 작업도 수행하지 않습니다.

mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, 및 Scribble 예시를참조하세요 .

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

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

mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, 및 낙서 예시도참조하세요 .

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)

이 특수 이벤트 핸들러는 하위 클래스에서 다시 구현하여 message 파라미터로 전달되는 eventType 로 식별되는 네이티브 플랫폼 이벤트를 수신할 수 있습니다.

이 함수를 다시 구현할 때 Qt에서 처리되는 이벤트를 중지하려면 참을 반환하고 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, 및 아날로그 시계도참조하세요 .

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)

Qt의 바로가기 시스템에서 지정된 id 의 바로가기를 제거합니다. 위젯은 더 이상 바로가기의 키 시퀀스에 대한 QEvent::Shortcut 이벤트를 수신하지 않습니다(동일한 키 시퀀스를 가진 다른 바로가기가 없는 경우).

grabShortcut() 및 setShortcutEnabled()도 참조하세요 .

void QWidget::removeAction(QAction *action)

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

insertAction(), actions() 및 insertAction()도 참조하세요 .

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

renderFlags 을 사용하여 이 위젯의 sourceRegion 을 target 으로 렌더링하는 방법을 결정합니다. 예를 들어 target 에서 targetOffset 에서 렌더링이 시작됩니다:

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

sourceRegion 이 널 영역인 경우 이 함수는 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 XML이 속도를 최적화하고 깜박임을 최소화할 수 있기 때문입니다.

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() 및 낙서 예시를참조하세요 .

bool QWidget::restoreGeometry(const QByteArray &geometry)

바이트 배열에 저장된 최상위 위젯의 지오메트리와 상태를 복원합니다 geometry. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

복원된 지오메트리가 화면 밖에 있는 경우 사용 가능한 화면 지오메트리 안에 있도록 수정됩니다.

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

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

창에서 발생하는 지오메트리 문제에 대한 개요는 창 지오메트리 설명서를 참조하세요.

QMainWindow::restoreState()를 사용하여 지오메트리와 도구 모음 및 도크 위젯의 상태를 복원할 수 있습니다.

saveGeometry(), QSettings, QMainWindow::saveState() 및 QMainWindow::restoreState()도 참조하세요 .

QByteArray QWidget::saveGeometry() const

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

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

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

창과 관련된 지오메트리 문제에 대한 개요는 창 지오메트리 문서를 참조하세요.

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 이 참이면 이 위젯에 attribute 속성을 설정하고, 그렇지 않으면 속성을 지웁니다.

testAttribute()도 참조하세요 .

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

위젯의 백그라운드 역할을 role 로 설정합니다.

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

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

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

backgroundRole() 및 foregroundRole()도 참조하세요 .

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

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

이는 setBaseSize(QSize(basew, baseh))에 해당합니다. 위젯 기본 크기를 너비 basew 및 높이 baseh 로 설정합니다.

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 이 참이면 위젯 입력 이벤트를 비활성화하고, 그렇지 않으면 입력 이벤트를 활성화합니다.

자세한 내용은 enabled 문서를 참조하세요.

isEnabledTo(), QKeyEvent, QMouseEvent, changeEvent()도 참조하세요 .

void QWidget::setEditFocus(bool enable)

enable 이 참이면 이 위젯에 편집 포커스를 갖도록 설정하면 Qt::Key_Up 및 Qt::Key_Down 이 위젯에 정상적으로 전달되고, 그렇지 않으면 Qt::Key_Up 및 Qt::Key_Down 이 포커스를 변경하는 데 사용됩니다.

이 기능은 임베디드 Linux용 Qt에서만 사용할 수 있습니다.

hasEditFocus() 및 QApplication::navigationMode()도 참조하십시오 .

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 인 경우 이 위젯(또는 그 포커스 프록시)에 키보드 입력 포커스를 부여합니다.

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))에 해당합니다.

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 에서는 다른 레이아웃 매니저를 설치할 수 없습니다. 먼저 기존 레이아웃 매니저( layout()에 의해 반환됨)를 삭제해야 새 레이아웃으로 setLayout()을 호출할 수 있습니다.

layout 가 다른 위젯의 레이아웃 매니저인 경우 setLayout()은 레이아웃을 다시 부모로 지정하여 이 위젯의 레이아웃 매니저로 만듭니다.

예시:

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(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 로 설정합니다.

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

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

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

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 이 참이면 지정된 id 으로 바로 가기 자동 반복이 활성화되고, 그렇지 않으면 비활성화됩니다.

grabShortcut() 및 releaseShortcut()도 참조하세요 .

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

enable 이 참이면 id 이 지정된 바로 가기가 활성화되고, 그렇지 않으면 바로 가기가 비활성화됩니다.

grabShortcut() 및 releaseShortcut()도 참조하세요 .

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

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

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

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

과부하가 걸린 함수입니다.

위젯의 크기 정책을 horizontal 및 vertical, 표준 스트레치 및 너비 대비 높이 없음으로 설정합니다.

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)

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

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)

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

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

이렇게 각 쌍을 수동으로 설정하는 대신:

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 이 참이면 이 위젯에 창 플래그 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()를 호출해야 합니다.

창 상태가 변경되면 위젯은 QEvent::WindowStateChange 유형의 changeEvent()를 받습니다.

Qt::WindowState 및 windowState()도 참조하세요 .

void QWidget::setupUi(QWidget *widget)

지정된 widget 에 대한 사용자 인터페이스를 설정합니다.

애플리케이션에서 디자이너 UI 파일 사용도참조하세요 .

[slot] void QWidget::show()

위젯과 그 하위 위젯을 표시합니다.

자식 창의 경우 setVisible(참)을 호출하는 것과 같습니다. 그렇지 않으면 창 플래그에 대한 플랫폼의 기본 동작에 따라 showFullScreen(), showMaximized() 또는 setVisible(true)를 호출하는 것과 같습니다.

raise(), showEvent(), hide(), setVisible(), showMinimized(), showMaximized(), showNormal(), isVisible(), windowFlags()도 참조하세요 .

[virtual protected] void QWidget::showEvent(QShowEvent *event)

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

자발적이지 않은 표시 이벤트는 위젯이 표시되기 직전에 위젯으로 전송됩니다. 윈도우의 자발적 표시 이벤트는 나중에 전달됩니다.

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

visible, event() 및 QShowEvent 를참조하세요 .

[slot] void QWidget::showFullScreen()

위젯을 전체 화면 모드로 표시합니다.

이 함수를 호출하면 windows 에만 영향을 줍니다.

전체 화면 모드에서 돌아가려면 showNormal() 또는 close()를 호출하세요.

다른 방법은 창 관리자를 완전히 우회하여 Qt::X11BypassWindowManagerHint 플래그가 있는 창을 만드는 것입니다. 하지만 키보드 포커스가 깨지고 바탕화면이 변경되거나 사용자가 다른 창을 띄울 때 매우 이상한 효과가 나타나는 등 다른 심각한 문제가 있습니다.

최신 ICCCM 이후 사양을 따르는 X11 창 관리자는 전체 화면 모드를 제대로 지원합니다.

macOS에서 창을 전체 화면으로 표시하면 전체 애플리케이션이 전체 화면 모드로 전환되어 전용 데스크톱이 제공됩니다. 애플리케이션이 전체 화면 모드로 실행되는 동안 다른 창을 표시하면 해당 창도 자동으로 전체 화면이 될 수 있습니다. 이를 방지하려면 다른 창을 표시하기 전에 전체 화면 창에서 showNormal() 또는 close()을 호출하여 전체 화면 모드를 종료하세요.

showNormal(), showMaximized(), show(), isVisible() 및 close()도 참조하세요 .

[slot] void QWidget::showMaximized()

위젯을 최대로 표시합니다.

이 함수를 호출하면 windows 에만 영향을 줍니다.

X11에서는 특정 창 관리자에서 이 함수가 제대로 작동하지 않을 수 있습니다. 자세한 설명은 창 지오메트리 설명서를 참조하십시오.

setWindowState(), showNormal(), showMinimized(), show(), hide() 및 isVisible()도 참조하세요 .

[slot] void QWidget::showMinimized()

위젯을 최소화한 상태로 아이콘으로 표시합니다.

이 함수를 호출하면 windows 에만 영향을 줍니다.

showNormal(), showMaximized(), show(), hide(), isVisible() 및 isMinimized()도 참조하세요 .

[slot] void QWidget::showNormal()

위젯을 최대화 또는 최소화한 후 복원합니다.

이 함수를 호출하면 windows 에만 영향을 줍니다.

setWindowState(), showMinimized(), showMaximized(), show(), hide() 및 isVisible()도 참조하세요 .

void QWidget::stackUnder(QWidget *w)

위젯을 부모 위젯의 스택에서 w 아래에 배치합니다.

이 작업을 수행하려면 위젯 자체와 w 가 형제여야 합니다.

raise() 및 lower()도 참조하세요 .

QStyle *QWidget::style() const

QWidget::setStyle(), QApplication::setStyle() 및 QApplication::style()도 참조하세요 .

[virtual protected] void QWidget::tabletEvent(QTabletEvent *event)

이벤트 event 에 대한 이 이벤트 핸들러는 위젯에 대한 태블릿 이벤트를 수신하기 위해 서브클래스에서 다시 구현할 수 있습니다.

이 핸들러를 다시 구현하는 경우 이벤트를 처리하지 않을 경우 이벤트를 ignore() 처리하여 위젯의 부모가 이벤트를 해석할 수 있도록 하는 것이 매우 중요합니다.

기본 구현은 이벤트를 무시합니다.

태블릿 추적이 꺼져 있는 경우 태블릿 이동 이벤트는 스타일러스가 태블릿에 닿아 있거나 스타일러스가 이동하는 동안 하나 이상의 스타일러스 버튼이 눌린 경우에만 발생합니다. 태블릿 트래킹이 켜져 있으면 스타일러스가 태블릿에 근접해 있는 동안에도 버튼을 누르지 않아도 태블릿 이동 이벤트가 발생합니다.

QEvent::ignore(), QEvent::accept(), event(), setTabletTracking() 및 QTabletEvent 를참조하세요 .

bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const

이 위젯에 attribute 속성이 설정되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setAttribute()도 참조하세요 .

bool QWidget::underMouse() const

위젯이 마우스 커서 아래에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 값은 드래그 앤 드롭 작업 중에는 제대로 업데이트되지 않습니다.

enterEvent() 및 leaveEvent()도 참조하세요 .

void QWidget::ungrabGesture(Qt::GestureType gesture)

지정된 gesture 유형에서 위젯 구독을 취소합니다.

grabGesture() 및 QGestureEvent도 참조하세요 .

[slot] void QWidget::update()

업데이트가 비활성화되거나 위젯이 숨겨져 있지 않으면 위젯을 업데이트합니다.

이 함수는 즉시 다시 그리지 않고, 대신 Qt가 메인 이벤트 루프로 돌아올 때 처리할 페인트 이벤트를 예약합니다. 이를 통해 Qt는 repaint()를 호출하는 것보다 더 빠른 속도와 적은 깜빡임을 위해 최적화할 수 있습니다.

update()를 여러 번 호출하면 일반적으로 paintEvent() 호출이 한 번만 발생합니다.

Qt는 일반적으로 paintEvent() 호출 전에 위젯의 영역을 지웁니다. Qt::WA_OpaquePaintEvent 위젯 속성이 설정되어 있으면, 위젯은 모든 픽셀을 불투명한 색으로 칠합니다.

repaint(), paintEvent(), setUpdatesEnabled() 및 아날로그 시계도참조하세요 .

void QWidget::update(const QRect &rect)

이 함수는 과부하가 걸린 함수입니다.

이 버전은 위젯 내부의 직사각형 rect 을 업데이트합니다.

void QWidget::update(const QRegion &rgn)

이 함수는 과부하된 함수입니다.

이 버전은 위젯 내부의 rgn 영역을 다시 칠합니다.

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

이 함수는 과부하된 함수입니다.

이 버전은 위젯 내부의 사각형(x, y, w, h)을 업데이트합니다.

void QWidget::updateGeometry()

이 위젯이 변경되었으므로 지오메트리를 변경해야 할 수 있음을 레이아웃 시스템에 알립니다.

sizeHint() 또는 sizePolicy()가 변경된 경우 이 함수를 호출합니다.

명시적으로 숨겨진 위젯의 경우 updateGeometry()는 작동하지 않습니다. 위젯이 표시되는 즉시 레이아웃 시스템에 알림이 전송됩니다.

[protected slot] void QWidget::updateMicroFocus(Qt::InputMethodQuery query = Qt::ImQueryAll)

위젯의 마이크로 포커스를 업데이트하고 query 에 지정된 상태가 변경되었음을 입력 메서드에 알립니다.

QRegion QWidget::visibleRegion() const

페인트 이벤트가 발생할 수 있는 가려지지 않은 영역을 반환합니다.

보이는 위젯의 경우 다른 위젯에 가려지지 않은 영역의 근사치이며, 그렇지 않은 경우 빈 영역입니다.

repaint() 함수는 필요한 경우 이 함수를 호출하므로 일반적으로는 이 함수를 호출할 필요가 없습니다.

[virtual protected] void QWidget::wheelEvent(QWheelEvent *event)

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

이 핸들러를 재구현하는 경우 이벤트를 처리하지 않을 경우 이벤트를 ignore() 처리해야 위젯의 부모가 이벤트를 해석할 수 있으므로 매우 중요합니다.

기본 구현은 이벤트를 무시합니다.

QEvent::ignore(), QEvent::accept(), event() 및 QWheelEvent 을참조하세요 .

WId QWidget::winId() const

위젯의 창 시스템 식별자를 반환합니다.

원칙적으로 이식 가능하지만, 이 함수를 사용하면 이식 불가능한 작업을 수행하려고 할 수 있습니다. 조심하세요.

위젯이 네이티브가 아닌(외래) 위젯이고 winId()가 호출되면 해당 위젯에 네이티브 핸들이 제공됩니다.

이 값은 런타임에 변경될 수 있습니다. 창 시스템 식별자가 변경되면 QEvent::WinIdChange 유형의 이벤트가 위젯으로 전송됩니다.

find()도 참조하세요 .

QWidget *QWidget::window() const

이 위젯의 창, 즉 창 시스템 프레임을 가지고 있거나 가질 수 있는 다음 조상 위젯을 반환합니다.

위젯이 창인 경우, 위젯 자체가 반환됩니다.

일반적인 사용법은 창 제목을 변경하는 것입니다:

aWidget->window()->setWindowTitle("New Window Title");

isWindow()도 참조하세요 .

QWindow *QWidget::windowHandle() const

네이티브 위젯인 경우 연결된 QWindow 을 반환합니다. 그렇지 않으면 null을 반환합니다.