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 & | operator=(const QStyleOptionMenuItem &) |
パブリック変数
| 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 | TearOff + 2 | メニューの空き領域。 |
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 スタイルオプションのコピーを作成します。
[noexcept default] QStyleOptionMenuItem &QStyleOptionMenuItem::operator=(const QStyleOptionMenuItem &)
other をこのQStyleOptionMenuItem インスタンスにコピー代入します。
メンバ変数のドキュメント
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
この変数には、メニュー項目のチェックマークのタイプが格納されます
デフォルト値は `NotCheckable` です。
「CheckType」も参照してください 。
bool QStyleOptionMenuItem::checked
この変数は、メニュー項目がチェックされているかどうかを保持します
デフォルト値は false です。
QFont QStyleOptionMenuItem::font
この変数には、メニュー項目のテキストに使用されるフォントが格納されます
これは、ショートカットを除いたメニューテキストの描画に使用するフォントです。ショートカットは通常、ペインターのフォントを使用して描画されます。デフォルトでは、アプリケーションの既定のフォントが使用されます。
QIcon QStyleOptionMenuItem::icon
この変数には、メニュー項目のアイコンが格納されます
デフォルト値は空のアイコン、つまりピクマップもファイル名も指定されていないアイコンです。
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
この変数には、メニュー項目のテキストが格納されます
なお、テキストの形式は「メニューテキスト\tショートカット」のような形式になります。
メニュー項目にショートカットがない場合は、メニュー項目のテキストのみが含まれます。デフォルト値は空の文字列です。
© 2026 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.
