위젯 스타일 참조

이 참조 문서는 Qt Widgets가 스타일을 어떻게 사용하는지 설명합니다. 스타일을 구현할 때 어떤 요소를 그려야 하고 Widgets가 어떤 정보를 전달하는지 확인하거나, 스타일을 인식하는 Widgets나 델리게이트를 작성하여 Qt Widgets가 그리는 것과 동일한 요소를 그릴 때 이 문서를 활용하십시오.

이 참조 문서는 다음 세 페이지로 나뉩니다:

• 버튼 및 입력 위젯 스타일 지정: 푸시 버튼, 체크박스 및 라디오 버튼, 도구 버튼, 콤보 박스, 스핀 박스, 슬라이더, 스크롤 바, 진행률 표시줄.
• 컨테이너 및 창의 스타일 지정: 탭 위젯, 그룹 박스, 스플리터, 툴박스, 툴바, 도크 위젯, 제목 표시줄, 크기 조정 핸들 및 러버 밴드.
• 메뉴 및 항목 뷰 스타일 지정: 메뉴, 메뉴 바, 항목 뷰 헤더, 트리 분기 표시기 및 항목 뷰 항목.

각 위젯에 대한 참조 목록

• 요소 트리. 위젯이 그리는 스타일 요소들(그리기 순서대로). 중첩된 요소는 ` QCommonStyle`에서 그 위에 있는 요소에 의해 그려집니다. 각 요소 옆에는, 해당 요소를 그릴 때 ` QCommonStyle `가 사용하는 하위 요소 사각형, 하위 컨트롤 및 픽셀 메트릭에 대한 참조 이름이 명시되어 있습니다. 사용자 정의 스타일에서는 그리기 구조를 다르게 구성할 수 있으며, 위젯이 호출하는 요소들만 고정되어 있습니다.
• 스크린샷. Fusion 스타일의 위젯으로, 요소들의 경계 사각형이 윤곽선으로 표시되어 있습니다. 색상은 사각형을 구별하기 위한 용도로만 사용됩니다. 겹치는 사각형은 서로 1픽셀 안쪽으로 그려집니다.
• 상태 플래그. QStyleOption::initFrom()이 설정하는 일반적인 플래그 외에도, 위젯이 스타일 옵션에 설정하는 ` QStyle::StateFlag ` 값들입니다.
• 스타일 옵션 멤버. 위젯의 ` QStyleOption ` 하위 클래스의 멤버와 위젯이 해당 멤버에 저장하는 내용입니다.

일반적인 상태 플래그와 멤버에 대한 설명은 ‘스타일이 위젯을 그리는 방법’에서 확인할 수 있습니다.

이 참조 문서에서 다루지 않는 내용

위젯은 또한 그리기와 무관한 계산에도 스타일을 사용합니다. 위젯은 sizeFromContents()를 통해 크기 힌트를, pixelMetric()를 통해 프레임 너비와 여백을, subElementRect()를 통해 하위 요소의 위치를 요청합니다. 참조 문서에는 각 위젯이 조회하는 콘텐츠 유형과 픽셀 메트릭이 명시되어 있지만, 내장 스타일이 이를 어떻게 계산하는지에 대해서는 설명하지 않습니다. 스타일이 이러한 계산을 수행하는 방식은 스타일 자체에 달려 있습니다. Qt는 특정 구조를 강제하지 않습니다. 확실하지 않은 경우, QCommonStyle 구현을 참고하십시오.