ウィジェットスタイルリファレンス

このリファレンスでは、Qt Widgetsがスタイルをどのように利用しているかを説明しています。スタイルを実装する際、どの要素を描画する必要があるか、またウィジェットからどのような情報が渡されるかを確認するために利用してください。また、スタイルに対応したウィジェットやデリゲートを作成し、Qt Widgetsが描画するのと同じ要素を描画する場合にも活用してください。

このリファレンスは、以下の3つのページに分かれています：

• ボタンおよび入力ウィジェットのスタイル設定：プッシュボタン、チェックボックスおよびラジオボタン、ツールボタン、コンボボックス、スピンボックス、スライダー、スクロールバー、プログレスバー。
• コンテナおよびウィンドウのスタイリング：タブウィジェット、グループボックス、スプリッター、ツールボックス、ツールバー、ドックウィジェット、タイトルバー、サイズグリップ、およびラバーバンド。
• メニューおよびアイテムビューのスタイル設定：メニュー、メニューバー、アイテムビューヘッダー、ツリーブランチインジケータ、およびアイテムビューアイテム。

各ウィジェットのリファレンスに記載されている内容

• 要素ツリー。ウィジェットが描画するスタイル要素を、描画順に示しています。 ネストされた要素は、QCommonStyle において、その直上の要素によって描画されます。各要素の横には、QCommonStyle がその要素を描画する際に使用するサブ要素の矩形、サブコントロール、およびピクセル単位のメトリックがリファレンスに記載されています。独自のスタイルでは、描画の構造を異なる方法で行うことができます。ウィジェットが呼び出す要素のみが固定されています。
• スクリーンショット。Fusionスタイルのウィジェットで、各要素の境界矩形が輪郭線で示されています。色は矩形を区別するためのものであり、色が同じ矩形は互いに1ピクセルずつ内側に重なるように描画されます。
• 状態フラグ。 QStyleOption::initFrom()が設定する一般的なフラグに加え、ウィジェットがそのスタイルオプションに設定するQStyle::StateFlag の値。
• スタイルオプションのメンバ。ウィジェットのQStyleOption サブクラスのメンバと、ウィジェットがそれらに格納する内容。

一般的な状態フラグおよびメンバについては、「スタイルによるウィジェットの描画方法」で説明されています。

このリファレンスで省略されている事項

ウィジェットは、描画とは関係のない計算にもスタイルを使用します。ウィジェットは、sizeFromContents() でサイズヒントを、pixelMetric() でフレームの幅や余白を、subElementRect() で子要素の位置をスタイルに問い合わせます。 リファレンスでは、各ウィジェットが照会するコンテンツタイプやピクセル単位のメトリックが記載されていますが、組み込みスタイルがそれらをどのように計算するかについては説明されていません。スタイルがこれらの計算をどのように行うかは、スタイル次第です。Qtは特定の構造を強制しません。不明な点がある場合は、QCommonStyle の実装を参照してください。