コンテナとウィンドウのスタイル設定

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

タブウィジェットとタブバー

QTabBar は、スタイルを通じてタブを描画します。タブバーは、QTabWidget の一部であるか、スタンドアロン型です。スタンドアロン型のバーは、独自のベースラインを描画します。タブウィジェットでは、ウィジェットがペインの周囲のフレームを描画し、その上にバーが配置されます。

QTabWidget PE_FrameTabWidget を を使用して描画します。スタイルに対して、タブバー、ペイン、コンテンツ、およびコーナーウィジェットをどこに配置するかを、 、 、 、 、 で問い合わせ、 によってバーとペインを重ね合わせます。QStyleOptionTabWidgetFrame SE_TabWidgetTabPane SE_TabWidgetTabContents SE_TabWidgetTabBar SE_TabWidgetLeftCorner SE_TabWidgetRightCorner PM_TabBarBaseOverlap

QTabBar タブのレイアウトはバー側で処理されるため、スタイルではタブの配置を制御できません。レイアウト処理中、バーはCT_TabBarTab を要求します。これには、ラベル周囲の余白であるPM_TabBarTabHSpace とPM_TabBarTabVSpace が含まれます。その後、各タブをCE_TabBarTab とQStyleOptionTab で描画します。選択されたタブは最後に描画されるため、スタイルによって隣接するタブの上に重ねて描画することが可能です。

• PE_FrameTabBarBase (PM_TabBarBaseHeight,PM_TabBarBaseOverlap) は、独立したバーの場合で、QStyleOptionTabBarBase
• CE_TabBarTab、タブごとに1回
  • CE_TabBarTabShape (PM_TabBarTabOverlap)
  • CE_TabBarTabLabel (SE_TabBarTabText,SE_TabBarTabLeftButton,SE_TabBarTabRightButton,PM_TabBarTabShiftHorizontal,PM_TabBarTabShiftVertical,PM_TabBarIconSize)
• PE_IndicatorTabClose、閉じ可能なタブの閉じるボタンによって描画されるもの（SH_TabBar_CloseButtonPosition 、PM_TabCloseIndicatorWidth 、PM_TabCloseIndicatorHeight ）
• PE_IndicatorTabTearLeft およびPE_IndicatorTabTearRight では、タブがスクロールボタンによって切り取られています（SE_TabBarTearIndicatorLeft 、SE_TabBarTearIndicatorRight ）

タブが画面に収まらない際に表示されるスクロールボタンはtool buttons です。このスタイルでは、SE_TabBarScrollLeftButton およびSE_TabBarScrollRightButton を使用して配置し、PM_TabBarScrollButtonWidth を使用してサイズを指定しています。また、このバーはSH_TabBar_Alignment 、SH_TabBar_ElideMode 、およびSH_TabBar_PreferNoArrows も参照しています。

QTabBar 各タブに対して、以下の状態フラグを設定します：

タブバーが有効になっている場合でも、個々のタブを無効にすることができます。タブバーがアクティブなときは、そのタブもアクティブになります。QStyleOptionTab のメンバは以下の通りです：

QStyleOptionTabWidgetFrame のメンバは以下の通りです:

QStyleOptionTabBarBase PE_FrameTabBarBase で使用されるこの構造体には、 、 、 、 というメンバーがあり、これらは同じ意味を持ちます。shape tabBarRect selectedTabRect documentMode

グループボックス

QGroupBox は、QStyleOptionGroupBox を持つ単一の複合コントロール（CC_GroupBox ）を描画します。そのサイズヒントは、PM_IndicatorWidth 、PM_IndicatorHeight 、およびPM_CheckBoxLabelSpacing から計算されます。

• CC_GroupBox
  • SC_GroupBoxFrame (PE_FrameGroupBox)
  • SC_GroupBoxLabel、drawItemText() で描画され、ボックスにフォーカスがある場合はPE_FrameFocusRect が追加されます
  • SC_GroupBoxCheckBox (PE_IndicatorCheckBox)、チェック可能なボックスの場合
  • SC_GroupBoxContents、子ウィジェット用の領域

スタイルヒント `SH_GroupBox_TextLabelVerticalAlignment ` および `SH_GroupBox_TextLabelColor ` はタイトルを制御します。Qtはチェックボックスの描画方法を規定していません。`QCommonStyle ` は `PE_IndicatorCheckBox` を使用するため、`Checkboxes` および `radio buttons` の下にある要素ツリーが適用されます。

QGroupBox 以下の状態フラグを設定します:

QStyleOptionGroupBox のその他のメンバーは次のとおりです。

スプリッター

QSplitterHandle は、プレーンなQStyleOption を使用して、1つのコントロール要素（CE_Splitter ）を描画します。スプリッターは、CT_Splitter およびPM_SplitterWidth を使用してハンドルのサイズを調整し、ユーザーがドラッグしている間に子要素のサイズを変更するかどうかを決定するためにSH_Splitter_OpaqueResize を呼び出します。

ハンドルは、initFrom() を呼び出すのではなく、オプション自体に値を設定します。以下の状態フラグを設定します：

ツールボックス

QToolBox は、ウィジェットのコレクションを保持し、ウィジェットごとに1つのタブボタンを縦方向に配置して、一度に1つずつ表示します。各ボタンは、`QStyleOptionToolBox` を使用して `CE_ToolBoxTab ` を描画し、ボタンには `PM_SmallIconSize ` がアイコンとして使用されます。

• CE_ToolBoxTab、1ページにつき1回
  • CE_ToolBoxTabShape
  • CE_ToolBoxTabLabel (SE_ToolBoxTabContents)

