QNetworkConfigurationManager Class Reference · PyQt4 中文文檔

# QNetworkConfigurationManager Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkConfigurationManager類管理系統所提供的網絡配置。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `class **[Capabilities](index.htm)**` * `enum Capability { CanStartAndStopInterfaces, DirectConnectionRouting, SystemSessionSupport, ApplicationLevelRoaming, ..., NetworkSessionRequired }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `list-of-QNetworkConfiguration allConfigurations (self, QNetworkConfiguration.StateFlags?flags?=?0)` * `Capabilities capabilities (self)` * `QNetworkConfiguration configurationFromIdentifier (self, QString?identifier)` * `QNetworkConfiguration defaultConfiguration (self)` * `bool isOnline (self)` * `updateConfigurations (self)` ### Qt Signals * `void configurationAdded (const QNetworkConfiguration&)` * `void configurationChanged (const QNetworkConfiguration&)` * `void configurationRemoved (const QNetworkConfiguration&)` * `void onlineStateChanged (bool)` * `void updateCompleted ()` * * * ## Detailed Description 該QNetworkConfigurationManager類管理系統所提供的網絡配置。 QNetworkConfigurationManager提供對系統已知的網絡配置，并允許應用程序在運行時，檢測系統的能力（與問候網絡會話）。 A [QNetworkConfiguration](qnetworkconfiguration.html)抽象一組描述如何在網絡接口必須被配置為連接到一個特定的目標網絡的配置選項。 QNetworkConfigurationManager維護和更新QNetworkConfigurations的全局列表。應用程序可以通過訪問和過濾此列表[allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（）。如果一個新的配置添加或現有被刪除或更改[configurationAdded](qnetworkconfigurationmanager.html#configurationAdded)（）[configurationRemoved](qnetworkconfigurationmanager.html#configurationRemoved)（）和[configurationChanged](qnetworkconfigurationmanager.html#configurationChanged)（）信號被分別發射。該[defaultConfiguration](qnetworkconfigurationmanager.html#defaultConfiguration)（）可以打算立即創建一個新的網絡會話無需關心特定配置時使用。它返回一個[QNetworkConfiguration.Discovered](qnetworkconfiguration.html#StateFlag-enum)配置。如果沒有任何發現的人則返回一個無效的配置。一些配置更新可能需要一些時間來執行更新。例如，WLAN掃描就是這樣一個例子。除非該平臺進行內部更新，可能需要通過手動觸發配置更新[QNetworkConfigurationManager.updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（）。更新過程的完成是由發光的起訴[updateCompleted](qnetworkconfigurationmanager.html#updateCompleted)（）信號。更新過程，確保每一個現有的[QNetworkConfiguration](qnetworkconfiguration.html)實例更新。有沒有必要通過索要重新配置清單[allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（）。 * * * ## Type Documentation ``` QNetworkConfigurationManager.Capability ``` 指定承載API的系統的能力。可能的值有： | Constant | Value | Description | | --- | --- | --- | | `QNetworkConfigurationManager.CanStartAndStopInterfaces` | `0x00000001` | 網絡會議和其相關的接入點可以啟動和停止。如果該標志沒有被設置[QNetworkSession](qnetworksession.html)只能監視而不會影響接入點的狀態。在某些平臺上，此功能可能需要提升的用戶權限。此選項特定平臺和可能不總是可用的。 | | `QNetworkConfigurationManager.DirectConnectionRouting` | `0x00000002` | 網絡會話和它們的插座可以綁定到一個特定的網絡接口。穿過套接字的任何數據包進入到指定的網絡接口，從而忽視了標準的路由表項。這可能是有用的，當兩個接口可以達到重疊的IP范圍或應用程序具有的問候針對網絡的特殊需求。此選項特定平臺和可能不總是可用的。 | | `QNetworkConfigurationManager.SystemSessionSupport` | `0x00000004` | 如果這個標志被設置在底層平臺確保了網絡接口沒有關閉，直到最后一個網絡會話已[closed()](qnetworksession.html#close)。這可以跨多個進程。如果平臺支持會話缺少這個API只能確保為同一進程內的網絡會話的上述行為。在一般的移動平臺（如Symbian/S60 ）有這樣的支持，而大多數桌面平臺缺乏這種能力。 | | `QNetworkConfigurationManager.ApplicationLevelRoaming` | `0x00000008` | 該系統使應用程序在系統中的漫游行為控制。應用程序可以啟動漫游的情況下（當前的鏈路是不適合的），并進行協商，如果系統已經確定更合適的接入點。 | | `QNetworkConfigurationManager.ForcedRoaming` | `0x00000010` | 該系統斷開現有的接入點，并通過一個更適合的重新連接。該應用程序沒有在這個過程中的任何控制，并有重新活躍的插座。 | | `QNetworkConfigurationManager.DataStatistics` | `0x00000020` | 如果該標志被設置[QNetworkSession](qnetworksession.html)可以提供關于發送和接收的數據的統計信息。 | | `QNetworkConfigurationManager.NetworkSessionRequired` | `0x00000040` | 如果這個標志被設置在平臺要求網絡運營才能執行網絡會話被創建。 | 功能類型是一個typedef為[QFlags](index.htm)\u003cCapability\u003e 。它存儲能力值的一個或組合。 * * * ## Method Documentation ``` QNetworkConfigurationManager.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QNetworkConfigurationManager](qnetworkconfigurationmanager.html)用給定的_parent_。請注意，以確保立即可用的當前配置的有效名單，更新被施工造成一些延遲期間完成。 ``` list-of-QNetworkConfiguration QNetworkConfigurationManager.allConfigurations (self, QNetworkConfiguration.StateFlags?flags?=?0) ``` 返回的配置，這符合給出的列表_filter_。默認情況下，該函數返回所有（已定義和未定義）配置。一種無線網絡與一個特定的SSID可能只能訪問在一定區域內，盡管該系統具有用于其有效的配置的事實。因此，過濾器旗標可用于列表限制為僅發現并可能連接的配置。 If _filter_設置為零則該函數返回所有可能的配置。注意，這個函數返回的狀態的所有配置，因為他們知道在這個函數調用的時間。舉例來說如果類型的WLAN的結構進行定義的系統可能必須以確定它是否是實際可用的執行WLAN掃描。為了獲得最準確的狀態[updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（）應該用于更新每個配置的狀態。請注意，這樣的更新可能需要一些時間。它的完成是由信號[updateCompleted](qnetworkconfigurationmanager.html#updateCompleted)（）。在沒有配置更新的這個函數返回的最佳估計在調用的時候。因此，如果無線網絡配置是感興趣的，則建議[updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（）被調用一次后[QNetworkConfigurationManager](qnetworkconfigurationmanager.html)實例化（WLAN掃描太費時在構造函數中執行）。在此之后，數據被保持自動向上最新的系統信息報告的任何變化。 ``` Capabilities QNetworkConfigurationManager.capabilities (self) ``` [ 返回由當前平臺所支持的功能。 ](index.htm) ``` QNetworkConfiguration QNetworkConfigurationManager.configurationFromIdentifier (self, QString?identifier) ``` [](qnetworkconfiguration.html) [返回](qnetworkconfiguration.html)[QNetworkConfiguration](qnetworkconfiguration.html)為_identifier_否則返回一個無效的[QNetworkConfiguration](qnetworkconfiguration.html)。 **See also** [QNetworkConfiguration.identifier](qnetworkconfiguration.html#identifier)（）。 ``` QNetworkConfiguration QNetworkConfigurationManager.defaultConfiguration (self) ``` [ 返回要使用的默認配置。這個函數總是返回一個發現的配置，否則配置無效。 ](qnetworkconfiguration.html) [在某些情況下，可能需要調用](qnetworkconfiguration.html)[updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（），并等待[updateCompleted](qnetworkconfigurationmanager.html#updateCompleted)調用此函數之前（）信號。 **See also** [allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（）。 ``` bool QNetworkConfigurationManager.isOnline (self) ``` 返回True如果系統被認為是連接到通過活動的網絡接口其它設備，否則返回False 。這相當于下面的代碼片段： ``` [QNetworkConfigurationManager](qnetworkconfigurationmanager.html) mgr; [QList](index.htm)<[QNetworkConfiguration](qnetworkconfiguration.html)> activeConfigs = mgr.allConfigurations([QNetworkConfiguration](qnetworkconfiguration.html).Active) if (activeConfigs.count() > 0) Q_ASSERT(mgr.isOnline()) else Q_ASSERT(!mgr.isOnline()) ``` **See also** [onlineStateChanged](qnetworkconfigurationmanager.html#onlineStateChanged)（）。 ``` QNetworkConfigurationManager.updateConfigurations (self) ``` 啟動所有配置的更新。這可以被用于啟動可能需要獲得正確的狀態配置的WLAN掃描或其它費時的更新。這個調用是異步的。此更新完成后，[updateCompleted](qnetworkconfigurationmanager.html#updateCompleted)（）信號被發射。如果新的配置被發現或被刪除或更改舊的更新過程中可能會觸發一個或多個排放[configurationAdded](qnetworkconfigurationmanager.html#configurationAdded)（）[configurationRemoved](qnetworkconfigurationmanager.html#configurationRemoved)（）和[configurationChanged](qnetworkconfigurationmanager.html#configurationChanged)（）信號。如果配置狀態的變化，因為這更新所有現有的結果[QNetworkConfiguration](qnetworkconfiguration.html)實例自動更新。 **See also** [allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（）。 * * * ## Qt Signal Documentation ``` void configurationAdded (const QNetworkConfiguration&) ``` 這是該信號的默認超載。每當一個新的網絡配置被添加到系統中，這信號被發射。被指定的新配置_config_。 ``` void configurationChanged (const QNetworkConfiguration&) ``` 這是該信號的默認超載。這個信號被發射時的[state](qnetworkconfiguration.html#state)的_config_變化。 ``` void configurationRemoved (const QNetworkConfiguration&) ``` 這是該信號的默認超載。當配置即將被從系統中移除這個信號被發射。拆下的結構，通過指定_config_，是無效的，但保留名稱和標識。此功能被引入Qt的4.8 。 ``` void onlineStateChanged (bool) ``` 這是該信號的默認超載。這個信號被發射時，該設備改變從聯機到脫機模式或反之亦然。_isOnline_代表該設備的新的狀態。該州被認為是只要在線[allConfigurations](qnetworkconfigurationmanager.html#allConfigurations)（[QNetworkConfiguration.Active](qnetworkconfiguration.html#StateFlag-enum)）返回與至少一個條目的列表。 ``` void updateCompleted () ``` 這是該信號的默認超載。當配置更新已經完成這個信號被發射。這樣的更新可以通過啟動[updateConfigurations](qnetworkconfigurationmanager.html#updateConfigurations)（）。