QFlags Class

label->setAlignment(Qt::AlignLeft | Qt::AlignTop);
label->setAlignment({ });

class MyClass_1
{
public:
    enum Option {
        NoOptions = 0x0,
        ShowTabs = 0x1,
        ShowAll = 0x2,
        SqueezeBlank = 0x4
    };
    Q_DECLARE_FLAGS(Options, Option)
    //...
};

Q_DECLARE_OPERATORS_FOR_FLAGS(MyClass_1::Options)

class MyClass_2
{
    Q_OBJECT
public:
    enum Option {
        NoOptions = 0x0,
        ShowTabs = 0x1,
        ShowAll = 0x2,
        SqueezeBlank = 0x4
    };
    Q_DECLARE_FLAGS(Options, Option)
    Q_FLAG(Options)
    //...
};

Q_DECLARE_OPERATORS_FOR_FLAGS(MyClass_2::Options)

成员函数文档

[constexpr noexcept default] QFlags::QFlags()

创建一个未设置任何标志的 QFlags 对象。

[constexpr noexcept] QFlags::QFlags(Enum flags)

创建一个 QFlags 对象，用于存储flags 。

[constexpr noexcept] QFlags::QFlags(QFlag flag) requires (sizeof(Enum) == sizeof(int))

构建一个初始化值为整数flag 的QFlags对象。

QFlag 类型是一种辅助类型。在此处使用它而非int ，可以有效确保任意枚举值无法被强制转换为 QFlags，而未指定类型的枚举值（即int 值）则可以。

此构造函数仅适用于 32 位的Enum 类型。若要支持所有枚举大小，请考虑使用std::in_place_t 来构建。

[constexpr noexcept] QFlags::QFlags(std::initializer_list<Enum> flags)

构建一个 QFlags 对象，该对象通过位或运算符将所有flags 组合后进行初始化。

另请参阅 operator|=() 和operator|()。

[constexpr noexcept, since 6.9] QFlags::QFlags(std::in_place_t, QFlags<T>::Int flags)

创建一个初始化值为整数flags 的QFlags对象。

该函数在 Qt 6.9 中引入。

[implicit] QFlags::QFlags(const QFlags<T> &other)

创建other 的副本。

[static constexpr noexcept, since 6.2] QFlags<T> QFlags::fromInt(QFlags<T>::Int i)

创建一个QFlags 对象，该对象表示整数值i 。

该函数于 Qt 6.2 中引入。

[constexpr noexcept] QFlags<T> &QFlags::setFlag(Enum flag, bool on = true)

如果 `on ` 为 `true `，则设置标志 `flag `；如果 `on ` 为 `false`，则清除该标志。返回对此对象的引用。

[constexpr noexcept, since 6.2] bool QFlags::testAnyFlag(Enum flag) const

如果flag 中设置的任何标志在此标志对象中也已设置，则返回true ；否则返回false 。如果flag 中未设置任何标志，则返回值始终为false 。

该函数在 Qt 6.2 中引入。

另请参阅 testFlag()。

[constexpr noexcept, since 6.2] bool QFlags::testAnyFlags(QFlags<T> flags) const

如果flags 中设置的任何标志在此标志对象中也被设置，则返回true ；否则返回false 。如果flags 中未设置任何标志，则返回值始终为false 。

该函数在 Qt 6.2 中引入。

另请参阅 testFlags()。

[constexpr noexcept] bool QFlags::testFlag(Enum flag) const

如果标志flag 被设置，则返回true ；否则返回false 。

另请参阅 testAnyFlag()。

[constexpr noexcept, since 6.2] bool QFlags::testFlags(QFlags<T> flags) const

如果该标志对象与给定的flags 匹配，则返回true 。

如果 `flags ` 设置了任何标志，则当 `flags ` 中设置的所有标志也均在此标志对象中设置时，该标志对象才被视为完全匹配。反之，当 `flags ` 未设置任何标志时，该标志对象仅在同样未设置任何标志的情况下才被视为匹配。

该函数在 Qt 6.2 中引入。

另请参阅 testAnyFlags()。

[constexpr noexcept, since 6.2] QFlags<T>::Int QFlags::toInt() const

将QFlags 对象中存储的值作为整数返回。请注意，返回的整数可能是带符号的，也可能是无符号的，这取决于枚举的底层类型是带符号的还是无符号的。

该函数在 Qt 6.2 中引入。

另请参阅 Int 。

[constexpr noexcept] QFlags::operator QFlags<T>::Int() const

返回QFlags 对象中存储的值，该值以整数形式返回。

另请参阅 Int 。

[constexpr noexcept] bool QFlags::operator!() const

如果未设置标志（即，如果由QFlags 对象存储的值为0），则返回true ；否则返回false 。

[constexpr noexcept] QFlags<T> QFlags::operator&(int mask) const

返回一个QFlags 对象，其中包含该对象与mask 进行位与运算的结果。

如果定义了QT_TYPESAFE_FLAGS 宏，则此运算符将被禁用。请注意，即使对于64位QFlags ，该运算符也不会扩展到64位：若需支持64位，请使用类型安全的重载。

另请参阅 operator&=()、operator|()、operator^() 和operator~()。

[constexpr noexcept] QFlags<T> QFlags::operator&(Enum mask) const

[constexpr noexcept, since 6.2] QFlags<T> QFlags::operator&(QFlags<T> mask) const

该函数在 Qt 6.2 中引入。

[constexpr noexcept] QFlags<T> QFlags::operator&(uint mask) const

如果定义了QT_TYPESAFE_FLAGS 宏，则该运算符将被禁用。请注意，对于 64 位QFlags ，该运算符也不会扩展到 64 位：若需 64 位支持，请使用类型安全的重载。

[constexpr noexcept] QFlags<T> &QFlags::operator&=(int mask)

与mask 执行按位与（AND）运算，并将结果存储在此QFlags 对象中。返回对此对象的引用。

如果定义了QT_TYPESAFE_FLAGS 宏，则此运算符将被禁用。请注意，即使对于64位QFlags ，该运算符也不会扩展为64位：若需支持64位，请使用类型安全的重载。

另请参阅 operator&()、operator|=()、以及operator^=()。

[constexpr noexcept] QFlags<T> &QFlags::operator&=(Enum mask)

[constexpr noexcept, since 6.2] QFlags<T> &QFlags::operator&=(QFlags<T> mask)

该函数在 Qt 6.2 中引入。

[constexpr noexcept] QFlags<T> &QFlags::operator&=(uint mask)

如果定义了QT_TYPESAFE_FLAGS 宏，则该运算符将被禁用。请注意，对于 64 位QFlags ，该运算符也不会扩展为 64 位：若需 64 位支持，请使用类型安全的重载。

[implicit] int &QFlags::operator=(const QFlags<T> &other)

将other 赋值给此对象，并返回对此对象的引用。

[constexpr noexcept] QFlags<T> QFlags::operator^(QFlags<T> other) const

返回一个QFlags 对象，其中包含该对象与other 进行位异或运算后的结果。

另请参阅 operator^=()、operator&()、operator|() 和operator~()。

[constexpr noexcept] QFlags<T> QFlags::operator^(Enum other) const

[constexpr noexcept] QFlags<T> &QFlags::operator^=(QFlags<T> other)

与other 执行位异或（XOR）运算，并将结果存储在此QFlags 对象中。返回对此对象的引用。

另请参阅 operator^()、operator&=() 和operator|=()。

[constexpr noexcept] QFlags<T> &QFlags::operator^=(Enum other)

[constexpr noexcept] QFlags<T> QFlags::operator|(QFlags<T> other) const

返回一个QFlags 对象，其中包含该对象与other 进行位或运算后的结果。

另请参阅 operator|=()、operator^()、operator&() 以及operator~()。

[constexpr noexcept] QFlags<T> QFlags::operator|(Enum other) const

[constexpr noexcept] QFlags<T> &QFlags::operator|=(QFlags<T> other)

与other 执行位或运算，并将结果存储在此QFlags 对象中。返回对此对象的引用。

另请参阅 operator|()、operator&=() 和operator^=()。

[constexpr noexcept] QFlags<T> &QFlags::operator|=(Enum other)

[constexpr noexcept] QFlags<T> QFlags::operator~() const

返回一个QFlags 对象，其中包含该对象的位运算取反结果。

另请参阅 operator&()、operator|() 和operator^()。

typedef QFlags<Enum> Flags;