タブボタンは以下の状態フラグを設定します：

QStyleOptionToolBox のその他のメンバは以下の通りです:

ツールバー

ツールバーは、main window framework の一部です。メインウィンドウには4つのツールバー領域があり、各辺に沿って1つずつ配置されています。各領域には、数行のツールバーを配置できます。QMainWindow は、ツールバーを配置し、そのスタイルオプションのpositionメンバーに値を設定します。

QToolBar QStyleOptionToolBar を使用して、 を描画します。ツールバーが独自のウィンドウ内にフローティング表示される場合、その周囲に も描画されます。移動可能なツールバーはそのハンドルを描画し、アクション間の区切り線は を描画する小さなウィジェットです。CE_ToolBar PE_FrameMenu PE_IndicatorToolBarSeparator

• CE_ToolBar (PM_ToolBarFrameWidth,PM_ToolBarItemMargin,PM_ToolBarItemSpacing)
  • PE_PanelToolBar
• PE_FrameMenu、フローティングツールバーの場合
• PE_IndicatorToolBarHandle (SE_ToolBarHandle,PM_ToolBarHandleExtent)
• PE_IndicatorToolBarSeparator (PM_ToolBarSeparatorExtent)、各セパレータによって描画されます

バー内のツールボタンはCC_ToolButton を描画します。詳細は「ツールボタン」を参照してください。アイコンのサイズはデフォルトでPM_ToolBarIconSize に設定されています。アクションが収まらない場合、バーにはSP_ToolBarHorizontalExtensionButton またはSP_ToolBarVerticalExtensionButton のアイコンが付いた拡張ボタンが表示され、そのサイズはPM_ToolBarExtensionExtent によって決定されます。

QToolBar この状態フラグを設定します:

ツールバーが水平配置の場合、区切り線には `State_Horizontal ` が設定されたプレーンな `QStyleOption ` が使用されます。QStyleOptionToolBar のその他のメンバーは以下の通りです：

ドックウィジェット

QDockWidget は、アプリケーションがカスタムタイトルバーウィジェットをインストールしていないか、ドックウィジェットがネイティブのウィンドウ装飾とともにフローティング表示されていない限り、CE_DockWidgetTitle とQStyleOptionDockWidget を使用してタイトルバーを描画します。ネイティブの装飾がないフローティングドックウィジェットも、PE_FrameDockWidget を描画します。フローティングボタンと閉じるボタンはツールボタンであり、PE_PanelButtonTool を描画し、SP_TitleBarNormalButton およびSP_TitleBarCloseButton のアイコンを表示します。

• PE_FrameDockWidget (PM_DockWidgetFrameWidth)、フローティング状態のときは
• CE_DockWidgetTitle (SE_DockWidgetTitleBarText,SE_DockWidgetIcon,PM_DockWidgetTitleMargin)
• SE_DockWidgetFloatButton およびSE_DockWidgetCloseButton (PM_DockWidgetTitleBarButtonMargin) の場合、ボタンの位置は

QMainWindow は、PE_IndicatorDockWidgetResizeHandle を使用してドッキングされたウィジェット間にセパレータを描画し、そのサイズはPM_DockWidgetSeparatorExtent によって決定されます。ヒントSH_DockWidget_ButtonsHaveFrame は、タイトルバーのボタンに枠を表示するかどうかを決定します。

このタイトルバーオプションは、一般的なもの以外の状態フラグを設定しません。QStyleOptionDockWidget のメンバは以下の通りです：

タイトルバー

タイトルバー複合コントロール（CC_TitleBar ）は、QMdiArea 内のサブウィンドウのタイトルバーを描画します。これは、ウィンドウタイトルと、システムメニュー、最小化、最大化、および閉じるボタンで構成されています。一部のスタイルでは、ウィンドウの陰影付けやコンテキスト依存ヘルプ用のボタンも提供されます。

• CC_TitleBar (PM_TitleBarHeight,PM_TitleBarButtonSize,PM_TitleBarButtonIconSize)
  • SC_TitleBarSysMenu
  • SC_TitleBarLabel
  • SC_TitleBarMinButton,SC_TitleBarMaxButton,SC_TitleBarCloseButton,SC_TitleBarNormalButton
  • SC_TitleBarShadeButton,SC_TitleBarUnshadeButton,SC_TitleBarContextHelpButton

QCommonStyle 各ボタンを、PE_PanelButtonTool と、SP_TitleBarMenuButton からSP_TitleBarContextHelpButton までの対応する標準アイコンで描画します。サブウィンドウが最大化されると、QMdiSubWindow はそのボタンをメインウィンドウのメニューバーに移動し、CC_MdiControls およびサブコントロールSC_MdiMinButton 、SC_MdiNormalButton 、SC_MdiCloseButton を使用して描画します。

QStyleOptionTitleBar のメンバは以下の通りです：

サイズグリップ

QSizeGrip は、QStyleOptionSizeGrip を持つCE_SizeGrip という 1 つのコントロール要素を描画し、CT_SizeGrip を使用してそのサイズヒントを計算します。QStatusBar は、デフォルトでその隅にサイズグリップを表示します。

サイズグリップは、一般的なもの以外の状態フラグを設定しません。QStyleOptionSizeGrip には独自のメンバーが1つあります：

ラバーバンド

QRubberBand QStyleOptionRubberBand を使用して、 のコントロール要素を1つ描画します。スタイルでは、 スタイルヒントを使用してバンドの形状を指定できます。CE_RubberBand SH_RubberBand_Mask

このバンドは、一般的なものを除いて状態フラグを設定しません。QStyleOptionRubberBand のメンバは以下の通りです：