Changeset View
Changeset View
Standalone View
Standalone View
src/kdeinit/ktoolinvocation.h
| Show First 20 Lines • Show All 76 Lines • ▼ Show 20 Line(s) | 76 | private: | |||
|---|---|---|---|---|---|
| 77 | KToolInvocation(); | 77 | KToolInvocation(); | ||
| 78 | public: | 78 | public: | ||
| 79 | // @internal | 79 | // @internal | ||
| 80 | ~KToolInvocation(); | 80 | ~KToolInvocation(); | ||
| 81 | static KToolInvocation *self(); | 81 | static KToolInvocation *self(); | ||
| 82 | 82 | | |||
| 83 | public Q_SLOTS: | 83 | public Q_SLOTS: | ||
| 84 | 84 | | |||
| 85 | #if KSERVICE_ENABLE_DEPRECATED_SINCE(5, 0) | ||||
| 85 | /** | 86 | /** | ||
| 86 | * Convenience method; invokes the standard email application. | 87 | * Convenience method; invokes the standard email application. | ||
| 87 | * | 88 | * | ||
| 88 | * @param address The destination address | 89 | * @param address The destination address | ||
| 89 | * @param subject Subject string. Can be QString(). | 90 | * @param subject Subject string. Can be QString(). | ||
| 90 | * @param startup_id for app startup notification, "0" for none, | 91 | * @param startup_id for app startup notification, "0" for none, | ||
| 91 | * "" ( empty string ) is the default | 92 | * "" ( empty string ) is the default | ||
| 92 | * | 93 | * | ||
| 93 | * @deprecated since 5.0, use QDesktopServices::openUrl(mailtoURL), | 94 | * @deprecated since 5.0, use QDesktopServices::openUrl(mailtoURL), | ||
| 94 | * using QUrl::setPath(address) and a query item of "subject" for the subject. | 95 | * using QUrl::setPath(address) and a query item of "subject" for the subject. | ||
| 95 | */ | 96 | */ | ||
| 96 | KSERVICE_DEPRECATED static void invokeMailer(const QString &address, const QString &subject, | 97 | KSERVICE_DEPRECATED_VERSION(5, 0, "Use QDesktopServices::openUrl(mailtoURL), using QUrl::setPath(address) and a query item of \"subject\" for the subject") | ||
| 98 | static void invokeMailer(const QString &address, const QString &subject, | ||||
| 97 | const QByteArray &startup_id = QByteArray()); | 99 | const QByteArray &startup_id = QByteArray()); | ||
| 98 | 100 | | |||
| 99 | /** | 101 | /** | ||
| 100 | * Invokes the standard email application. | 102 | * Invokes the standard email application. | ||
| 101 | * | 103 | * | ||
| 102 | * @param mailtoURL A mailto URL. | 104 | * @param mailtoURL A mailto URL. | ||
| 103 | * @param startup_id for app startup notification, "0" for none, | 105 | * @param startup_id for app startup notification, "0" for none, | ||
| 104 | * "" ( empty string ) is the default | 106 | * "" ( empty string ) is the default | ||
| 105 | * @param allowAttachments whether attachments specified in mailtoURL should be honoured. | 107 | * @param allowAttachments whether attachments specified in mailtoURL should be honoured. | ||
| 106 | * The default is false; do not honor requests for attachments. | 108 | * The default is false; do not honor requests for attachments. | ||
| 107 | * @deprecated since 5.0, use QDesktopServices::openUrl(mailtoURL) | 109 | * @deprecated since 5.0, use QDesktopServices::openUrl(mailtoURL) | ||
| 108 | */ | 110 | */ | ||
| 109 | KSERVICE_DEPRECATED static void invokeMailer(const QUrl &mailtoURL, const QByteArray &startup_id = QByteArray(), | 111 | KSERVICE_DEPRECATED_VERSION(5, 0, "Use QDesktopServices::openUrl(const QUrl&)") | ||
| 112 | static void invokeMailer(const QUrl &mailtoURL, const QByteArray &startup_id = QByteArray(), | ||||
| 110 | bool allowAttachments = false); | 113 | bool allowAttachments = false); | ||
| 114 | #endif | ||||
| 111 | 115 | | |||
| 112 | /** | 116 | /** | ||
| 113 | * Convenience method; invokes the standard email application. | 117 | * Convenience method; invokes the standard email application. | ||
| 114 | * | 118 | * | ||
| 115 | * All parameters are optional. | 119 | * All parameters are optional. | ||
| 116 | * | 120 | * | ||
| 117 | * @param to The destination address. | 121 | * @param to The destination address. | ||
| 118 | * @param cc The Cc field | 122 | * @param cc The Cc field | ||
| Show All 21 Lines | |||||
| 140 | * href="http://techbase.kde.org/Development/Architecture/KDE4/Starting_Other_Programs#KToolInvocation::invokeBrowser>techbase</a> | 144 | * href="http://techbase.kde.org/Development/Architecture/KDE4/Starting_Other_Programs#KToolInvocation::invokeBrowser>techbase</a> | ||
| 141 | * for a discussion of invokeBrowser vs KRun. | 145 | * for a discussion of invokeBrowser vs KRun. | ||
| 142 | * | 146 | * | ||
| 143 | * @param url The destination address | 147 | * @param url The destination address | ||
| 144 | * @param startup_id for app startup notification, "0" for none, | 148 | * @param startup_id for app startup notification, "0" for none, | ||
| 145 | * "" ( empty string ) is the default | 149 | * "" ( empty string ) is the default | ||
| 146 | * @deprecated since 5.0, use QDesktopServices::openUrl(url) | 150 | * @deprecated since 5.0, use QDesktopServices::openUrl(url) | ||
| 147 | */ | 151 | */ | ||
| 148 | KSERVICE_DEPRECATED static void invokeBrowser(const QString &url, | 152 | KSERVICE_DEPRECATED_VERSION(5, 0, "Use QDesktopServices::openUrl(const QUrl&)") | ||
| 153 | static void invokeBrowser(const QString &url, | ||||
dfaure: No #if for this one? | |||||
I cannot remember this was left out on purpose, so far assume I was just confused by the existing if/endif spanning multiple methods, and missing out this one was not covered. kossebau: I cannot remember this was left out on purpose, so far assume I was just confused by the… | |||||
| 149 | const QByteArray &startup_id = QByteArray()); | 154 | const QByteArray &startup_id = QByteArray()); | ||
| 150 | 155 | | |||
| 151 | /** | 156 | /** | ||
| 152 | * Invokes the standard terminal application. | 157 | * Invokes the standard terminal application. | ||
| 153 | * | 158 | * | ||
| 154 | * @param command the command to execute, can be empty. | 159 | * @param command the command to execute, can be empty. | ||
| 155 | * @param workdir the initial working directory, can be empty. | 160 | * @param workdir the initial working directory, can be empty. | ||
| 156 | * @param startup_id for app startup notification, "0" for none, | 161 | * @param startup_id for app startup notification, "0" for none, | ||
| 157 | * "" ( empty string ) is the default | 162 | * "" ( empty string ) is the default | ||
| 158 | * | 163 | * | ||
| 159 | * @since 4.1 | 164 | * @since 4.1 | ||
| 160 | */ | 165 | */ | ||
| 161 | static void invokeTerminal(const QString &command, | 166 | static void invokeTerminal(const QString &command, | ||
| 162 | const QString &workdir = QString(), | 167 | const QString &workdir = QString(), | ||
| 163 | const QByteArray &startup_id = ""); | 168 | const QByteArray &startup_id = ""); | ||
| 164 | 169 | | |||
| 165 | public: | 170 | public: | ||
| 166 | 171 | | |||
| 172 | #if KSERVICE_ENABLE_DEPRECATED_SINCE(5, 0) | ||||
| 167 | /** | 173 | /** | ||
| 168 | * Starts a service based on the (translated) name of the service. | 174 | * Starts a service based on the (translated) name of the service. | ||
| 169 | * E.g. "Web Browser" | 175 | * E.g. "Web Browser" | ||
| 170 | * | 176 | * | ||
| 171 | * @param _name the name of the service | 177 | * @param _name the name of the service | ||
| 172 | * @param URL if not empty this URL is passed to the service | 178 | * @param URL if not empty this URL is passed to the service | ||
| 173 | * @param error On failure, error contains a description of the error | 179 | * @param error On failure, error contains a description of the error | ||
| 174 | * that occurred. If the pointer is 0, the argument will be | 180 | * that occurred. If the pointer is 0, the argument will be | ||
| 175 | * ignored | 181 | * ignored | ||
| 176 | * @param serviceName On success, serviceName contains the D-Bus name | 182 | * @param serviceName On success, serviceName contains the D-Bus name | ||
| 177 | * under which this service is available. If empty, the service does | 183 | * under which this service is available. If empty, the service does | ||
| 178 | * not provide D-Bus services. If the pointer is 0 the argument | 184 | * not provide D-Bus services. If the pointer is 0 the argument | ||
| 179 | * will be ignored | 185 | * will be ignored | ||
| 180 | * @param pid On success, the process id of the new service will be written | 186 | * @param pid On success, the process id of the new service will be written | ||
| 181 | * here. If the pointer is 0, the argument will be ignored. | 187 | * here. If the pointer is 0, the argument will be ignored. | ||
| 182 | * @param startup_id for app startup notification, "0" for none, | 188 | * @param startup_id for app startup notification, "0" for none, | ||
| 183 | * "" ( empty string ) is the default | 189 | * "" ( empty string ) is the default | ||
| 184 | * @param noWait if set, the function does not wait till the service is running. | 190 | * @param noWait if set, the function does not wait till the service is running. | ||
| 185 | * @return an error code indicating success (== 0) or failure (> 0). | 191 | * @return an error code indicating success (== 0) or failure (> 0). | ||
| 186 | * @deprecated Use startServiceByDesktopName or startServiceByDesktopPath | 192 | * @deprecated Use startServiceByDesktopName or startServiceByDesktopPath | ||
| 187 | */ | 193 | */ | ||
| 188 | #ifndef KSERVICE_NO_DEPRECATED | 194 | KSERVICE_DEPRECATED_VERSION(5, 0, "Use KToolInvocation::startServiceByDesktopName(...) or KToolInvocation::startServiceByDesktopPath(...)") | ||
| 189 | KSERVICE_DEPRECATED static int startServiceByName(const QString &_name, const QString &URL, | 195 | static int startServiceByName(const QString &_name, const QString &URL, | ||
| 190 | QString *error = nullptr, QString *serviceName = nullptr, int *pid = nullptr, | 196 | QString *error = nullptr, QString *serviceName = nullptr, int *pid = nullptr, | ||
| 191 | const QByteArray &startup_id = QByteArray(), bool noWait = false); | 197 | const QByteArray &startup_id = QByteArray(), bool noWait = false); | ||
| 192 | #endif | | |||
| 193 | 198 | | |||
| 194 | /** | 199 | /** | ||
| 195 | * Starts a service based on the (translated) name of the service. | 200 | * Starts a service based on the (translated) name of the service. | ||
| 196 | * E.g. "Web Browser" | 201 | * E.g. "Web Browser" | ||
| 197 | * | 202 | * | ||
| 198 | * @param _name the name of the service | 203 | * @param _name the name of the service | ||
| 199 | * @param URLs if not empty these URLs will be passed to the service | 204 | * @param URLs if not empty these URLs will be passed to the service | ||
| 200 | * @param error On failure, @p error contains a description of the error | 205 | * @param error On failure, @p error contains a description of the error | ||
| 201 | * that occurred. If the pointer is 0, the argument will be | 206 | * that occurred. If the pointer is 0, the argument will be | ||
| 202 | * ignored | 207 | * ignored | ||
| 203 | * @param serviceName On success, @p serviceName contains the D-Bus name | 208 | * @param serviceName On success, @p serviceName contains the D-Bus name | ||
| 204 | * under which this service is available. If empty, the service does | 209 | * under which this service is available. If empty, the service does | ||
| 205 | * not provide D-Bus services. If the pointer is 0 the argument | 210 | * not provide D-Bus services. If the pointer is 0 the argument | ||
| 206 | * will be ignored | 211 | * will be ignored | ||
| 207 | * @param pid On success, the process id of the new service will be written | 212 | * @param pid On success, the process id of the new service will be written | ||
| 208 | * here. If the pointer is 0, the argument will be ignored. | 213 | * here. If the pointer is 0, the argument will be ignored. | ||
| 209 | * @param startup_id for app startup notification, "0" for none, | 214 | * @param startup_id for app startup notification, "0" for none, | ||
| 210 | * "" ( empty string ) is the default | 215 | * "" ( empty string ) is the default | ||
| 211 | * @param noWait if set, the function does not wait till the service is running. | 216 | * @param noWait if set, the function does not wait till the service is running. | ||
| 212 | * @return an error code indicating success (== 0) or failure (> 0). | 217 | * @return an error code indicating success (== 0) or failure (> 0). | ||
| 213 | * @deprecated Use startServiceByDesktopName or startServiceByDesktopPath | 218 | * @deprecated Use startServiceByDesktopName or startServiceByDesktopPath | ||
| 214 | */ | 219 | */ | ||
| 215 | #ifndef KSERVICE_NO_DEPRECATED | 220 | KSERVICE_DEPRECATED_VERSION(5, 0, "Use KToolInvocation::startServiceByDesktopName(...) or KToolInvocation::startServiceByDesktopPath(...)") | ||
| 216 | KSERVICE_DEPRECATED static int startServiceByName(const QString &_name, const QStringList &URLs = QStringList(), | 221 | static int startServiceByName(const QString &_name, const QStringList &URLs = QStringList(), | ||
| 217 | QString *error = nullptr, QString *serviceName = nullptr, int *pid = nullptr, | 222 | QString *error = nullptr, QString *serviceName = nullptr, int *pid = nullptr, | ||
| 218 | const QByteArray &startup_id = QByteArray(), bool noWait = false); | 223 | const QByteArray &startup_id = QByteArray(), bool noWait = false); | ||
| 219 | #endif | 224 | #endif | ||
| 220 | 225 | | |||
| 221 | /** | 226 | /** | ||
| 222 | * Starts a service based on the desktop path of the service. | 227 | * Starts a service based on the desktop path of the service. | ||
| 223 | * E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" | 228 | * E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" | ||
| 224 | * | 229 | * | ||
| ▲ Show 20 Lines • Show All 170 Lines • Show Last 20 Lines | |||||
No #if for this one?