Gestaltung von Schaltflächen und Eingabe-Widgets

Diese Seite ist Teil der Widget-Stilreferenz. Eine Erläuterung der Elementbäume, Screenshots und Tabellen finden Sie auf dieser Seite. Die allgemeinen Statusflags und Mitglieder, die jedes Widget setzt, sind unter „Wie ein Stil ein Widget zeichnet“ aufgeführt.

Drucktasten

QPushButton zeichnet ein einzelnes Steuerelement, „ CE_PushButton “, mit einem „ QStyleOptionButton “. „ QCommonStyle “ unterteilt es in die Abschrägung, die Beschriftung und den Fokusrahmen:

• CE_PushButton
  • CE_PushButtonBevel (PM_ButtonDefaultIndicator, PM_MenuButtonIndicator)
    • PE_FrameDefaultButton, für die Standardschaltfläche
    • PE_PanelButtonCommand
    • PE_IndicatorArrowDown, für eine Schaltfläche mit Menü
  • CE_PushButtonLabel (SE_PushButtonContents, PM_ButtonShiftHorizontal, PM_ButtonShiftVertical, PM_ButtonIconSize)
  • PE_FrameFocusRect (SE_PushButtonFocusRect)

Die Schaltfläche berechnet ihren Größenhinweis mit CT_PushButton und PM_ButtonMargin. Die Elementgrenzen variieren je nach Stil. In QCommonStyle liefert PE_FrameDefaultButton das gesamte abgeschrägte Rechteck, ebenso wie PE_PanelButtonCommand – außer bei einer Schaltfläche mit automatischer Standardeinstellung, bei der sich der Rahmen auf jeder Seite um PM_ButtonDefaultIndicator verkleinert.

QPushButton Setzt folgende Statusflags:

Die weiteren Elemente von „ QStyleOptionButton “ sind:

Kontrollkästchen und Optionsfelder

QCheckBox und „ QRadioButton “ weisen identische Strukturen auf. Beide verwenden „ QStyleOptionButton “ und zeichnen ein Steuerelement: „ CE_CheckBox “ oder „ CE_RadioButton “. „ QCommonStyle “ zeichnet die Markierung, die Beschriftung und den Fokusrahmen:

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

Die Größenangaben verwenden CT_CheckBox und CT_RadioButton. „Styling a Checkbox: A Walkthrough“ verfolgt die Darstellung eines Kontrollkästchens anhand des Widget- und QCommonStyle -Codes.

Die Schaltflächen setzen folgende Statusflags:

Die anderen Elemente von „ QStyleOptionButton “ sind unter „Drucktasten“ aufgeführt.

Werkzeugschaltflächen

QToolButton zeichnet ein komplexes Steuerelement, „ CC_ToolButton “, mit einem „ QStyleOptionToolButton “. Es verfügt über zwei Unterelemente: die Schaltfläche selbst und, bei einer Schaltfläche mit „ a menu button “, die Menüanzeige.

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

Für Popups unter instant und delayed gibt es kein Menü-Unterelement, daher zeichnet QCommonStyle stattdessen PE_IndicatorArrowDown in der Ecke des Schaltflächenrechtecks. Der Größenhinweis verwendet CT_ToolButton, und die Schaltfläche greift auf SH_ToolButton_PopupDelay und SH_ToolButtonStyle zurück. Schaltflächen in einer Symbolleiste übernehmen ihre Symbolgröße von der Symbolleiste. Eigenständige Schaltflächen verwenden PM_ButtonIconSize.

QToolButton Setzt folgende Statusflags:

Die weiteren Elemente von „ QStyleOptionToolButton “ sind:

Kombinationsfelder

QComboBox zeichnet die Schaltfläche und die Beschriftung mit „ CC_ComboBox “ und „ CE_ComboBoxLabel “, jeweils mit einer „ QStyleOptionComboBox “. „ QCommonStyle “ lässt den Text der Beschriftung bei einer bearbeitbaren Liste weg, da dieser vom untergeordneten Element „ QLineEdit “ gezeichnet wird. Die Popup-Liste ist eine von einem Delegaten gezeichnete Elementansicht, doch der Stil steuert ihre Größe und Position mit „ SC_ComboBoxListBoxPopup “. Bei einem bearbeitbaren Feld legt der Stil mit „ SC_ComboBoxEditField “ fest, wo das Eingabefeld platziert wird; das Feld selbst ist ein „ QLineEdit “-Unterelement.

• CC_ComboBox (PM_ComboBoxFrameWidth)
  • SC_ComboBoxFrame
  • SC_ComboBoxArrow (PE_IndicatorArrowDown)
  • SC_ComboBoxEditField
  • SC_ComboBoxListBoxPopup, zur Positionierung des Popups
• CE_ComboBoxLabel (SC_ComboBoxEditField)

Der Größenhinweis verwendet „ CT_ComboBox “. Stilhinweise wie „ SH_ComboBox_Popup “, „ SH_ComboBox_PopupFrameStyle “ und „ SH_ComboBox_UseNativePopup “ legen fest, wie das Popup aussieht und sich verhält.

QComboBox setzt folgende Statusflags:

