Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QNetworkConfiguration Class Reference
^{[QtNetwork module]}

该QNetworkConfiguration类提供的一个或多个接入点的配置的抽象。More...

Types

• enum BearerType { BearerUnknown, BearerEthernet, BearerWLAN, Bearer2G, ..., BearerWiMAX }
• enum Purpose { UnknownPurpose, PublicPurpose, PrivatePurpose, ServiceSpecificPurpose }
• enum StateFlag { Undefined, Defined, Discovered, Active }
• class StateFlags
• enum Type { InternetAccessPoint, ServiceNetwork, UserChoice, Invalid }

Methods

• __init__ (self)
• __init__ (self, QNetworkConfiguration other)
• QString bearerName (self)
• BearerType bearerType (self)
• QString bearerTypeName (self)
• list-of-QNetworkConfiguration children (self)
• QString identifier (self)
• bool isRoamingAvailable (self)
• bool isValid (self)
• QString name (self)
• Purpose purpose (self)
• StateFlags state (self)
• Type type (self)

Special Methods

• bool __eq__ (self, QNetworkConfiguration cp)
• bool __ne__ (self, QNetworkConfiguration cp)

Detailed Description

该QNetworkConfiguration类提供的一个或多个接入点的配置的抽象。

QNetworkConfiguration封装单个接入点或服务网络。在大多数情况下，一个单一的接入点的配置可以被映射到一个网络接口。然而，一个单一的网络接口可能并不总是映射到唯一的一个接入点的配置。对于同一网络中设备的多种配置可使得多个接入点。一例装置，可以表现出这样的结构可能是一个智能手机，它允许用户管理多个WLAN配置，而设备本身仅具有一个WLAN网络设备。

该QNetworkConfiguration还支持服务网络的概念。这个概念允许多个接入点的配置的组合成一个实体。这样的一组被称为服务网络，可以在案件是有益由此网络会话到特定目的地网络是必需的（如公司网络） 。当使用一服务网络的用户通常不关心其中的连接选项1被选择（例如，企业WLAN或VPN通过GPRS ） ，只要他能够达到公司的目标服务器。根据当前位置和时间的一些接入点组成的服务网络甚至可能不是可用的。此外自动接入点漫游可以启用，使该器件能够动态更改网络接口的配置，同时保持应用程序连接到目标网络。它允许适应不断变化的环境，并可以使优化与问候成本，速度或其他网络参数。

类型的特殊配置UserChoice提供一种由平台解析为实际的网络结构的佔位符的配置，当一个session is opened。不是所有平台都支持用户选择配置的概念。

Configuration states

可以通过以下方式获得可用配置的清单QNetworkConfigurationManager.allConfigurations（ ） 。配置中可以有多个状态。该Defined配置状态表示的结构被存储在设备上。但是，该构造还没有准备好被激活为如WLAN中可能无法使用在当前时间。

该Discovered状态隐含该配置是Defined与外界条件是这样的配置，可以立即使用，以打开一个新的网络会话。这样的条件以外，例如，可以是以太网电缆实际上是连接到设备，或与指定的SSID的无线网络是否在范围内。

该Active状态隐含该配置是Discovered。处于这种状态的配置是当前正在使用的应用程序。底层网络接口有一个有效的IP配置，并可以在设备和目标网络之间传输的IP数据包。

该Undefined状态表示系统有可能的目标网络的知识，但实际上并不能使用这些知识来连接到它。为这样的状态，例如，可以是已经发现，但用户还没有实际保存包括所需的密码这将允许设备连接到它的结构的加密的WLAN 。

根据配置的不同类型的一些州是一过性的。可以使用GPRS / UMTS连接可能几乎总是Discovered如果在GSM / UMTS网络是可用的。然而，如果将GSM / UMTS网络失去连接的相关联的配置有可能改变它的状态Discovered至Defined为好。类似的用例可能是由WLAN连接状态被触发。QNetworkConfigurationManager.updateConfigurations（）可用于手动触发状态的更新。请注意，某些平台并不需要这些更新，因为他们暗中更改一旦被发现的状态。如果配置的状态更改所有相关QNetworkConfiguration情况自动改变它们的状态。

Type Documentation

QNetworkConfiguration.BearerType

指定用于由一个配置的承载类型。

QNetworkConfiguration.Purpose

指定配置的目的。

QNetworkConfiguration.StateFlag

指定配置状态。

该StateFlags类型是一个typedef为QFlags\u003cStateFlag\u003e 。它存储StateFlag值的或组合。

QNetworkConfiguration.Type

这个枚举描述的配置类型。

Method Documentation

QNetworkConfiguration.__init__ (self)

构造一个无效的配置对象。

See also isValid（ ） 。

QNetworkConfiguration.__init__ (self, QNetworkConfiguration other)

创建的副本QNetworkConfiguration包含的对象other。

QString QNetworkConfiguration.bearerName (self)

此功能已被弃用。

此功能已被弃用。这等同于调用bearerTypeName（ ） ，但bearerType（ ）应优先使用。

BearerType QNetworkConfiguration.bearerType (self)

返回此网络配置承载的类型。

如果载体的类型unknown该bearerTypeName（）函数可以被用于检索承载一个纹理类型名称。

一个无效的网络配置总是返回BearerUnknown值。

QString QNetworkConfiguration.bearerTypeName (self)

返回此网络配置为一个字符串承载的类型。

该字符串不被翻译，并因此不能被显示给用户。随后的表显示之间的固定映射BearerType并为已知类型的承载类型名称。如果BearerType未知这个函数可以返回更多的信息，如果它是可用的，否则一个空字符串将被返回。

这个函数返回一个空字符串，如果这是无效的配置，类型的网络配置QNetworkConfiguration.ServiceNetwork or QNetworkConfiguration.UserChoice。

See also bearerType（ ） 。

list-of-QNetworkConfiguration QNetworkConfiguration.children (self)

返回优先顺序该网络配置的所有子配置。在列表中的第一子结构具有最高优先级。

类型的唯一网络配置ServiceNetwork可以有孩子。否则，这个函数返回一个空列表。

QString QNetworkConfiguration.identifier (self)

返回此网络配置的独特性和平台特定的标识符，否则为空字符串。

bool QNetworkConfiguration.isRoamingAvailable (self)

返回True如果此配置支持漫游，否则为False 。

bool QNetworkConfiguration.isValid (self)

返回True如果QNetworkConfiguration目的是有效的。如果用户删除配置或配置了缺省构造的配置可能会变得无效。

的添加和删除的配置，可以通过监测QNetworkConfigurationManager。

See also QNetworkConfigurationManager。

QString QNetworkConfiguration.name (self)

返回该配置的用户可见的名称。

名称可以是底层的接入点的名称或服务的网络，这种结构代表名称。

Purpose QNetworkConfiguration.purpose (self)

返回该配置的目的。

其目的字段可以用于以编程方式确定配置的目的。这些信息通常是接入点或服务网络的元数据的一部分。

StateFlags QNetworkConfiguration.state (self)

返回构造的当前状态。

Type QNetworkConfiguration.type (self)

返回构造的类型。

配置中可以代表一个单独的接入点的配置或一组接入点的配置。这样的一组被称为服务网络。这是基于一个服务网络上的配置可以潜在地支持网络会话的漫游。

bool QNetworkConfiguration.__eq__ (self, QNetworkConfiguration cp)

bool QNetworkConfiguration.__ne__ (self, QNetworkConfiguration cp)