QStyleOptionToolButton Class
QStyleOptionToolButton クラスは、ツールボタンの描画に関するパラメータを定義するために使用されます。詳細...
| ヘッダー: | #include <QStyleOptionToolButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 継承元: | QStyleOptionComplex |
パブリック型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup } |
| flags | ToolButtonFeatures |
パブリック関数
| QStyleOptionToolButton() | |
| QStyleOptionToolButton(const QStyleOptionToolButton &other) | |
| QStyleOptionToolButton & | operator=(const QStyleOptionToolButton &) |
パブリック変数
| Qt::ArrowType | arrowType |
| QStyleOptionToolButton::ToolButtonFeatures | features |
| QFont | font |
| QIcon | icon |
| QSize | iconSize |
| QPoint | pos |
| QString | text |
| Qt::ToolButtonStyle | toolButtonStyle |
詳細な説明
QStyleOptionToolButton には、QStyle の関数がQToolButton を描画するために必要なすべての情報が含まれています。
パフォーマンス上の理由から、メンバ関数は少なく、メンバ変数へのアクセスは直接行われます（つまり、. または-> 演算子を使用します）。これにより、構造体の使用が簡単になり、これらが単にスタイル関数によって使用されるパラメータであるということが強調されます。
QStyleOption 、QStyleOptionComplex 、およびQStyleOptionButtonも参照してください 。
メンバ型のドキュメント
enum QStyleOptionToolButton::StyleOptionType
この列挙型は、スタイルオプションのタイプに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | 指定されたスタイルオプションのタイプ（このクラスでは `SO_ToolButton `）。 |
この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって、スタイルオプションの型を判別するために内部的に使用されます。一般的に、独自のQStyleOption サブクラスや独自のスタイルを作成する場合を除き、この点について気にする必要はありません。
StyleOptionVersionも参照してください 。
enum QStyleOptionToolButton::StyleOptionVersion
この列挙型は、スタイルオプションのバージョンに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionToolButton::Version | 1 | 1 |
このバージョンは、互換性を損なうことなく拡張機能を実装するために、QStyleOption のサブクラスで使用されます。qstyleoption_cast() を使用する場合、通常、これを確認する必要はありません。
StyleOptionTypeも参照してください 。
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
ツールボタンが持つさまざまな機能について説明します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | 通常のツールボタンです。 |
QStyleOptionToolButton::Arrow | 0x01 | ツールボタンは矢印です。 |
QStyleOptionToolButton::Menu | 0x04 | このツールボタンにはメニューがあります。 |
QStyleOptionToolButton::PopupDelay | 0x08 | メニューが表示されるまでに遅延があります。 |
QStyleOptionToolButton::HasMenu | 0x10 | このボタンにはポップアップメニューがあります。 |
QStyleOptionToolButton::MenuButtonPopup | Menu | ボタンには、メニューが存在することを示すために矢印が表示される必要があります。 |
ToolButtonFeatures 型は、QFlags<ToolButtonFeature> の typedef です。これは、ToolButtonFeature 値の OR 組み合わせを格納します。
features 、QToolButton::toolButtonStyle()、およびQToolButton::popupMode()も参照してください 。
メンバ関数のドキュメント
QStyleOptionToolButton::QStyleOptionToolButton()
QStyleOptionToolButton を作成し、メンバー変数をデフォルト値に初期化します。
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
other スタイルオプションのコピーを作成します。
[noexcept default] QStyleOptionToolButton &QStyleOptionToolButton::operator=(const QStyleOptionToolButton &)
other をこのQStyleOptionToolButton インスタンスにコピー代入します。
メンバ変数のドキュメント
Qt::ArrowType QStyleOptionToolButton::arrowType
この変数には、ツールボタンの矢印の方向が格納されます
この値は、features にArrow が含まれている場合にのみ使用されます。デフォルト値はQt::DownArrow です。
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
この変数には、ツールボタンの機能のOR結合が格納されます
デフォルト値は `None` です。
「ToolButtonFeature」も参照してください 。
QFont QStyleOptionToolButton::font
この変数には、テキストに使用されるフォントが格納されます
この値は、toolButtonStyle がQt::ToolButtonTextUnderIcon 、Qt::ToolButtonTextBesideIcon 、またはQt::ToolButtonTextOnly に設定されている場合にのみ使用されます。デフォルトでは、アプリケーションの既定のフォントが使用されます。
QIcon QStyleOptionToolButton::icon
この変数には、ツールボタンのアイコンが格納されます
デフォルト値は空のアイコン、つまりピクマップもファイル名も指定されていないアイコンです。
iconSizeも参照してください 。
QSize QStyleOptionToolButton::iconSize
この変数には、ツールボタンのアイコンのサイズが格納されます
デフォルト値はQSize （-1, -1）であり、これは無効なサイズです。
QPoint QStyleOptionToolButton::pos
この変数には、ツールボタンの位置が格納されます
デフォルト値は原点、すなわち (0, 0) です
QString QStyleOptionToolButton::text
この変数には、ツールボタンのテキストが格納されます
この値は、toolButtonStyle がQt::ToolButtonTextUnderIcon 、Qt::ToolButtonTextBesideIcon 、またはQt::ToolButtonTextOnly の場合にのみ使用されます。デフォルト値は空の文字列です。
Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle
この変数には、ツールボタンの外観を記述するQt::ToolButtonStyle 値が格納されます
デフォルト値は `Qt::ToolButtonIconOnly` です。
QToolButton::toolButtonStyle()も参照してください 。
© 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.
