버튼 및 입력 위젯 스타일 지정

이 페이지는 위젯 스타일 참조의 일부입니다. 요소 트리, 스크린샷 및 표에 대한 설명은 해당 페이지를 참조하십시오. 모든 위젯이 설정하는 일반적인 상태 플래그와 멤버는 '스타일이 위젯을 그리는 방법'에 나열되어 있습니다.

푸시 버튼

QPushButton 는 QStyleOptionButton 을 가진 단일 컨트롤 요소 CE_PushButton 를 그립니다. QCommonStyle 는 이를 베벨, 레이블, 포커스 프레임으로 나눕니다:

• CE_PushButton
  • CE_PushButtonBevel (PM_ButtonDefaultIndicator, PM_MenuButtonIndicator)
    • PE_FrameDefaultButton, 기본 버튼의 경우
    • PE_PanelButtonCommand
    • PE_IndicatorArrowDown, 메뉴가 있는 버튼의 경우
  • CE_PushButtonLabel (SE_PushButtonContents, PM_ButtonShiftHorizontal, PM_ButtonShiftVertical, PM_ButtonIconSize)
  • PE_FrameFocusRect (SE_PushButtonFocusRect)

이 버튼은 ` CT_PushButton ` 및 ` PM_ButtonMargin`을 사용하여 크기 힌트를 계산합니다. 요소의 경계는 스타일에 따라 다릅니다. ` QCommonStyle`에서는 ` PE_FrameDefaultButton `이 전체 베벨 사각형을 반환하며, ` PE_PanelButtonCommand`도 마찬가지입니다. 단, 자동 기본값 버튼의 경우 패널이 각 측면에서 ` PM_ButtonDefaultIndicator `만큼 축소됩니다.

QPushButton 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionButton 의 다른 멤버는 다음과 같습니다:

체크박스 및 라디오 버튼

QCheckBox 와 QRadioButton 는 구조가 동일합니다. 둘 다 QStyleOptionButton 를 사용하며, CE_CheckBox 또는 CE_RadioButton 중 하나의 컨트롤 요소를 그립니다. QCommonStyle 는 표시기, 레이블 및 포커스 프레임을 그립니다:

• CE_CheckBox
  • PE_IndicatorCheckBox (SE_CheckBoxIndicator, PM_IndicatorWidth, PM_IndicatorHeight)
  • CE_CheckBoxLabel (SE_CheckBoxContents, PM_CheckBoxLabelSpacing)
  • PE_FrameFocusRect (SE_CheckBoxFocusRect)
• CE_RadioButton
  • PE_IndicatorRadioButton (SE_RadioButtonIndicator, PM_ExclusiveIndicatorWidth, PM_ExclusiveIndicatorHeight)
  • CE_RadioButtonLabel (SE_RadioButtonContents, PM_RadioButtonLabelSpacing)
  • PE_FrameFocusRect (SE_RadioButtonFocusRect)

크기 힌트에는 CT_CheckBox 및 CT_RadioButton 이 사용됩니다. '체크박스 스타일 지정: 단계별 안내'에서는 위젯과 QCommonStyle 코드를 통해 체크박스가 그려지는 과정을 설명합니다.

버튼은 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionButton 의 다른 구성 요소들은 ‘푸시 버튼’ 항목에 나열되어 있습니다.

도구 버튼

QToolButton 는 QStyleOptionToolButton 가 있는 하나의 복합 컨트롤, CC_ToolButton 을 그립니다. 이 컨트롤에는 버튼 자체와, a menu button 가 설정된 버튼의 경우 메뉴 표시기라는 두 가지 하위 컨트롤이 있습니다.

• CC_ToolButton
  • SC_ToolButton
    • PE_PanelButtonTool (PM_DefaultFrameWidth)
    • PE_FrameFocusRect
    • CE_ToolButtonLabel (PM_ButtonShiftHorizontal, PM_ButtonShiftVertical)
  • SC_ToolButtonMenu (PM_MenuButtonIndicator)
    • PE_IndicatorButtonDropDown
    • PE_IndicatorArrowDown

instant 및 delayed 팝업의 경우 메뉴 하위 컨트롤이 없으므로, QCommonStyle 는 대신 버튼 사각형의 모서리에 PE_IndicatorArrowDown 를 그립니다. 크기 힌트는 CT_ToolButton 를 사용하며, 버튼은 SH_ToolButton_PopupDelay 및 SH_ToolButtonStyle 를 참조합니다. 툴바에 있는 도구 버튼은 툴바에서 아이콘 크기를 가져옵니다. 독립형 버튼은 PM_ButtonIconSize 를 사용합니다.

QToolButton 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionToolButton 의 다른 멤버는 다음과 같습니다.

콤보 박스

QComboBox CC_ComboBox 및 을 사용하여 버튼과 레이블을 그립니다. 두 요소 모두 을 사용합니다. 은 편집 가능한 상자의 경우 레이블 텍스트를 생략하며, 이 경우 자식이 텍스트를 그립니다. 팝업 목록은 CE_ComboBoxLabel QStyleOptionComboBox QCommonStyle QLineEdit 델리게이트가 그리는 항목 뷰이지만, 스타일은 를 통해 그 크기와 위치를 제어합니다. 편집 가능한 상자의 경우, 스타일은 를 통해 라인 편집 상자의 위치를 결정하며, 필드 자체는 자식 요소입니다. SC_ComboBoxListBoxPopup SC_ComboBoxEditField QLineEdit

• CC_ComboBox (PM_ComboBoxFrameWidth)
  • SC_ComboBoxFrame
  • SC_ComboBoxArrow (PE_IndicatorArrowDown)
  • SC_ComboBoxEditField
  • SC_ComboBoxListBoxPopup, 팝업 위치 지정용
• CE_ComboBoxLabel (SC_ComboBoxEditField)

크기 힌트에는 ` CT_ComboBox`가 사용됩니다. ` SH_ComboBox_Popup`, ` SH_ComboBox_PopupFrameStyle`, ` SH_ComboBox_UseNativePopup `와 같은 스타일 힌트는 팝업의 모양과 동작 방식을 결정합니다.

QComboBox 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionComboBox 의 다른 구성원은 다음과 같습니다:

스핀 박스

QSpinBox, QDoubleSpinBox 및 QDateTimeEdit 는 QStyleOptionSpinBox 를 사용하여 CC_SpinBox 를 그립니다. 편집 필드는 QLineEdit 의 자식 요소이며, 이 스타일은 SC_SpinBoxEditField 에 대해 해당 기하학적 정보를 반환합니다.

• CC_SpinBox (PM_SpinBoxFrameWidth)
  • SC_SpinBoxFrame
  • SC_SpinBoxUp
    • PE_PanelButtonBevel
    • PE_IndicatorSpinUp 또는 PE_IndicatorSpinPlus, 다음 조건에 따라 buttonSymbols
  • SC_SpinBoxDown
    • PE_PanelButtonBevel
    • PE_IndicatorSpinDown 또는 PE_IndicatorSpinMinus
  • SC_SpinBoxEditField

스타일은 버튼 패널을 PE_PanelButtonBevel 로 그릴 필요가 없습니다. 크기 힌트는 CT_SpinBox 를 사용하며, 위젯은 SH_SpinBox_ButtonsInsideFrame, SH_SpinBox_StepModifier, SH_SpinControls_DisableOnBounds 와 같은 힌트를 참조합니다.

스핀 박스는 다음 상태 플래그를 설정합니다:

QStyleOptionSpinBox 의 다른 구성 요소는 다음과 같습니다:

슬라이더

QSlider QStyleOptionSlider 를 사용하여 를 그립니다. 크기 힌트는 및 에서 계산하며, 최소 크기 힌트는 에서 계산합니다. CC_Slider PM_SliderThickness CT_Slider PM_SliderLength

• CC_Slider (PM_SliderLength, PM_SliderControlThickness, PM_SliderTickmarkOffset, PM_SliderSpaceAvailable)
  • SC_SliderGroove
  • SC_SliderHandle
  • SC_SliderTickmarks

