×
Namespaces

Variants
Actions
(Difference between revisions)

How to set default access point using Qt Mobility APIs

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Bot change of links to internal format.)
somnathbanik (Talk | contribs)
Line 26: Line 26:
 
=Overview=
 
=Overview=
  
* This article will explain how to set default access point using the Bearer Management APIs of the Qt Mobility Package.
+
{{Abstract|This article demonstrate how to set default access point using the [http://doc.qt.nokia.com/qtmobility-1.2/bearer-management.html Bearer Management APIs] of the [http://doc.qt.nokia.com/qtmobility-1.2/ Qt's Mobility] Package.
  
 
=Project Configuration File (.pro file)=
 
=Project Configuration File (.pro file)=
  
* Add the Qt Mobility project configuration option in the .Pro file as shown below
+
Add the Qt Mobility project configuration option in the '''.Pro''' file as shown below
 
<code>
 
<code>
 
CONFIG += mobility
 
CONFIG += mobility
Line 39: Line 39:
 
=Header File=
 
=Header File=
  
* Do add the Qt mobility name space before using any Qt mobility APIs,
+
Also do add the Qt mobility name space before using any Qt mobility APIs,
 +
<code cpp>
 
   QTM_USE_NAMESPACE
 
   QTM_USE_NAMESPACE
 
+
</code>
* declare a QNetworkSession object in the header file which will help in opening the network connections.
+
Declare a [http://doc.qt.nokia.com/4.7/qnetworksession.html QNetworkSession] object in the header file which will help in opening the network connections.
  
 
<code cpp>
 
<code cpp>
Line 55: Line 56:
 
=Source File=
 
=Source File=
  
* After declaring the QNetworkSession object we need to use the QNetworkConfigurationManager and QNetworkConfiguration class to ask the user about the access point and make that as a default connection.
+
After declaring the [http://doc.qt.nokia.com/4.7/qnetworksession.html QNetworkSession] object we need to use the [http://doc.qt.nokia.com/4.7/qnetworkconfigurationmanager.html QNetworkConfigurationManager] and [http://doc.qt.nokia.com/4.7/qnetworkconfiguration.html QNetworkConfiguration] class to ask the user about the access point and make that as a default connection.
  
 
A sample function is shown below :
 
A sample function is shown below :
Line 76: Line 77:
 
</code>
 
</code>
  
It is worth noting that QNetworkConfigurationManager::defaultConfiguration() reflects the device's default connection setting, which can be controlled from the UI.  
+
It is worth noting that {{Icode|QNetworkConfigurationManager::defaultConfiguration()}} reflects the device's default connection setting, which can be controlled from the UI.  
The default connection varies slightly from device to device.  For example on 5800 device, navigate to Menu -> Settings -> Connectivity -> Destinations -> Options -> Default Connection  
+
The default connection varies slightly from device to device.  For example on 5800 device, navigate to ''Menu -> Settings -> Connectivity -> Destinations -> Options -> Default Connection'' to control this setting. Notably, it the setting is set as 'Always Ask', user will be prompted every time.
to control this setting. Notably, it the setting is set as 'Always Ask', user will be prompted every time.
+
  
If you need more control over which configuration is used, what you can do is list the configurations (QNetworkConfigurationManager::allConfigurations()), choose the one you wish to use, and  
+
If you need more control over which configuration is used, what you can do is list the configurations ({{Icode|QNetworkConfigurationManager::allConfigurations()}}), choose the one you wish to use, and  
create a QNetworkSession based on that configuration (similarly as in the example snippet above).
+
create a [http://doc.qt.nokia.com/4.7/qnetworksession.html QNetworkSession] based on that configuration (similarly as in the example snippet above).
  
 
=extension=
 
=extension=
  
* In one of my previous [[How to do HTTP Get and Post using Qt for Symbian|article]] i explained the HTTP '''GET''' and '''POST''' mechanism using QT APIs, that article can be easily extended to ask the user at first to select an access point and make that as default connection.
+
* In one of my previous [[How to do HTTP Get and Post using Qt for Symbian|article]] I explained the HTTP '''GET''' and '''POST''' mechanism using Qt's APIs, that article can be easily extended to ask the user at first to select an access point and make that as default connection.
  
 
* The screenshots shown below illustrates the above point clearly:
 
* The screenshots shown below illustrates the above point clearly:

Revision as of 12:06, 25 May 2011

ID Creation date 29th Mar 2010
Platform S60 5th Edition Tested on devices Nokia N97
Category Qt Subcategory Qt Mobility API


Keywords (APIs, classes, methods, functions): QNetworkSession, QNetworkConfigurationManager,QConfigurationManager


Tip.pngTip: Read this article before moving forward: Setting up environment for Qt Mobility API


Contents

Overview

{{Abstract|This article demonstrate how to set default access point using the Bearer Management APIs of the Qt's Mobility Package.

Project Configuration File (.pro file)

Add the Qt Mobility project configuration option in the .Pro file as shown below

CONFIG += mobility
MOBILITY += bearer


Header File

Also do add the Qt mobility name space before using any Qt mobility APIs,

  QTM_USE_NAMESPACE

Declare a QNetworkSession object in the header file which will help in opening the network connections.

#include <qmobilityglobal.h>
#include <qnetworksession.h>
 
QNetworkSession* session;

Source File

After declaring the QNetworkSession object we need to use the QNetworkConfigurationManager and QNetworkConfiguration class to ask the user about the access point and make that as a default connection.

A sample function is shown below :

    QNetworkConfigurationManager manager;
 
const bool selectIap = (manager.capabilities()& QNetworkConfigurationManager::CanStartAndStopInterfaces);
QNetworkConfiguration defaultIap = manager.defaultConfiguration();
 
if(!defaultIap.isValid() && (!selectIap && defaultIap.state() != QNetworkConfiguration::Active))
{
// let the user know that there is no access point available
}
 
session = new QNetworkSession(defaultIap,this);
session->open();

It is worth noting that QNetworkConfigurationManager::defaultConfiguration() reflects the device's default connection setting, which can be controlled from the UI. The default connection varies slightly from device to device. For example on 5800 device, navigate to Menu -> Settings -> Connectivity -> Destinations -> Options -> Default Connection to control this setting. Notably, it the setting is set as 'Always Ask', user will be prompted every time.

If you need more control over which configuration is used, what you can do is list the configurations (QNetworkConfigurationManager::allConfigurations()), choose the one you wish to use, and create a QNetworkSession based on that configuration (similarly as in the example snippet above).

extension

  • In one of my previous article I explained the HTTP GET and POST mechanism using Qt's APIs, that article can be easily extended to ask the user at first to select an access point and make that as default connection.
  • The screenshots shown below illustrates the above point clearly:

QDefaultAccessPoint1.jpg QDefaultAccessPoint2.jpg


References

103 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×