ボタンおよび入力ウィジェットのスタイル設定

このページは「ウィジェットスタイルリファレンス」の一部です。要素ツリー、スクリーンショット、および表に関する説明については、当該ページを参照してください。すべてのウィジェットが設定する共通の状態フラグおよびメンバーについては、「スタイルによるウィジェットの描画方法」に記載されています。

プッシュボタン

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 のいずれか1つのコントロール要素を描画します。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 を持つ 1 つの複合コントロール、CC_ToolButton を描画します。これには 2 つのサブコントロールがあります。ボタン自体と、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 を描画します。editフィールドは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 `CC_Slider `を`QStyleOptionSlider`で描画します。サイズヒントは`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 は、QStyleOptionProgressBar を持つCE_ProgressBar という 1 つのコントロール要素を描画します。QCommonStyle は、これを溝、内容、およびラベルに分割します：

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

コンテンツをチャンクの列として描画するスタイルでは、PE_IndicatorProgressChunk が使用されます。QCommonStyle および Fusion では、グルーヴ、コンテンツ、ラベルのすべてが小節全体を占めます。ラベルはコンテンツの上に中央揃えで描画されるテキストであるため、その矩形は独立した領域ではありません。 サイズヒントにはCT_ProgressBar が使用されます。ビジーインジケーター（最小値と最大値がともにゼロの小節）は、このスタイルによってアニメーション表示されます。

QProgressBar この状態フラグを設定します：

QStyleOptionProgressBar のその他のメンバーは以下の通りです：