QCommonStyle 틱 표시만 그립니다. 홈과 핸들은 항상 스타일에 따라 다릅니다. 스타일은 SC_SliderTickmarks 에 대해 사각형을 반환할 필요가 없습니다. Fusion은 빈 사각형을 반환하고, 스크린샷에 표시된 영역인 핸들 아래에 틱을 그립니다. 위젯은 SH_Slider_AbsoluteSetButtons, SH_Slider_PageSetButtons 및 SH_Slider_SnapToValue 를 참조합니다.

QDial 동일한 옵션을 사용하며, SC_DialGroove, SC_DialHandle 및 SC_DialTickmarks 서브컨트롤을 사용하여 CC_Dial 를 그립니다.

QSlider 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionSlider 모든 ` QAbstractSlider` 객체를 처리합니다. 이 객체의 멤버는 다음과 같습니다:

스크롤 막대

QScrollBar QStyleOptionSlider 를 사용하여 를 그립니다. 사용자가 슬라이더를 드래그하는 동안, 포인터가 바 바깥쪽으로 보다 더 멀리 이동하면 바가 값을 원래 위치로 되돌립니다. CC_ScrollBar PM_MaximumDragDistance

• CC_ScrollBar (PM_ScrollBarExtent, PM_ScrollBarSliderMin)
  • SC_ScrollBarGroove
  • SC_ScrollBarSubLine (CE_ScrollBarSubLine)
  • SC_ScrollBarAddLine (CE_ScrollBarAddLine)
  • SC_ScrollBarSubPage (CE_ScrollBarSubPage)
  • SC_ScrollBarAddPage (CE_ScrollBarAddPage)
  • SC_ScrollBarFirst (CE_ScrollBarFirst)
  • SC_ScrollBarLast (CE_ScrollBarLast)
  • SC_ScrollBarSlider (CE_ScrollBarSlider)
  • PE_FrameFocusRect

QCommonStyle 동일한 이름의 컨트롤 요소를 사용하여 각 하위 컨트롤을 그립니다. 일부 스타일은 선 표시기를 PE_IndicatorArrowUp 및 기타 화살표 프리미티브로, 페이지 영역을 PE_PanelButtonBevel 로 그립니다. 이는 개별 스타일에 따라 다릅니다. SC_ScrollBarFirst 및 SC_ScrollBarLast 는 끝 부분으로 이동하는 선택적 버튼이며, 대부분의 스타일은 이에 대해 빈 사각형을 반환합니다. 크기 힌트는 CT_ScrollBar 를 사용하며, 동작 힌트에는 SH_ScrollBar_LeftClickAbsolutePosition, SH_ScrollBar_ContextMenu, SH_ScrollBar_Transient 가 포함됩니다.

QScrollBar 다음과 같은 상태 플래그를 설정합니다:

QStyleOptionSlider 의 멤버는 슬라이더 항목에 나열되어 있습니다. sliderPosition, sliderValue, pageStep 및 upsideDown 는 핸들의 크기와 위치를 결정합니다.

진행률 표시줄

QProgressBar CE_ProgressBar 를 사용하여 를 가진 하나의 컨트롤 요소를 그립니다. 는 이를 홈, 내용, 레이블로 나눕니다: QStyleOptionProgressBar QCommonStyle

• CE_ProgressBar
  • CE_ProgressBarGroove (SE_ProgressBarGroove)
  • CE_ProgressBarContents (SE_ProgressBarContents, PM_ProgressBarChunkWidth)
  • CE_ProgressBarLabel (SE_ProgressBarLabel)

콘텐츠를 일련의 청크(chunk) 행으로 그리는 스타일은 ` PE_IndicatorProgressChunk`을 사용합니다. ` QCommonStyle `과 `Fusion`에서는 그루브, 콘텐츠, 레이블이 모두 전체 막대를 차지합니다. 레이블은 콘텐츠 위에 중앙 정렬된 텍스트로 표시되므로, 레이블을 구성하는 사각형은 별도의 영역이 아닙니다. 크기 힌트에는 CT_ProgressBar 가 사용됩니다. 최소값과 최대값이 모두 0인 바인 ‘바쁜 상태 표시기’는 해당 스타일에 의해 애니메이션 처리됩니다.

QProgressBar 이 상태 플래그를 설정합니다:

QStyleOptionProgressBar 의 다른 멤버는 다음과 같습니다: