QStyleOptionMenuItem Class
QStyleOptionMenuItemクラスは、メニュー項目を描画するために必要なパラメータを記述するために使用します。詳細...
| Header: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Inherits: | QStyleOption |
パブリック型
| enum | CheckType { NotCheckable, Exclusive, NonExclusive } |
| enum | MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
パブリック関数
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) |
パブリック変数
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
詳細説明
QStyleOptionMenuItem には、QStyle 関数がQMenu からメニュー項目を描画するために必要なすべての情報が含まれています。また、他のメニュー関連ウィジェットを描画するためにも使用されます。
パフォーマンス上の理由から、メンバ関数はほとんどなく、メンバ変数へのアクセスは直接（つまり、. または-> 演算子を使用）です。これにより、構造体を簡単に使用できるようになり、これらは単にスタイル関数で使用されるパラメータであることが強調されます。
QStyleOptionも参照してください 。
メンバ型ドキュメント
enum QStyleOptionMenuItem::CheckType
この列挙型は、項目に対してチェックマークを描画するかどうか、あるいは全く描画しないかどうかを示すのに使われます。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | 項目はチェック可能ではない。 |
QStyleOptionMenuItem::Exclusive | 1 | 項目は排他的チェック項目です（ラジオボタンのような）。 |
QStyleOptionMenuItem::NonExclusive | 2 | 項目は非排他的チェック項目です（チェックボックスのような）。 |
checkType 、QAction::checkable 、QAction::checked 、QActionGroup::exclusionPolicyも参照 。
enum QStyleOptionMenuItem::MenuItemType
この列挙型は、構造体が記述するメニュー項目のタイプを示します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | 通常のメニュー項目。 |
QStyleOptionMenuItem::DefaultItem | 1 | QMenu::defaultAction() で指定されたデフォルト・アクションであるメニュー項目。 |
QStyleOptionMenuItem::Separator | 2 | メニュー・セパレータ。 |
QStyleOptionMenuItem::SubMenu | 3 | メニュー項目がサブメニューを指していることを示す。 |
QStyleOptionMenuItem::Scroller | 4 | ポップアップメニュースクローラー（現在macOSでのみ使用）。 |
QStyleOptionMenuItem::TearOff | 5 | メニューの切り離しハンドル。 |
QStyleOptionMenuItem::Margin | 6 | メニューのマージン |
QStyleOptionMenuItem::EmptyArea | 7 | メニューの空領域。 |
menuItemTypeも参照 。
enum QStyleOptionMenuItem::StyleOptionType
この列挙型は、スタイル・オプションのタイプに関する情報を保持するために使用され、QStyleOption のサブクラスごとに定義されます。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | 提供されるスタイルオプションの型 (SO_MenuItem for this class)。 |
この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって内部的に使用され、スタイル・オプションの型を決定します。一般に、独自のQStyleOption サブクラスと独自のスタイルを作成するのでなければ、これを気にする必要はありません。
StyleOptionVersionも参照してください 。
enum QStyleOptionMenuItem::StyleOptionVersion
この列挙型は、スタイル・オプションのバージョンに関する情報を保持するために使用され、QStyleOption のサブクラスごとに定義されます。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionMenuItem::Version | 1 | 1 |
このバージョンは、QStyleOption サブクラスが互換性を壊すことなく拡張を実装するために使用されます。qstyleoption_cast() を使用する場合、通常は確認する必要はありません。
StyleOptionTypeも参照 。
メンバ関数 ドキュメント
QStyleOptionMenuItem::QStyleOptionMenuItem()
QStyleOptionMenuItem を構築し、メンバ変数をデフォルト値に初期化します。
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
other スタイル・オプションのコピーを構築します。
メンバ変数 ドキュメント
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
この変数は、メニュー項目のチェックマークのタイプを保持します。
デフォルト値はNotCheckable 。
CheckTypeも参照 。
bool QStyleOptionMenuItem::checked
この変数は、メニュー項目がチェックされているかどうかを保持します。
デフォルト値はfalseである。
QFont QStyleOptionMenuItem::font
この変数はメニュー項目のテキストに使われるフォントを保持する。
これはショートカットを除いたメニューテキストを描画するために使われるフォントです。ショートカットは通常ペインターのフォントを使って描画されます。デフォルトでは、アプリケーションのデフォルトフォントが使われます。
QIcon QStyleOptionMenuItem::icon
この変数はメニュー項目のアイコンを保持します。
デフォルト値は空のアイコン、すなわちpixmapもファイル名もないアイコンです。
int QStyleOptionMenuItem::maxIconWidth
この変数はメニュー項目のアイコンの最大幅を保持する。
これは、アイコンを正しい位置に描画したり、アイテムを適切に整列させるために使用することができる。この変数は、メニュー項目にアイコンがあるかどうかに関係なく設定されなければならない。デフォルト値は0である。
bool QStyleOptionMenuItem::menuHasCheckableItems
この変数はメニュー全体にチェック可能な項目があるかどうかを保持する。
デフォルト値はtrueである。
このオプションがfalseに設定された場合、メニューはチェック可能な項目を持たない。これにより、GUIスタイルでは通常チェックカラムに使われる水平スペースを節約することができる。
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
この変数はメニュー項目のタイプを保持する。
デフォルト値はNormal です。
MenuItemTypeも参照 。
QRect QStyleOptionMenuItem::menuRect
この変数はメニュー全体の矩形を保持します。
デフォルト値はヌル矩形、すなわち幅と高さの両方が0に設定された矩形である。
int QStyleOptionMenuItem::reservedShortcutWidth
この変数はメニュー項目のショートカットの予約幅を保持する。
QMenu は、メニュー内のすべての可視アイテムの中で最も幅の広いショートカットが占める幅を設定する。
デフォルト値は0である。
QString QStyleOptionMenuItem::text
この変数はメニュー項目のテキストを保持する。
テキストの書式は "Menu texttShortcut"のようになる。
メニュー項目にショートカットがない場合は、メニュー項目のテキストだけが格納される。デフォルト値は空の文字列です。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
