Typedef for QFlags<Capability>. Refer to QNetworkConfigurationManager::Capability for documentation.

Specifies the system capabilities of the bearer API. The possible values are:

Constructs a QNetworkConfigurationManager with the given parent. To ensure a valid list of current configurations are immediately available, updating is done during construction which causes some delay.

Frees the resources associated with the QNetworkConfigurationManager object.

Returns the list of configurations which comply with the given flags. By default this method returns a list of all the defined and undefined configurations. If flags is empty this method returns all possible configurations.

A wireless network with a particular SSID may only be accessible in a certain area despite the fact that the system has a valid configuration for it. Therefore the filter flag may be used to limit the list to discovered and possibly connected configurations only.

This method returns the states for all configurations as they are known at the time of this method call. If a configuration of type WLAN is defined, the system may have to perform a WLAN scan in order to determine whether it is actually available. To obtain the most accurate state updateConfigurations() should be used to update each configuration's state. This operation may be slow. The completion is signalled by updateCompleted().

In the absence of a configuration update this method returns the best estimate at the time of the call. Therefore, if WLAN configurations are of interest, it is recommended that updateConfigurations() is called once after QNetworkConfigurationManager instantiation (WLAN scans are too time consuming to perform in constructor). After this, the data is kept automatically up todate as the system reports any changes.

Returns the capabilities supported by the current platform.

This signal is emitted whenever a new network configuration is added to the system. The new configuration is specified by config.

This signal is emitted when the state of config changes.

Returns the QNetworkConfiguration for identifier, otherwise returns an invalid QNetworkConfiguration.

See also

QNetworkConfiguration::identifier()

This signal is emitted when a configuration is about to be removed from the system. The removed configuration, specified by config, is invalid but retains name and identifier.

Returns the default configuration to be used. This method always returns a discovered configuration, otherwise an invalid configuration. In some cases it may be required to call updateConfigurations() and wait for the updateCompleted() signal before calling this method.

See also

allConfigurations()

Returns true if the system is considered to be connected to another device via an active network interface, otherwise returns false.

This is equivalent to the following example.

See also

onlineStateChanged()

This signal is emitted when the device changes from online to offline mode or vice versa. The value for isOnline represents the new state of the device. The state is considered to be online for as long as allConfigurations(QNetworkConfiguration::Active) returns a list with at least one entry.

This signal is emitted when the configuration update has been completed. Such an update can be initiated via updateConfigurations().

Initiates an update of all configurations. This may be used to initiate WLAN scans or other time consuming updates which may be required to obtain the correct state for configurations.

This call is asynchronous. On completion of this update the updateCompleted() signal is emitted. If new configurations are discovered or old ones were removed or changed the update process may trigger the emission of one or multiple configurationAdded(), configurationRemoved() and configurationChanged() signals.

If a configuration state changes as a result of this update all existing QNetworkConfiguration instances are updated automatically.

See also

allConfigurations()