Inside Qt for Symbian QApplication/zh

From Qt Wiki
Jump to: navigation, search
IMPORTANT: The content of this page is outdated. Reason: The Symbian platform is no longer supported.
If you have checked or updated this page and found the content to be suitable, please remove this notice.
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

作者: habert

Qt for Symbian之程序启动

我们都知道Qt中只要构造出QApplication就启动了,可启动细节就很少有人知道了,当然我们编写Qt的程序无需关心这么多,这也是为什么要用Qt的原因,但如果能够了解则可以加深对Qt的认识。今天看了一下Qt for Symbian的源码,整理如下,希望对有兴趣的朋友有帮助:

QApplication::QApplication(int &argc, char **argv)
 : QCoreApplication('''new QApplicationPrivate(argc, argv, GuiClient) //第一步) //第二步
{
 Q_D(QApplication); //第三步
 d->construct(); //第四步
}

第一步构造了QApplicationPrivate的实例,其中GuiClient是一个枚举常量,表示应用程序的类型,这里我们不用关心。说道 QApplicationPrivate,如果你看过Qt的源码,你会发现很多类都配对有相应的Private类,这是Qt在封装底层实现时经常用的一种模式,Handle-Body Design Pattern,也就是说你在xx类中看不到具体的实现,具体的实现都封装在xxPrivate类中,而在xx类的方法只是调用xxPrivate中相应的方法。

第二步用QApplicationPrivate的实例构造了QCoreApplication,这里调用的是QCoreApplication的QCoreApplication::QCoreApplication(QCoreApplicationPrivate &p)构造函数,代码如下:

QCoreApplication::QCoreApplication(QCoreApplicationPrivate &p)
 : QObject(p, 0)
{
 init();
 // note: it is the subclasses' job to call
 // QCoreApplicationPrivate::eventDispatcher->startingUp();
}

上面代码中的init初始化了一些资源,其中包括事件分发器。

第三步定义了d,这里是通过宏Q_D来实现的,其中宏Q_D的定义如下:

#define Q_D(Class) Class##Private''' const d = d_func()<code>
所以这里的d即是调用父类构造函数QCoreApplication(*new QApplicationPrivate(argc, argv, GuiClient)时创建的QApplicationPrivate实例。

第四步调用dconstruct函数,也就是QApplicationPrivate的实例的construct函数。代码如下所示:
void QApplicationPrivate::construct(
  1. ifdef Q_WS_X11
Display *dpy, Qt::HANDLE visual, Qt::HANDLE cmap
  1. endif
)

{

initResources();

qt_is_gui_used = (qt_appType != QApplication::Tty);

process_cmdline();
// the environment variable has the lowest precedence of runtime graphicssystem switches
if (graphics_system_name.isEmpty())
graphics_system_name = QString::fromLocal8Bit(qgetenv("QT_GRAPHICSSYSTEM"));
// Must be called before initialize()
//这里调用了qt_init
qt_init(this, qt_appType
  1. ifdef Q_WS_X11
, dpy, visual, cmap
  1. endif
);
initialize();
eventDispatcher->startingUp();
  1. ifdef QT_EVAL
extern void qt_gui_eval_init(uint);
qt_gui_eval_init(application_type);
  1. endif
  1. if defined(Q_OS_SYMBIAN) && !defined(QT_NO_SYSTEMLOCALE)
symbianInit();
  1. endif
  1. ifndef QT_NO_LIBRARY
if(load_testability) {
QLibrary testLib(QLatin1String("qttestability"));
if (testLib.load()) {
typedef void (TasInitialize)(void);
TasInitialize initFunction = (TasInitialize)testLib.resolve("qt_testability_init");
if (initFunction) {
initFunction();
} else {
qCritical("Library qttestability resolve failed!");
}
} else {
qCritical("Library qttestability load failed!");
}
}
//make sure the plugin is loaded
if (qt_is_gui_used)
qt_guiPlatformPlugin();
  1. endif
}
这里也是初始化了很多资源,其中要要说的是qt_init,因为就是它创建了程序,代码如下:
void qt_init(QApplicationPrivate /* priv */, int)

{

if (!CCoeEnv::Static()) {
// The S60 framework creates a new trap handler which will render any existing traps
// invalid as long as it is active. This means that all code in main() that occurs after
// the QApplication construction needs to be surrounded by a new trap, despite having
// an outer one already. To avoid this, we save the original trap handler here, and set
// it back after the S60 framework is constructed. Then we restore it right before the S60
// framework destruction.
TTrapHandler origTrapHandler = User::TrapHandler();
// The S60 framework has not been initialized. We need to do it.
//这里就是创建程序的地方
TApaApplicationFactory factory(S60->s60ApplicationFactory ?
S60->s60ApplicationFactory : newS60Application);
CApaCommandLine commandLine = 0;
TInt err = CApaCommandLine::GetCommandLineFromProcessEnvironment(commandLine);
// After this construction, CEikonEnv will be available from CEikonEnv::Static().
// (much like our qApp).
CEikonEnv* coe = new CEikonEnv;
//not using QT_TRAP_THROWING, because coe owns the cleanupstack so it can't be pushed there.
if(err == KErrNone)
TRAP (err, coe->ConstructAppFromCommandLineL(factory,*commandLine)); //这里通过factory创建了程序
delete commandLine;
if(err != KErrNone) {
qWarning() << "qt_init: Eikon application construct failed ("
<< err
<< "), maybe missing resource file on S60 3.1?";
delete coe;
qt_symbian_throwIfError(err);
}

S60->s60InstalledTrapHandler = User::SetTrapHandler(origTrapHandler);

S60->qtOwnsS60Environment = true;

} else {
S60->qtOwnsS60Environment = false;
}
  1. ifdef QT_NO_DEBUG
if (!qgetenv("QT_S60_AUTO_FLUSH_WSERV").isEmpty())
  1. endif
S60->wsSession().SetAutoFlush(ETrue);
  1. ifdef Q_SYMBIAN_WINDOW_SIZE_CACHE
TRAP_IGNORE(S60->wsSession().EnableWindowSizeCacheL());
  1. endif

S60->updateScreenSize();

TDisplayMode mode = S60->screenDevice()->DisplayMode();

S60->screenDepth = TDisplayModeUtils::NumDisplayModeBitsPerPixel(mode);

//NB: RWsSession::GetColorModeList tells you what window modes are supported,

//not what bitmap formats.
if(QSysInfo::symbianVersion() == QSysInfo::SV_9_2)
S60->supportsPremultipliedAlpha = 0;
else
S60->supportsPremultipliedAlpha = 1;

RProcess me;

TSecureId securId = me.SecureId();
S60->uid = securId.operator TUid();

// enable focus events - used to re-enable mouse after focus changed between mouse and non mouse app,

// and for dimming behind modal windows
S60->windowGroup().EnableFocusChangeEvents();

//Check if mouse interaction is supported (either EMouse=1 in the HAL, or EMachineUID is one of the phones known to support this)

const TInt KMachineUidSamsungI8510 = 0x2000C51E;
// HAL::Get(HALData::EPen, TInt& result) may set 'result' to 1 on some 3.1 systems (e.g. N95).
// But we know that S60 systems below 5.0 did not support touch.
static const bool touchIsUnsupportedOnSystem =
QSysInfo::s60Version()  QSysInfo::SV_S60_3_1
       || QSysInfo::s60Version()  QSysInfo::SV_S60_3_2;
TInt machineUID;
TInt mouse;
TInt touch;
TInt err;
err = HAL::Get(HALData::EMouse, mouse);
if (err != KErrNone)
mouse = 0;
err = HAL::Get(HALData::EMachineUid, machineUID);
if (err != KErrNone)
machineUID = 0;
err = HAL::Get(HALData::EPen, touch);
if (err != KErrNone || touchIsUnsupportedOnSystem)
touch = 0;
  1. ifdef WINS
if(QSysInfo::symbianVersion() <= QSysInfo::SV_9_4) {
//for symbian SDK emulator, force values to match typical devices.
mouse = 0;
touch = touchIsUnsupportedOnSystem ? 0 : 1;
}
  1. endif
if (mouse || machineUID == KMachineUidSamsungI8510) {
S60->hasTouchscreen = false;
S60->virtualMouseRequired = false;
}
else if (!touch) {
S60->hasTouchscreen = false;
S60->virtualMouseRequired = true;
}
else {
S60->hasTouchscreen = true;
S60->virtualMouseRequired = false;
}

S60->avkonComponentsSupportTransparency = false;

S60->menuBeingConstructed = false;
  1. ifdef Q_WS_S60
TUid KCRUidAvkon = { 0x101F876E };
TUint32 KAknAvkonTransparencyEnabled = 0x0000000D;

CRepository* repository = 0;

TRAP (err, repository = CRepository::NewL(KCRUidAvkon));

if(err KErrNone) {

       TInt value = 0;
       err = repository->Get(KAknAvkonTransparencyEnabled, value);
       if(err  KErrNone) {
S60->avkonComponentsSupportTransparency = (value==1) ? true : false;
}
}
delete repository;
repository = 0;
  1. endif
  1. ifdef QT_KEYPAD_NAVIGATION
if (touch) {
QApplicationPrivate::navigationMode = Qt::NavigationModeNone;
} else {
QApplicationPrivate::navigationMode = Qt::NavigationModeKeypadDirectional;
}
  1. endif
  1. ifndef QT_NO_CURSOR
//Check if window server pointer cursors are supported or not
  1. ifndef Q_SYMBIAN_FIXED_POINTER_CURSORS
//In generic binary, use the HAL and OS version
//Any other known good phones should be added here.
if (machineUID == KMachineUidSamsungI8510 || (QSysInfo::symbianVersion() != QSysInfo::SV_9_4
&& QSysInfo::symbianVersion() != QSysInfo::SV_9_3 && QSysInfo::symbianVersion()
!= QSysInfo::SV_9_2)) {
S60->brokenPointerCursors = false;
qt_symbian_setWindowGroupCursor(Qt::ArrowCursor, S60->windowGroup());
}
else
S60->brokenPointerCursors = true;
  1. endif

if (S60->mouseInteractionEnabled) {

  1. ifndef Q_SYMBIAN_FIXED_POINTER_CURSORS
if (S60->brokenPointerCursors) {
qt_symbian_set_pointer_sprite(Qt::ArrowCursor);
qt_symbian_show_pointer_sprite();
}
else
  1. endif
S60->wsSession().SetPointerCursorMode(EPointerCursorNormal);
}
  1. endif

QFont systemFont;

systemFont.setFamily(systemFont.defaultFamily());
QApplicationPrivate::setSystemFont(systemFont);
  1. ifdef SYMBIAN_GRAPHICS_WSERV_QT_EFFECTS
QObject::connect(qApp, SIGNAL (aboutToQuit()), qApp, SLOT (_q_aboutToQuit()));
  1. endif

/*

### Commented out for now as parameter handling not needed in SOS (yet). Code below will break testlib with -o flag
int argc = priv->argc;
char **argv = priv->argv;

// Get command line params

int j = argc ? 1 : 0;
for (int i=1; i<argc; i+) {
if (argv[i] && *argv[i] != '-') {
argv[j+] = argv[i];
continue;
}
  1. if defined(QT_DEBUG)
if (qstrcmp(argv[i], "-nograb") == 0)
appNoGrab = !appNoGrab;
else
  1. endif // QT_DEBUG
;
}
  • /
// Register WId with the metatype system. This is to enable
// QWidgetPrivate::create_sys to used delayed slot invocation in order
// to destroy WId objects during reparenting.
qRegisterMetaType<WId>("WId");
}
代码很多,哈哈。上面代码中标有注释"这里就是创建程序的地方" 的部分:
TApaApplicationFactory factory(S60->s60ApplicationFactory ? S60->s60ApplicationFactory : newS60Application);
这里将newS60Application赋值给S60->s60ApplicationFactory,而newS60Application是什么呢,我们看看它的定义:
CApaApplication newS60Application()

{

return new QS60MainApplication;
}
由此可知newS60Application就是一个函数指针,它创建了一个QS60MainApplication实例,这里QS60MainApplication类封装了CAknApplication的实现。
另外上面代码中s60是一个全局数据,里面放了很多东西,主要是方便直接查询,其类结构如下:
class QS60Data

{ public:

QS60Data();
QThreadStorage<QS60ThreadLocalData> tls;
TUid uid;
int screenDepth;
QPoint lastCursorPos;
QPoint lastPointerEventPos;
QPointer<QWidget> lastPointerEventTarget;
QPointer<QWidget> mousePressTarget;
int screenWidthInPixels;
int screenHeightInPixels;
int screenWidthInTwips;
int screenHeightInTwips;
int defaultDpiX;
int defaultDpiY;
WId curWin;
enum PressedKeys {
Select = 0x1,
Right = 0x2,
Down = 0x4,
Left = 0x8,
Up = 0x10,
LeftUp = 0x20,
RightUp = 0x40,
RightDown = 0x80,
LeftDown = 0x100
};
int virtualMousePressedKeys; // of the above type, but avoids casting problems
int virtualMouseAccelDX;
int virtualMouseAccelDY;
QElapsedTimer virtualMouseAccelTimeout;
int virtualMouseMaxAccel;
  1. ifndef Q_SYMBIAN_FIXED_POINTER_CURSORS
int brokenPointerCursors : 1;
  1. endif
int hasTouchscreen : 1;
int mouseInteractionEnabled : 1;
int virtualMouseRequired : 1;
int qtOwnsS60Environment : 1;
int supportsPremultipliedAlpha : 1;
int avkonComponentsSupportTransparency : 1;
int menuBeingConstructed : 1;
QApplication::QS60MainApplicationFactory s60ApplicationFactory; // typedef'ed pointer type

enum ScanCodeState {

Unpressed,
KeyDown,
KeyDownAndKey
};
QHash<TInt, ScanCodeState> scanCodeStates;

static inline void updateScreenSize();

inline RWsSession& wsSession();
static inline RWindowGroup& windowGroup();
inline CWsScreenDevice* screenDevice();
static inline CCoeAppUi* appUi();
static inline CEikMenuBar* menuBar();
  1. ifdef Q_WS_S60
static inline CEikStatusPane* statusPane();
static inline CCoeControl* statusPaneSubPane(TInt aPaneId);
static inline CAknTitlePane* titlePane();
static inline CAknContextPane* contextPane();
static inline CEikButtonGroupContainer* buttonGroupContainer();
static void setStatusPaneAndButtonGroupVisibility(bool statusPaneVisible, bool buttonGroupVisible);
  1. endif
static void controlVisibilityChanged(CCoeControl *control, bool visible);
  1. ifdef Q_OS_SYMBIAN
TTrapHandler *s60InstalledTrapHandler;
  1. endif

};