QtAndroid 名称空间

The QtAndroid namespace provides miscellaneous functions to aid Android development. 更多...

头: #include <QtAndroid>
qmake: QT += androidextras
Since: Qt 5.3

    类型

    typedef Runnable

    函数

    QAndroidJniObject androidActivity ()
    QAndroidJniObject androidContext ()
    int androidSdkVersion ()
    QAndroidJniObject androidService ()
    void hideSplashScreen ()
    void runOnAndroidThread (const Runnable & runnable )
    void runOnAndroidThreadSync (const Runnable & runnable , int timeoutMs = INT_MAX)
    void startActivity (const QAndroidJniObject & intent , int receiverRequestCode , QAndroidActivityResultReceiver * resultReceiver = nullptr)
    void startIntentSender (const QAndroidJniObject & intentSender , int receiverRequestCode , QAndroidActivityResultReceiver * resultReceiver = nullptr)

    详细描述

    The QtAndroid namespace provides miscellaneous functions to aid Android development.

    类型文档编制

    typedef QtAndroid:: Runnable

    函数文档编制

    QAndroidJniObject QtAndroid:: androidActivity ()

    Returns a handle to this application's main Activity

    该函数在 Qt 5.3 引入。

    另请参阅 QAndroidJniObject , androidService (),和 androidContext ().

    QAndroidJniObject QtAndroid:: androidContext ()

    Returns a handle to this application's main Context. Depending on the nature of the application the Context object is either the main Service or Activity object.

    该函数在 Qt 5.8 引入。

    另请参阅 QAndroidJniObject , androidActivity (),和 androidService ().

    int QtAndroid:: androidSdkVersion ()

    返回 Android SDK 版本。这又称为 API 级别。

    该函数在 Qt 5.3 引入。

    QAndroidJniObject QtAndroid:: androidService ()

    Returns a handle to this application's main Service

    该函数在 Qt 5.7 引入。

    另请参阅 QAndroidJniObject , androidActivity (),和 androidContext ().

    void QtAndroid:: hideSplashScreen ()

    Hides the splash screen.

    该函数在 Qt 5.7 引入。

    void QtAndroid:: runOnAndroidThread (const Runnable & runnable )

    Posts the given runnable on the android thread. The runnable will be queued and executed on the Android UI thread, unless it called on the Android UI thread, in which case the runnable will be executed immediately.

    This function is useful to set asynchronously properties of objects that must be set on on Android UI thread.

    该函数在 Qt 5.7 引入。

    void QtAndroid:: runOnAndroidThreadSync (const Runnable & runnable , int timeoutMs = INT_MAX)

    Posts the runnable on the Android UI thread and waits until the runnable is executed, or until timeoutMs has passed

    This function is useful to create objects, or get properties on Android UI thread:

    QAndroidJniObject javaControl;
    QtAndroid::runOnAndroidThreadSync([&javaControl](){
        // create our Java control on Android UI thread.
        javaControl = QAndroidJniObject("android/webkit/WebView",
                                                    "(Landroid/content/Context;)V",
                                                    QtAndroid::androidActivity().object<jobject>());
        javaControl.callMethod<void>("setWebViewClient",
                                       "(Landroid/webkit/WebViewClient;)V",
                                       QAndroidJniObject("android/webkit/WebViewClient").object());
    });
    // Continue the execution normally
    qDebug() << javaControl.isValid();
    					

    该函数在 Qt 5.7 引入。

    void QtAndroid:: startActivity (const QAndroidJniObject & intent , int receiverRequestCode , QAndroidActivityResultReceiver * resultReceiver = nullptr)

    Starts the activity given by intent and provides the result asynchronously through the resultReceiver if this is non-null.

    resultReceiver 为 null,那么 startActivity() method in the androidActivity() will be called. Otherwise startActivityForResult() will be called.

    The receiverRequestCode is a request code unique to the resultReceiver , and will be returned along with the result, making it possible to use the same receiver for more than one intent.

    该函数在 Qt 5.3 引入。

    void QtAndroid:: startIntentSender (const QAndroidJniObject & intentSender , int receiverRequestCode , QAndroidActivityResultReceiver * resultReceiver = nullptr)

    Starts the activity given by intentSender and provides the result asynchronously through the resultReceiver if this is non-null.

    resultReceiver 为 null,那么 startIntentSender() method in the androidActivity() will be called. Otherwise startIntentSenderForResult() will be called.

    The receiverRequestCode is a request code unique to the resultReceiver , and will be returned along with the result, making it possible to use the same receiver for more than one intent.

    该函数在 Qt 5.3 引入。