QNetworkConfiguration Class Reference · PyQt4 中文文檔

# QNetworkConfiguration Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkConfiguration類提供的一個或多個接入點的配置的抽象。[More...](#details) ### Types * `enum BearerType { BearerUnknown, BearerEthernet, BearerWLAN, Bearer2G, ..., BearerWiMAX }` * `enum Purpose { UnknownPurpose, PublicPurpose, PrivatePurpose, ServiceSpecificPurpose }` * `enum StateFlag { Undefined, Defined, Discovered, Active }` * `class **[StateFlags](index.htm)**` * `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](qnetworkconfiguration.html#Type-enum)提供一種由平臺解析為實際的網絡結構的佔位符的配置，當一個[session](qnetworksession.html) is [opened](qnetworksession.html#open)。不是所有平臺都支持用戶選擇配置的概念。 ### Configuration states 可以通過以下方式獲得可用配置的清單[QNetworkConfigurationManager.allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（）。配置中可以有多個狀態。該[Defined](qnetworkconfiguration.html#StateFlag-enum)配置狀態表示的結構被存儲在設備上。但是，該構造還沒有準備好被激活為如WLAN中可能無法使用在當前時間。該[Discovered](qnetworkconfiguration.html#StateFlag-enum)狀態隱含該配置是[Defined](qnetworkconfiguration.html#StateFlag-enum)與外界條件是這樣的配置，可以立即使用，以打開一個新的網絡會話。這樣的條件以外，例如，可以是以太網電纜實際上是連接到設備，或與指定的SSID的無線網絡是否在范圍內。該[Active](qnetworkconfiguration.html#StateFlag-enum)狀態隱含該配置是[Discovered](qnetworkconfiguration.html#StateFlag-enum)。處于這種狀態的配置是當前正在使用的應用程序。底層網絡接口有一個有效的IP配置，并可以在設備和目標網絡之間傳輸的IP數據包。該[Undefined](qnetworkconfiguration.html#StateFlag-enum)狀態表示系統有可能的目標網絡的知識，但實際上并不能使用這些知識來連接到它。為這樣的狀態，例如，可以是已經發現，但用戶還沒有實際保存包括所需的密碼這將允許設備連接到它的結構的加密的WLAN 。根據配置的不同類型的一些州是一過性的。可以使用GPRS / UMTS連接可能幾乎總是[Discovered](qnetworkconfiguration.html#StateFlag-enum)如果在GSM / UMTS網絡是可用的。然而，如果將GSM / UMTS網絡失去連接的相關聯的配置有可能改變它的狀態[Discovered](qnetworkconfiguration.html#StateFlag-enum)至[Defined](qnetworkconfiguration.html#StateFlag-enum)為好。類似的用例可能是由WLAN連接狀態被觸發。[QNetworkConfigurationManager.updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（）可用于手動觸發狀態的更新。請注意，某些平臺并不需要這些更新，因為他們暗中更改一旦被發現的狀態。如果配置的狀態更改所有相關QNetworkConfiguration情況自動改變它們的狀態。 * * * ## Type Documentation ``` QNetworkConfiguration.BearerType ``` 指定用于由一個配置的承載類型。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkConfiguration.BearerUnknown` | `0` | 承載的類型未知或不確定的。該[bearerTypeName](qnetworkconfiguration.html#bearerTypeName)（）函數可以返回更多的信息。 | | `QNetworkConfiguration.BearerEthernet` | `1` | 該配置是一個以太網接口。 | | `QNetworkConfiguration.BearerWLAN` | `2` | 該設置是針對無線局域網的接口。 | | `QNetworkConfiguration.Bearer2G` | `3` | 該設置是針對CSD ， GPRS， HSCSD ， EDGE或cdmaOne的接口。 | | `QNetworkConfiguration.BearerCDMA2000` | `4` | 的配置是適用于CDMA接口。 | | `QNetworkConfiguration.BearerWCDMA` | `5` | 配置為W-CDMA/UMTS接口。 | | `QNetworkConfiguration.BearerHSPA` | `6` | 該配置是高速分組接入（HSPA ）接口。 | | `QNetworkConfiguration.BearerBluetooth` | `7` | 配置為藍牙接口。 | | `QNetworkConfiguration.BearerWiMAX` | `8` | 配置是用于WiMAX接口。 | ``` QNetworkConfiguration.Purpose ``` 指定配置的目的。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkConfiguration.UnknownPurpose` | `0` | 在配置上并沒有指定任何目的。這是默認值。 | | `QNetworkConfiguration.PublicPurpose` | `1` | 該配置可用于一般用途的互聯網接入。 | | `QNetworkConfiguration.PrivatePurpose` | `2` | 該配置適用于訪問私有網絡，如一個辦公室內聯網。 | | `QNetworkConfiguration.ServiceSpecificPurpose` | `3` | 該配置可用于運營商特定服務（如接收彩信或內容流）。 | ``` QNetworkConfiguration.StateFlag ``` 指定配置狀態。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkConfiguration.Undefined` | `0x0000001` | 這種狀態是用于瞬時配置，如新發現的WLAN的量，用戶實際上并沒有創建配置愛好。 | | `QNetworkConfiguration.Defined` | `0x0000002` | 定義的配置是眾所周知的系統，但不是立即可用（例如，配置的WLAN是不在范圍內或以太網電纜目前沒有插入機）。 | | `QNetworkConfiguration.Discovered` | `0x0000006` | 發現的配置，可立即用于創建一個新的[QNetworkSession](qnetworksession.html)。已發現的結構的一個例子可以是一個無線局域網是在范圍內。如果設備移出的范圍內發現標志被丟棄。第二個例子是一個GPRS配置通常仍然發現，只要該設備具有網絡復蓋。具有此狀態的配置也是在狀態QNetworkConfiguration.Defined 。如果配置一個服務網絡這個標志被設置，如果底層的接入點配置的至少一個具有發現的狀態。 | | `QNetworkConfiguration.Active` | `0x000000e` | 該配置是目前使用的一個開放的網絡會議（見[QNetworkSession.isOpen](qnetworksession.html#isOpen)（））。然而，這并不意味著當前進程是創建公開會議的實體。它僅僅表明，如果一個新的[QNetworkSession](qnetworksession.html)是在此基礎上對配置進行構建[QNetworkSession.state](qnetworksession.html#state)（）將返回[QNetworkSession.Connected](qnetworksession.html#State-enum)。這種狀態意味著QNetworkConfiguration.Discovered狀態。 | 該StateFlags類型是一個typedef為[QFlags](index.htm)\u003cStateFlag\u003e 。它存儲StateFlag值的或組合。 ``` QNetworkConfiguration.Type ``` 這個枚舉描述的配置類型。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkConfiguration.InternetAccessPoint` | `0` | 配置指定了細節的單一訪問點。注意，類型InternetAccessPoint的配置可以是類型ServiceNetwork的其他QNetworkConfigurations的一部分。 | | `QNetworkConfiguration.ServiceNetwork` | `1` | 該配置是基于一組類型InternetAccessPoint的QNetworkConfigurations的。所有小組成員可以達到同樣的目標網絡。這種類型的配置是漫游功能的網絡會話的強制性要求。在某些平臺這種形式的配置也可以被稱為服務網絡接入點（ SNAP ）。 | | `QNetworkConfiguration.UserChoice` | `2` | 配置是一個佔位符將由該平臺的會話打開的時候被解析為實際的配置。根據不同的平臺上的選擇可能會生成一個彈出式對話框，詢問他的首選用戶。 | | `QNetworkConfiguration.Invalid` | `3` | 配置是無效的。 | * * * ## Method Documentation ``` QNetworkConfiguration.__init__ (self) ``` 構造一個無效的配置對象。 **See also** [isValid](qnetworkconfiguration.html#isValid)（）。 ``` QNetworkConfiguration.__init__ (self, QNetworkConfiguration?other) ``` 創建的副本[QNetworkConfiguration](qnetworkconfiguration.html)包含的對象_other_。 ``` QString QNetworkConfiguration.bearerName (self) ``` 此功能已被棄用。此功能已被棄用。這等同于調用[bearerTypeName](qnetworkconfiguration.html#bearerTypeName)（），但[bearerType](qnetworkconfiguration.html#bearerType)（）應優先使用。 ``` BearerType QNetworkConfiguration.bearerType (self) ``` [ 返回此網絡配置承載的類型。 ](qnetworkconfiguration.html#BearerType-enum) [如果載體的類型](qnetworkconfiguration.html#BearerType-enum)[unknown](qnetworkconfiguration.html#BearerType-enum)該[bearerTypeName](qnetworkconfiguration.html#bearerTypeName)（）函數可以被用于檢索承載一個紋理類型名稱。一個無效的網絡配置總是返回[BearerUnknown](qnetworkconfiguration.html#BearerType-enum)值。 ``` QString QNetworkConfiguration.bearerTypeName (self) ``` 返回此網絡配置為一個字符串承載的類型。該字符串不被翻譯，并因此不能被顯示給用戶。隨后的表顯示之間的固定映射[BearerType](qnetworkconfiguration.html#BearerType-enum)并為已知類型的承載類型名稱。如果[BearerType](qnetworkconfiguration.html#BearerType-enum)未知這個函數可以返回更多的信息，如果它是可用的，否則一個空字符串將被返回。 | [BearerType](qnetworkconfiguration.html#BearerType-enum) | Value | | --- | --- | | [BearerUnknown](qnetworkconfiguration.html#BearerType-enum) | | The session is based on an unknown or unspecified bearer type. The value of the string returned describes the bearer type. | | [BearerEthernet](qnetworkconfiguration.html#BearerType-enum) | Ethernet | | [BearerWLAN](qnetworkconfiguration.html#BearerType-enum) | WLAN | | [Bearer2G](qnetworkconfiguration.html#BearerType-enum) | 2G | | [BearerCDMA2000](qnetworkconfiguration.html#BearerType-enum) | CDMA2000 | | [BearerWCDMA](qnetworkconfiguration.html#BearerType-enum) | WCDMA | | [BearerHSPA](qnetworkconfiguration.html#BearerType-enum) | HSPA | | [BearerBluetooth](qnetworkconfiguration.html#BearerType-enum) | Bluetooth | | [BearerWiMAX](qnetworkconfiguration.html#BearerType-enum) | WiMAX | 這個函數返回一個空字符串，如果這是無效的配置，類型的網絡配置[QNetworkConfiguration.ServiceNetwork](qnetworkconfiguration.html#Type-enum) or [QNetworkConfiguration.UserChoice](qnetworkconfiguration.html#Type-enum)。 **See also** [bearerType](qnetworkconfiguration.html#bearerType)（）。 ``` list-of-QNetworkConfiguration QNetworkConfiguration.children (self) ``` 返回優先順序該網絡配置的所有子配置。在列表中的第一子結構具有最高優先級。類型的唯一網絡配置[ServiceNetwork](qnetworkconfiguration.html#Type-enum)可以有孩子。否則，這個函數返回一個空列表。 ``` QString QNetworkConfiguration.identifier (self) ``` 返回此網絡配置的獨特性和平臺特定的標識符，否則為空字符串。 ``` bool QNetworkConfiguration.isRoamingAvailable (self) ``` 返回True如果此配置支持漫游，否則為False 。 ``` bool QNetworkConfiguration.isValid (self) ``` 返回True如果[QNetworkConfiguration](qnetworkconfiguration.html)目的是有效的。如果用戶刪除配置或配置了缺省構造的配置可能會變得無效。的添加和刪除的配置，可以通過監測[QNetworkConfigurationManager](qnetworkconfigurationmanager.html)。 **See also** [QNetworkConfigurationManager](qnetworkconfigurationmanager.html)。 ``` QString QNetworkConfiguration.name (self) ``` 返回該配置的用戶可見的名稱。名稱可以是底層的接入點的名稱或服務的網絡，這種結構代表名稱。 ``` Purpose QNetworkConfiguration.purpose (self) ``` [ 返回該配置的目的。其目的字段可以用于以編程方式確定配置的目的。這些信息通常是接入點或服務網絡的元數據的一部分。 ](qnetworkconfiguration.html#Purpose-enum) ``` StateFlags QNetworkConfiguration.state (self) ``` [ 返回構造的當前狀態。 ](index.htm) ``` Type QNetworkConfiguration.type (self) ``` [ 返回構造的類型。配置中可以代表一個單獨的接入點的配置或一組接入點的配置。這樣的一組被稱為服務網絡。這是基于一個服務網絡上的配置可以潛在地支持網絡會話的漫游。 ``` bool QNetworkConfiguration.__eq__ (self, QNetworkConfiguration?cp) ``` ``` bool QNetworkConfiguration.__ne__ (self, QNetworkConfiguration?cp) ``` ](qnetworkconfiguration.html#Type-enum)