Die weiteren Elemente von „ QStyleOptionComboBox “ sind:

Drehfelder

QSpinBox, „ QDoubleSpinBox “ und „ QDateTimeEdit “ zeichnen „ CC_SpinBox “ mit „ QStyleOptionSpinBox “. Das Eingabefeld ist ein untergeordnetes Element von „ QLineEdit “, dessen Geometrie der Stil für „ SC_SpinBoxEditField “ zurückgibt.

• CC_SpinBox (PM_SpinBoxFrameWidth)
  • SC_SpinBoxFrame
  • SC_SpinBoxUp
    • PE_PanelButtonBevel
    • PE_IndicatorSpinUp oder PE_IndicatorSpinPlus, je nach buttonSymbols
  • SC_SpinBoxDown
    • PE_PanelButtonBevel
    • PE_IndicatorSpinDown oder PE_IndicatorSpinMinus
  • SC_SpinBoxEditField

Ein Stil muss die Schaltflächenfelder nicht unbedingt mit „ PE_PanelButtonBevel “ zeichnen. Der Größenhinweis verwendet „ CT_SpinBox “, und das Widget berücksichtigt Hinweise wie „ SH_SpinBox_ButtonsInsideFrame “, „ SH_SpinBox_StepModifier “ und „ SH_SpinControls_DisableOnBounds “.

Das Spin-Feld setzt dieses Statusflag:

Die weiteren Elemente von „ QStyleOptionSpinBox “ sind:

Schieberegler

QSlider Zeichnet „ CC_Slider “ mit „ QStyleOptionSlider “. Die Größenangabe wird anhand von „ PM_SliderThickness “ und „ CT_Slider “ berechnet, die Mindestgrößenangabe anhand von „ PM_SliderLength “.

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

QCommonStyle zeichnet nur die Skalenmarkierungen; die Rille und der Schieberegler sind immer stilabhängig. Stile müssen für ` SC_SliderTickmarks` kein Rechteck zurückgeben. Fusion gibt ein leeres Rechteck zurück und zeichnet die Skalenmarkierungen unterhalb des Schiebereglers in dem im Screenshot dargestellten Bereich. Das Widget greift auf ` SH_Slider_AbsoluteSetButtons`, ` SH_Slider_PageSetButtons` und ` SH_Slider_SnapToValue` zurück.

QDial verwendet dieselbe Option und zeichnet „ CC_Dial “ mit den Unterelementen „ SC_DialGroove “, „ SC_DialHandle “ und „ SC_DialTickmarks “.

QSlider Setzt folgende Statusflags:

QStyleOptionSlider bedient alle ` QAbstractSlider`s. Seine Mitglieder sind:

Bildlaufleisten

QScrollBar Zeichnet „ CC_ScrollBar “ mit „ QStyleOptionSlider “ an. Während der Benutzer den Schieberegler zieht, springt der Wert zurück, wenn der Mauszeiger weiter als „ PM_MaximumDragDistance “ außerhalb des Schiebereglers bewegt wird.

• 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 zeichnet jedes Untersteuerelement mit dem gleichnamigen Steuerelement. Einige Stile zeichnen die Linienindikatoren mit ` PE_IndicatorArrowUp ` und die anderen Pfeilprimitive sowie die Seitenbereiche mit ` PE_PanelButtonBevel`; dies hängt vom jeweiligen Stil ab. ` SC_ScrollBarFirst ` und ` SC_ScrollBarLast ` sind optionale Schaltflächen, die zu den Enden springen; die meisten Stile geben hierfür ein leeres Rechteck zurück. Der Größenhinweis verwendet ` CT_ScrollBar`, und zu den Verhaltenshinweisen gehören ` SH_ScrollBar_LeftClickAbsolutePosition`, ` SH_ScrollBar_ContextMenu` und ` SH_ScrollBar_Transient`.

QScrollBar Setzt folgende Statusflags:

Die Mitglieder von ` QStyleOptionSlider ` sind unter „Schieberegler“ aufgeführt. ` sliderPosition`, ` sliderValue`, ` pageStep` und ` upsideDown ` legen die Größe und Position des Schiebereglers fest.

Fortschrittsbalken

QProgressBar zeichnet ein Steuerelement, CE_ProgressBar, mit einem QStyleOptionProgressBar. QCommonStyle unterteilt es in die Leiste, den Inhalt und die Beschriftung:

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

Stile, die den Inhalt als eine Reihe von Blöcken darstellen, verwenden „ PE_IndicatorProgressChunk “. In „ QCommonStyle “ und „Fusion“ nehmen der Groove, der Inhalt und die Beschriftung den gesamten Balken ein; die Beschriftung ist zentrierter Text, der über den Inhalt gelegt wird, sodass ihr Rechteck kein separater Bereich ist. Der Größenhinweis verwendet „ CT_ProgressBar “. Ein „Busy“-Indikator – ein Balken, dessen Minimal- und Maximalwert beide Null sind – wird durch den Stil animiert.

QProgressBar setzt dieses Statusflag:

Die weiteren Elemente von „ QStyleOptionProgressBar “ sind: