内容

• 公共类型
• 公共函数
• 宏
• 详细描述
• 标志和元对象系统
• 命名约定

QFlags 类

The QFlags class provides a type-safe way of storing OR-combinations of enum values. 更多...

头：	#include <QFlags>

• 所有成员列表，包括继承成员

公共类型

typedef

enum_type

公共函数

	QFlags (const QFlags & other )
	QFlags (Enum flag )
	QFlags (Zero zero = 0)
	QFlags (QFlag value )
bool	testFlag (Enum flag ) const
	operator int () const
bool	operator! () const
QFlags	operator& (int mask ) const
QFlags	operator& (uint mask ) const
QFlags	operator& (Enum mask ) const
QFlags &	operator&= (int mask )
QFlags &	operator&= (uint mask )
QFlags &	operator= (const QFlags & other )
QFlags	operator^ (QFlags other ) const
QFlags	operator^ (Enum other ) const
QFlags &	operator^= (QFlags other )
QFlags &	operator^= (Enum other )
QFlags	operator| (QFlags other ) const
QFlags	operator| (Enum other ) const
QFlags &	operator|= (QFlags other )
QFlags &	operator|= (Enum other )
QFlags	operator~ () const

宏

	Q_DECLARE_FLAGS ( Flags , Enum )
	Q_DECLARE_OPERATORS_FOR_FLAGS ( Flags )

详细描述

The QFlags class provides a type-safe way of storing OR-combinations of enum values.

The QFlags <Enum> class is a template class, where Enum is an enum type. QFlags is used throughout Qt for storing combinations of enum values.

传统 C++ 存储枚举值 OR 组合的方式是使用 int or uint variable. The inconvenience with this approach is that there's no type checking at all; any enum value can be OR'd with any other enum value and passed on to a function that takes an int or uint .

Qt 使用 QFlags to provide type safety. For example, the Qt::Alignment type is simply a typedef for QFlags < Qt::AlignmentFlag >. QLabel::setAlignment () takes a Qt::Alignment parameter, which means that any combination of Qt::AlignmentFlag values,or 0, is legal:

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

If you try to pass a value from another enum or just a plain integer other than 0, the compiler will report an error. If you need to cast integer values to flags in a untyped fashion, you can use the explicit QFlags constructor as cast operator.

If you want to use QFlags for your own enum types, use the Q_DECLARE_FLAGS () 和 Q_DECLARE_OPERATORS_FOR_FLAGS ().

范例：

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)
					

You can then use the MyClass::Options type to store combinations of MyClass::Option 值。

标志和元对象系统

The Q_DECLARE_FLAGS () macro does not expose the flags to the meta-object system, so they cannot be used by Qt Script or edited in Qt Designer. To make the flags available for these purposes, the Q_FLAGS () macro must be used:

Q_FLAGS(Options)
					

命名约定

A sensible naming convention for enum types and associated QFlags types is to give a singular name to the enum type (e.g., 选项 ) and a plural name to the QFlags type (e.g., 选项 ). When a singular name is desired for the QFlags type (e.g., Alignment ), you can use Flag as the suffix for the enum type (e.g., AlignmentFlag ).

另请参阅 QFlag .

成员类型文档编制

typedef QFlags:: enum_type

用于枚举模板类型的 Typedef。

成员函数文档编制

QFlags:: QFlags (const QFlags & other )

构造副本为 other .

QFlags:: QFlags ( Enum flag )

构造 QFlags object storing the given flag .

QFlags:: QFlags ( Zero zero = 0)

构造 QFlags object with no flags set. zero must be a literal 0 value.

QFlags:: QFlags ( QFlag value )

构造 QFlags object initialized with the given integer value .

The QFlag type is a helper type. By using it here instead of int , we effectively ensure that arbitrary enum values cannot be cast to a QFlags , whereas untyped enum values (i.e., int values) can.

bool QFlags:: testFlag ( Enum flag ) const

返回 true 若 flag is set, otherwise false.

该函数在 Qt 4.2 引入。

QFlags:: operator int () const

返回值存储在 QFlags 对象作为整数。

bool QFlags:: operator! () const

Returns true if no flag is set (i.e., if the value stored by the QFlags object is 0); otherwise returns false.

QFlags QFlags:: operator& ( int mask ) const

返回 QFlags object containing the result of the bitwise AND operation on this object and mask .

另请参阅 operator&= (), operator| (), operator^ ()，和 operator~ ().

QFlags QFlags:: operator& ( uint mask ) const

这是重载函数。

QFlags QFlags:: operator& ( Enum mask ) const

这是重载函数。

QFlags & QFlags:: operator&= ( int mask )

Performs a bitwise AND operation with mask and stores the result in this QFlags object. Returns a reference to this object.

另请参阅 operator& (), operator|= ()，和 operator^= ().

QFlags & QFlags:: operator&= ( uint mask )

这是重载函数。

QFlags & QFlags:: operator= (const QFlags & other )

赋值 other 到此对象并返回此对象的引用。

QFlags QFlags:: operator^ ( QFlags other ) const

返回 QFlags object containing the result of the bitwise XOR operation on this object and other .

另请参阅 operator^= (), operator& (), operator| ()，和 operator~ ().

QFlags QFlags:: operator^ ( Enum other ) const

这是重载函数。

QFlags & QFlags:: operator^= ( QFlags other )

Performs a bitwise XOR operation with other and stores the result in this QFlags object. Returns a reference to this object.

另请参阅 operator^ (), operator&= ()，和 operator|= ().

QFlags & QFlags:: operator^= ( Enum other )

这是重载函数。

QFlags QFlags:: operator| ( QFlags other ) const

返回 QFlags object containing the result of the bitwise OR operation on this object and other .

另请参阅 operator|= (), operator^ (), operator& ()，和 operator~ ().

QFlags QFlags:: operator| ( Enum other ) const

这是重载函数。

QFlags & QFlags:: operator|= ( QFlags other )

Performs a bitwise OR operation with other and stores the result in this QFlags object. Returns a reference to this object.

另请参阅 operator| (), operator&= ()，和 operator^= ().

QFlags & QFlags:: operator|= ( Enum other )

这是重载函数。

QFlags QFlags:: operator~ () const

返回 QFlags 对象包含此对象的按位取反。

另请参阅 operator& (), operator| ()，和 operator^ ().

宏文档编制

Q_DECLARE_FLAGS ( Flags , Enum )

The Q_DECLARE_FLAGS() macro expands to

typedef QFlags<Enum> Flags;
					

Enum is the name of an existing enum type, whereas Flags is the name of the QFlags < Enum > typedef.

见 QFlags 文档编制了解细节。

另请参阅 Q_DECLARE_OPERATORS_FOR_FLAGS ().

Q_DECLARE_OPERATORS_FOR_FLAGS ( Flags )

Q_DECLARE_OPERATORS_FOR_FLAGS() 宏声明全局 operator|() 函数为 Flags , which is of type QFlags <T>.

见 QFlags 文档编制了解细节。

另请参阅 Q_DECLARE_FLAGS ().