QSerialPortInfo 类

提供现有串口的有关信息。更多...

头：	#include <QSerialPortInfo>
CMake:	find_package(Qt6 REQUIRED COMPONENTS SerialPort) target_link_libraries(mytarget PRIVATE Qt6::SerialPort)
qmake:	QT += serialport

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

公共函数

	QSerialPortInfo ()
	QSerialPortInfo (const QSerialPort & port )
	QSerialPortInfo (const QString & name )
	QSerialPortInfo (const QSerialPortInfo & other )
	~QSerialPortInfo ()
QString	description () const
bool	hasProductIdentifier () const
bool	hasVendorIdentifier () const
bool	isNull () const
QString	manufacturer () const
QString	portName () const
quint16	productIdentifier () const
QString	serialNumber () const
void	swap (QSerialPortInfo & other )
QString	systemLocation () const
quint16	vendorIdentifier () const
QSerialPortInfo &	operator= (const QSerialPortInfo & other )

静态公共成员

QList<QSerialPortInfo>	availablePorts ()
QList<qint32>	standardBaudRates ()

详细描述

Use the static availablePorts () function to generate a list of QSerialPortInfo objects. Each QSerialPortInfo object in the list represents a single serial port and can be queried for the port name , system location , description , manufacturer , and some other hardware parameters. The QSerialPortInfo class can also be used as an input parameter for the setPort () method of the QSerialPort 类。

用法范例

The example code enumerates all available serial ports and prints their parameters to console:

    const auto serialPortInfos = QSerialPortInfo::availablePorts();
    for (const QSerialPortInfo &portInfo : serialPortInfos) {
        qDebug() << "\n"
                 << "Port:" << portInfo.portName() << "\n"
                 << "Location:" << portInfo.systemLocation() << "\n"
                 << "Description:" << portInfo.description() << "\n"
                 << "Manufacturer:" << portInfo.manufacturer() << "\n"
                 << "Serial number:" << portInfo.serialNumber() << "\n"
                 << "Vendor Identifier:"
                 << (portInfo.hasVendorIdentifier()
                     ? QByteArray::number(portInfo.vendorIdentifier(), 16)
                     : QByteArray()) << "\n"
                 << "Product Identifier:"
                 << (portInfo.hasProductIdentifier()
                     ? QByteArray::number(portInfo.productIdentifier(), 16)
                     : QByteArray());
    }

另请参阅 QSerialPort .

成员函数文档编制

QSerialPortInfo:: QSerialPortInfo ()

构造空的 QSerialPortInfo 对象。

另请参阅 isNull ().

`[explicit]` QSerialPortInfo:: QSerialPortInfo (const QSerialPort & port )

构造 QSerialPortInfo 对象从串行 port .

`[explicit]` QSerialPortInfo:: QSerialPortInfo (const QString & name )

构造 QSerialPortInfo 对象从串口 name .

此构造函数在可用串口中找到相关串口，根据端口名称 name ，并为该端口构造串口信息实例。

QSerialPortInfo:: QSerialPortInfo (const QSerialPortInfo & other )

构造副本为 other .

QSerialPortInfo:: ~QSerialPortInfo ()

销毁 QSerialPortInfo 对象。引用对象中的值变为无效。

`[static]` QList < QSerialPortInfo > QSerialPortInfo:: availablePorts ()

返回系统可用串口的列表。

QString QSerialPortInfo:: description () const

返回串口的描述字符串，若可用；否则返回空字符串。

另请参阅 manufacturer () 和 serialNumber ().

bool QSerialPortInfo:: hasProductIdentifier () const

返回 true 若存在有效 16-bit 产品编号呈现；否则返回 false .

另请参阅 productIdentifier (), vendorIdentifier ()，和 hasVendorIdentifier ().

bool QSerialPortInfo:: hasVendorIdentifier () const

返回 true 若存在有效 16-bit 供应商编号存在；否则返回 false .

另请参阅 vendorIdentifier (), productIdentifier ()，和 hasProductIdentifier ().

bool QSerialPortInfo:: isNull () const

返回是否此 QSerialPortInfo 对象保持串口定义。

QString QSerialPortInfo:: manufacturer () const

返回串口的制造商字符串，若可用；否则返回空字符串。

另请参阅 description () 和 serialNumber ().

QString QSerialPortInfo:: portName () const

返回串口的名称。

另请参阅 systemLocation ().

quint16 QSerialPortInfo:: productIdentifier () const

返回串口的 16 位产品编号，若可用；否则返回 0。

另请参阅 hasProductIdentifier (), vendorIdentifier ()，和 hasVendorIdentifier ().

QString QSerialPortInfo:: serialNumber () const

返回串口的序列号字符串，若可用；否则返回空字符串。

注意： 序列号可能包含字母。

另请参阅 description () 和 manufacturer ().

`[static]` QList < qint32 > QSerialPortInfo:: standardBaudRates ()

返回由目标平台支持的，可用标准波特率列表。

void QSerialPortInfo:: swap ( QSerialPortInfo & other )

交换 QSerialPortInfo other 采用此 QSerialPortInfo 。此操作很快且从不失败。

QString QSerialPortInfo:: systemLocation () const

返回串口的系统位置。

另请参阅 portName ().

quint16 QSerialPortInfo:: vendorIdentifier () const

返回串口的 16 位供应商编号，若可用；否则返回 0。

另请参阅 hasVendorIdentifier (), productIdentifier ()，和 hasProductIdentifier ().

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

设置 QSerialPortInfo 对象等于 other .