QStyleOptionMenuItem Class
QStyleOptionMenuItemクラスは、メニュー項目の描画に必要なパラメータを記述するために使用します。詳細...
| ヘッダー | #include <QStyleOptionMenuItem> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 継承： | 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 )。 |
この型は、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"のようになる。
メニュー項目にショートカットがない場合は、メニュー項目のテキストだけが格納される。デフォルト値は空文字列です。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
