installEventHandler (Android)
installEventHandler(eventName, handlerFunctionNameOrReference)
This function installs a global event handler. The script function named or referenced in handlerFunctionNameOrReference
, will be called when an event of the eventName
type occurs.
The eventName
can be the name of any of the following event types:
- BannerShown occurs when an
android.widget.Toast
is shown - DialogOpened occurs when an
android.app.AlertDialog
is shown - Vibrate occurs when the app calls the Android API function
android.os.Vibrator.vibrate
The function named in handlerFunctionName
is called with one argument—the object that was shown.
Note: In Python scripts, you can specify the callback function to invoke by passing an actual function or a lambda function.
For examples see How to Use Event Handlers.
Note: The installEventHandler
function will only work if it is called after the AUT has been hooked up, for example, by using the ApplicationContext startApplication(autName) function.
uninstallEventHandler(eventName, handlerFunctionNameOrReference)
This function uninstalls an event handler that has been previously installed using installEventHandler(eventName, handlerFunctionNameOrReference).
© 2025 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.
The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.
Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners.