Medical Imaging Interaction Toolkit
2024.12.99-0da743f6
Medical Imaging Interaction Toolkit
|
#include <mitkBaseApplication.h>
Public Member Functions | |
BaseApplication (int argc, char **argv) | |
~BaseApplication () override | |
void | initializeQt () |
int | run () override |
void | printHelp (const std::string &name, const std::string &value) |
void | setApplicationName (const QString &name) |
QString | getApplicationName () const |
void | setOrganizationName (const QString &name) |
QString | getOrganizationName () const |
void | setOrganizationDomain (const QString &name) |
QString | getOrganizationDomain () const |
void | setSingleMode (bool singleMode) |
bool | getSingleMode () const |
void | setSafeMode (bool safeMode) |
bool | getSafeMode () const |
void | setPreloadLibraries (const QStringList &libraryBaseNames) |
QStringList | getPreloadLibraries () const |
void | setProvisioningFilePath (const QString &filePath) |
QString | getProvisioningFilePath () const |
void | setProperty (const QString &property, const QVariant &value) |
QVariant | getProperty (const QString &property) const |
void | installTranslator (QTranslator *) |
bool | isRunning () |
void | sendMessage (const QByteArray) |
Static Public Attributes | |
static const QString | ARG_APPLICATION |
static const QString | ARG_CLEAN |
static const QString | ARG_CONSOLELOG |
static const QString | ARG_DEBUG |
static const QString | ARG_FORCE_PLUGIN_INSTALL |
static const QString | ARG_HOME |
static const QString | ARG_NEWINSTANCE |
static const QString | ARG_NO_LAZY_REGISTRY_CACHE_LOADING |
static const QString | ARG_NO_REGISTRY_CACHE |
static const QString | ARG_PLUGIN_CACHE |
static const QString | ARG_PLUGIN_DIRS |
static const QString | ARG_PRELOAD_LIBRARY |
static const QString | ARG_PRODUCT |
static const QString | ARG_PROVISIONING |
static const QString | ARG_REGISTRY_MULTI_LANGUAGE |
static const QString | ARG_SPLASH_IMAGE |
static const QString | ARG_STORAGE_DIR |
static const QString | ARG_XARGS |
static const QString | ARG_LOG_QT_MESSAGES |
static const QString | ARG_SEGMENTATION_LABELSET_PRESET |
static const QString | ARG_SEGMENTATION_LABEL_SUGGESTIONS |
static const QString | PROP_APPLICATION |
static const QString | PROP_FORCE_PLUGIN_INSTALL |
static const QString | PROP_NEWINSTANCE |
static const QString | PROP_NO_LAZY_REGISTRY_CACHE_LOADING |
static const QString | PROP_NO_REGISTRY_CACHE |
static const QString | PROP_PRODUCT |
static const QString | PROP_REGISTRY_MULTI_LANGUAGE |
Protected Member Functions | |
void | initialize (Poco::Util::Application &self) override |
void | uninitialize () override |
int | getArgc () const |
char ** | getArgv () const |
virtual QString | getCTKFrameworkStorageDir () const |
virtual void | initializeCppMicroServices () |
virtual QCoreApplication * | getQApplication () const |
virtual void | initializeLibraryPaths () |
int | main (const std::vector< std::string > &args) override |
void | defineOptions (Poco::Util::OptionSet &options) override |
QSharedPointer< ctkPluginFramework > | getFramework () const |
ctkPluginContext * | getFrameworkContext () const |
QHash< QString, QVariant > | getFrameworkProperties () const |
void | initializeSplashScreen (QCoreApplication *application) const |
A utility class for starting BlueBerry applications.
In the simplest case, create an instance of this class and call run(). This will launch a CTK plugin framework instance and execute the default application registered by a plug-in via the org.blueberry.osgi.applications extension point.
This class contains many convenience methods to:
The behavior can further be customized by deriving from BaseApplication and overriding specific methods, such as:
A simple but complete example:
Definition at line 75 of file mitkBaseApplication.h.
mitk::BaseApplication::BaseApplication | ( | int | argc, |
char ** | argv | ||
) |
|
override |
|
overrideprotected |
Define command line arguments
options |
QString mitk::BaseApplication::getApplicationName | ( | ) | const |
|
protected |
|
protected |
|
protectedvirtual |
Get the framework storage directory for the CTK plugin framework. This method is called in the initialize(Poco::Util::Application&) method. It must not be called without a QCoreApplications instance.
|
protected |
|
protected |
|
protected |
Get the initial properties for the CTK plugin framework.
The returned map contains the initial framework properties for initializing the CTK plugin framework. The value of specific properties may change at runtime and differ from the initial value.
QString mitk::BaseApplication::getOrganizationDomain | ( | ) | const |
QString mitk::BaseApplication::getOrganizationName | ( | ) | const |
QStringList mitk::BaseApplication::getPreloadLibraries | ( | ) | const |
Get the list of library base names which should be pre-loaded.
QVariant mitk::BaseApplication::getProperty | ( | const QString & | property | ) | const |
QString mitk::BaseApplication::getProvisioningFilePath | ( | ) | const |
Get the file path to the provisioning file.
|
protectedvirtual |
Get the QCoreApplication object.
This method is called in the initialize(Poco::Util::Application&) method and must create a QCoreApplication instance if the global qApp variable is not initialized yet.
bool mitk::BaseApplication::getSafeMode | ( | ) | const |
bool mitk::BaseApplication::getSingleMode | ( | ) | const |
|
overrideprotected |
|
protectedvirtual |
Initialize the CppMicroServices library.
The default implementation set the CppMicroServices storage path to the current ctkPluginConstants::FRAMEWORK_STORAGE property value.
This method is called in the initialize(Poco::Util::Application&) after the CTK Plugin Framework storage directory property was set.
|
protectedvirtual |
Add plugin library search paths to the CTK Plugin Framework.
This method is called in the nitialize(Poco::Util::Application&) method after getQApplication() was called.
void mitk::BaseApplication::initializeQt | ( | ) |
Initialize the Qt library such that a QCoreApplication instance is available and e.g. Qt widgets can be created.
This is usually not called directly by the user.
|
protected |
void mitk::BaseApplication::installTranslator | ( | QTranslator * | ) |
bool mitk::BaseApplication::isRunning | ( | ) |
|
overrideprotected |
Runs the application for which the platform was started. The platform must be running.
The given argument is passed to the application being run. If it is an invalid QVariant then the command line arguments used in starting the platform, and not consumed by the platform code, are passed to the application as a QStringList
.
args | the argument passed to the application. May be invalid |
std::exception | if anything goes wrong |
void mitk::BaseApplication::printHelp | ( | const std::string & | name, |
const std::string & | value | ||
) |
|
override |
Launches the BlueBerry framework and runs the default application or the one specified in the PROP_APPLICATION framework property.
void mitk::BaseApplication::sendMessage | ( | const | QByteArray | ) |
void mitk::BaseApplication::setApplicationName | ( | const QString & | name | ) |
Set the application name. Same as QCoreApplication::setApplicationName.
name | The application name. |
void mitk::BaseApplication::setOrganizationDomain | ( | const QString & | name | ) |
Set the organization domain. Same as QCoreApplication::setOrganizationDomain.
name | The organization domain. |
void mitk::BaseApplication::setOrganizationName | ( | const QString & | name | ) |
Set the organization name. Same as QCoreApplication::setOrganizationName.
name | The organization name. |
void mitk::BaseApplication::setPreloadLibraries | ( | const QStringList & | libraryBaseNames | ) |
Set a list of library names or absolute file paths which should be loaded at application start-up. The name and file path may contain a library version appended at the end and separated by a '$' charactger.
For example liborg_mitk_gui_qt_common$1.0
. Platform specific suffixes are appended automatically.
libraryBaseNames | A list of library base names. |
void mitk::BaseApplication::setProperty | ( | const QString & | property, |
const QVariant & | value | ||
) |
void mitk::BaseApplication::setProvisioningFilePath | ( | const QString & | filePath | ) |
Set the path to the provisioning file.
By default a provisioning file located in the same directory as the executable and named <executable>.provisioning is loaded if it exists. To disable parsing of provisioning files, use an empty string as the argument. Use a null QString (QString::null
) to reset to the default behaviour.
filePath | An absolute file path to the provisioning file. |
void mitk::BaseApplication::setSafeMode | ( | bool | safeMode | ) |
Put the application in safe mode, catching exceptions from the Qt event loop.
safeMode |
void mitk::BaseApplication::setSingleMode | ( | bool | singleMode | ) |
Put the application in single mode, which by default only allows a single instance of the application to be created.
Calling this method after run() has been called has no effect.
singleMode |
|
overrideprotected |
|
static |
Definition at line 80 of file mitkBaseApplication.h.
|
static |
Definition at line 81 of file mitkBaseApplication.h.
|
static |
Definition at line 82 of file mitkBaseApplication.h.
|
static |
Definition at line 83 of file mitkBaseApplication.h.
|
static |
Definition at line 84 of file mitkBaseApplication.h.
|
static |
Definition at line 85 of file mitkBaseApplication.h.
|
static |
Definition at line 98 of file mitkBaseApplication.h.
|
static |
Definition at line 86 of file mitkBaseApplication.h.
|
static |
Definition at line 87 of file mitkBaseApplication.h.
|
static |
Definition at line 88 of file mitkBaseApplication.h.
|
static |
Definition at line 89 of file mitkBaseApplication.h.
|
static |
Definition at line 90 of file mitkBaseApplication.h.
|
static |
Definition at line 91 of file mitkBaseApplication.h.
|
static |
Definition at line 92 of file mitkBaseApplication.h.
|
static |
Definition at line 93 of file mitkBaseApplication.h.
|
static |
Definition at line 94 of file mitkBaseApplication.h.
|
static |
Definition at line 100 of file mitkBaseApplication.h.
|
static |
Definition at line 99 of file mitkBaseApplication.h.
|
static |
Definition at line 95 of file mitkBaseApplication.h.
|
static |
Definition at line 96 of file mitkBaseApplication.h.
|
static |
Definition at line 97 of file mitkBaseApplication.h.
|
static |
Definition at line 104 of file mitkBaseApplication.h.
|
static |
Definition at line 105 of file mitkBaseApplication.h.
|
static |
Definition at line 106 of file mitkBaseApplication.h.
|
static |
Definition at line 107 of file mitkBaseApplication.h.
|
static |
Definition at line 108 of file mitkBaseApplication.h.
|
static |
Definition at line 109 of file mitkBaseApplication.h.
|
static |
Definition at line 110 of file mitkBaseApplication.h.