QFlags Class

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

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

Q_DECLARE_OPERATORS_FOR_FLAGS(MyClass::Options)

Q_FLAG(Options)

成员函数文档

[constexpr noexcept] QFlags::QFlags()

构造一个未设置标志的 QFlags 对象。

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

构造一个 QFlags 对象，存储flags 。

[constexpr noexcept] QFlags::QFlags(QFlag flag)

构造一个 QFlags 对象，用整数flag 进行初始化。

QFlag 类型是一种辅助类型。通过使用它而不是int ，我们有效地确保了任意枚举值不能被转换为 QFlags，而未键入的枚举值（即int 值）则可以。

该构造函数仅适用于 32 位Enum 类型。为支持所有枚举大小，可考虑使用std::in_place_t 构造函数。

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

构造一个 QFlags 对象，初始化时使用位顺时针 OR 运算符将所有flags 组合在一起。

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

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

构造一个 QFlags 对象，初始化为整数flags 。

该函数在 Qt 6.9 中引入。

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

构造other 的副本。

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

构造表示整数值i 的QFlags 对象。

该函数在 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 中设置的任何标志也在此 flags 对象中设置，则返回true ，否则返回false 。如果flag 没有设置任何标志，则返回值总是false 。

此函数在 Qt 6.2 中引入。

另请参阅 testFlag() 。

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

如果flags 中设置的任何标志也在此 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 对象与给定的flags 匹配，则返回true 。

如果flags 已设置任何标志，则如果flags 中设置的所有标志也在此 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<T>::Int 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 执行位和运算，并将结果存储在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 位，请使用类型安全重载。

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

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

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

返回QFlags 对象，其中包含对该对象和other 进行比特 XOR 运算的结果。

另请参阅 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 进行位操作 OR 的结果。

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

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

这是一个重载函数。

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

对other 执行位顺时针 OR 运算，并将结果存储在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;