File indexing completed on 2023-09-24 04:03:46
0001 /* 0002 This file is part of the KDE libraries 0003 SPDX-FileCopyrightText: 1999, 2000 Kurt Granroth <granroth@kde.org> 0004 SPDX-FileCopyrightText: 2001, 2002 Ellis Whitehead <ellis@kde.org> 0005 0006 SPDX-License-Identifier: LGPL-2.0-only 0007 */ 0008 #ifndef KSTANDARDACTION_H 0009 #define KSTANDARDACTION_H 0010 0011 #include <QAction> 0012 #include <QList> 0013 #include <QStringList> 0014 0015 #include <KStandardShortcut> 0016 #include <KToggleAction> 0017 #include <kconfigwidgets_export.h> 0018 #include <khamburgermenu.h> 0019 #include <krecentfilesaction.h> 0020 #include <ktogglefullscreenaction.h> 0021 0022 #include <type_traits> 0023 0024 class QObject; 0025 class QWidget; 0026 class QAction; 0027 class KToggleAction; 0028 class KToggleFullScreenAction; 0029 0030 /** 0031 * Convenience methods to access all standard KDE actions. 0032 * 0033 * These actions should be used instead of hardcoding menubar and 0034 * toolbar items. Using these actions helps your application easily 0035 * conform to the <a href="https://develop.kde.org/hig/">KDE Human Interface Guidelines</a>. 0036 * 0037 * All of the documentation for QAction holds for KStandardAction 0038 * also. When in doubt on how things work, check the QAction 0039 * documentation first. 0040 * Please note that calling any of these methods automatically adds the action 0041 * to the actionCollection() of the QObject given by the 'parent' parameter. 0042 * 0043 * <b>Simple Example:</b>\n 0044 * 0045 * In general, using standard actions should be a drop in replacement 0046 * for regular actions. For example, if you previously had: 0047 * @code 0048 * QAction *newAct = new QAction(i18n("&New"), 0049 * QIcon::fromTheme("document-new"), 0050 * KStandardShortcut::shortcut(KStandardShortcut::New), 0051 * this, 0052 * &ClassFoo::fileNew, 0053 * actionCollection()); 0054 * @endcode 0055 * 0056 * You can replace it with: 0057 * @code 0058 * QAction *newAct = KStandardAction::openNew(this, &ClassFoo::fileNew, actionCollection()); 0059 * @endcode 0060 * 0061 * <b>Non-standard Usages</b>\n 0062 * 0063 * It is possible to use the standard actions in various 0064 * non-recommended ways. Say, for instance, you wanted to have a 0065 * standard action (with the associated correct text and icon and 0066 * accelerator, etc) but you didn't want it to go in the standard 0067 * place (this is not recommended, by the way). One way to do this is 0068 * to simply not use the XML UI framework and plug it into wherever 0069 * you want. If you do want to use the XML UI framework (good!), then 0070 * it is still possible. 0071 * 0072 * Basically, the XML building code matches names in the XML code with 0073 * the internal names of the actions. You can find out the internal 0074 * names of each of the standard actions by using the name 0075 * method like so: KStandardAction::name(KStandardAction::Cut) would return 0076 * 'edit_cut'. The XML building code will match 'edit_cut' to the 0077 * attribute in the global XML file and place your action there. 0078 * 0079 * However, you can change the internal name. In this example, just 0080 * do something like: 0081 * 0082 * \code 0083 * (void)KStandardAction::cut(this, SLOT(editCut()), actionCollection(), "my_cut"); 0084 * \endcode 0085 * 0086 * Now, in your local XML resource file (e.g., yourappui.rc), simply 0087 * put 'my_cut' where you want it to go. 0088 * 0089 * Another non-standard usage concerns getting a pointer to an 0090 * existing action if, say, you want to enable or disable the action. 0091 * You could do it the recommended way and just grab a pointer when 0092 * you instantiate it as in the 'openNew' example above... or you 0093 * could do it the hard way: 0094 * 0095 * \code 0096 * QAction *cut = actionCollection()->action(KStandardAction::name(KStandardAction::Cut)); 0097 * \endcode 0098 * 0099 * Another non-standard usage concerns instantiating the action in the 0100 * first place. Usually, you would use the member functions as 0101 * shown above (e.g., KStandardAction::cut(this, SLOT, parent)). You 0102 * may, however, do this using the enums provided. This author can't 0103 * think of a reason why you would want to, but, hey, if you do, 0104 * here's how: 0105 * 0106 * \code 0107 * (void)KStandardAction::action(KStandardAction::New, this, SLOT(fileNew()), actionCollection()); 0108 * (void)KStandardAction::action(KStandardAction::Cut, this, SLOT(editCut()), actionCollection()); 0109 * \endcode 0110 * 0111 * @author Kurt Granroth <granroth@kde.org> 0112 */ 0113 namespace KStandardAction 0114 { 0115 /** 0116 * The standard menubar and toolbar actions. 0117 */ 0118 enum StandardAction { 0119 ActionNone, 0120 // File Menu 0121 New, ///< Create a new document or window. 0122 Open, ///< Open an existing file. 0123 OpenRecent, ///< Open a recently used document. 0124 Save, ///< Save the current document. 0125 SaveAs, ///< Save the current document under a different name. 0126 Revert, ///< Revert the current document to the last saved version. 0127 Close, ///< Close the current document. 0128 Print, ///< Print the current document. 0129 PrintPreview, ///< Show a print preview of the current document. 0130 Mail, ///< Send the current document by mail. 0131 Quit, ///< Quit the program. 0132 // Edit Menu 0133 Undo, ///< Undo the last operation. 0134 Redo, ///< Redo the last operation. 0135 Cut, ///< Cut selected area and store it in the clipboard. 0136 Copy, ///< Copy selected area and store it in the clipboard. 0137 Paste, ///< Paste the contents of clipboard at the current mouse or cursor. 0138 SelectAll, ///< Select all elements in the current document. 0139 Deselect, ///< Deselect any selected elements in the current document. 0140 Find, ///< Initiate a 'find' request in the current document. 0141 FindNext, ///< Find the next instance of a stored 'find' 0142 FindPrev, ///< Find a previous instance of a stored 'find'. 0143 Replace, ///< Find and replace matches. 0144 // View Menu 0145 ActualSize, ///< View the document at its actual size. 0146 FitToPage, ///< Fit the document view to the size of the current window. 0147 FitToWidth, ///< Fit the document view to the width of the current window. 0148 FitToHeight, ///< Fit the document view to the height of the current window. 0149 ZoomIn, ///< Zoom in the current document. 0150 ZoomOut, ///< Zoom out the current document. 0151 Zoom, ///< Select the current zoom level. 0152 Redisplay, ///< Redisplay or redraw the document. 0153 // Go Menu 0154 Up, ///< Move up (web style menu). 0155 Back, ///< Move back (web style menu). 0156 Forward, ///< Move forward (web style menu). 0157 Home, ///< Go to the "Home" position or document. 0158 Prior, ///< Scroll up one page. 0159 Next, ///< Scroll down one page. 0160 Goto, ///< Jump to some specific location in the document. 0161 GotoPage, ///< Go to a specific page. 0162 GotoLine, ///< Go to a specific line. 0163 FirstPage, ///< Jump to the first page. 0164 LastPage, ///< Jump to the last page. 0165 DocumentBack, ///< Move back (document style menu). 0166 DocumentForward, ///< Move forward (document style menu). 0167 // Bookmarks Menu 0168 AddBookmark, ///< Add the current page to the bookmarks tree. 0169 EditBookmarks, ///< Edit the application bookmarks. 0170 // Tools Menu 0171 Spelling, ///< Pop up the spell checker. 0172 // Settings Menu 0173 ShowMenubar, ///< Show/Hide the menubar. 0174 ShowToolbar, ///< Show/Hide the toolbar. 0175 ShowStatusbar, ///< Show/Hide the statusbar. 0176 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 38) 0177 SaveOptions ///< @deprecated Since 5.38, no known users. 0178 KCONFIGWIDGETS_ENUMERATOR_DEPRECATED_VERSION_BELATED(5, 82, 5, 38, "No known users"), 0179 #elif KCONFIGWIDGETS_BUILD_DEPRECATED_SINCE(5, 38) 0180 SaveOptions_DEPRECATED_DO_NOT_USE, 0181 #endif 0182 KeyBindings, ///< Display the configure key bindings dialog. 0183 Preferences, ///< Display the preferences/options dialog. 0184 ConfigureToolbars, ///< Display the toolbar configuration dialog. 0185 // Help Menu 0186 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 38) 0187 Help ///< @deprecated Since 5.38, use HelpContents instead. 0188 KCONFIGWIDGETS_ENUMERATOR_DEPRECATED_VERSION_BELATED(5, 82, 5, 38, "Use HelpContents instead"), 0189 #elif KCONFIGWIDGETS_BUILD_DEPRECATED_SINCE(5, 38) 0190 Help_DEPRECATED_DO_NOT_USE, 0191 #endif 0192 HelpContents, ///< Display the handbook of the application. 0193 WhatsThis, ///< Trigger the What's This cursor. 0194 ReportBug, ///< Open up the Report Bug dialog. 0195 AboutApp, ///< Display the application's About box. 0196 AboutKDE, ///< Display the About KDE dialog. 0197 TipofDay, ///< Display the "Tip of the Day". 0198 // Other standard actions 0199 ConfigureNotifications, ///< Display the notifications configuration dialog. 0200 FullScreen, ///< Switch to/from full screen mode. 0201 Clear, ///< Clear the content of the focus widget. 0202 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 39) 0203 PasteText ///< @deprecated Since 5.39, use Paste instead. 0204 KCONFIGWIDGETS_ENUMERATOR_DEPRECATED_VERSION_BELATED(5, 82, 5, 39, "Use Paste instead"), 0205 #elif KCONFIGWIDGETS_BUILD_DEPRECATED_SINCE(5, 39) 0206 PasteText_DEPRECATED_DO_NOT_USE, 0207 #endif 0208 SwitchApplicationLanguage, ///< Display the Switch Application Language dialog. 0209 DeleteFile, ///< Permanently deletes files or folders. @since 5.25 0210 RenameFile, ///< Renames files or folders. @since 5.25 0211 MoveToTrash, ///< Moves files or folders to the trash. @since 5.25 0212 Donate, ///< Open donation page on kde.org. @since 5.26 0213 HamburgerMenu ///< Opens a menu that substitutes the menubar. @since 5.81 0214 }; 0215 0216 /** 0217 * Creates an action corresponding to one of the 0218 * KStandardAction::StandardAction actions, which is connected to the given 0219 * object and @p slot, and is owned by @p parent. 0220 * 0221 * The signal that is connected to @p slot is triggered(bool), except for the case of 0222 * OpenRecent standard action, which uses the urlSelected(const QUrl &) signal of 0223 * KRecentFilesAction. 0224 * 0225 * @param id The StandardAction identifier to create a QAction for. 0226 * @param recvr The QObject to receive the signal, or @c nullptr if no notification 0227 * is needed. 0228 * @param slot The slot to connect the signal to (remember to use the SLOT() macro). 0229 * @param parent The QObject that should own the created QAction, or @c nullptr if no parent will 0230 * own the QAction returned (ensure you delete it manually in this case). 0231 */ 0232 KCONFIGWIDGETS_EXPORT QAction *create(StandardAction id, const QObject *recvr, const char *slot, QObject *parent); 0233 0234 /** 0235 * @internal 0236 */ 0237 KCONFIGWIDGETS_EXPORT QAction *_k_createInternal(StandardAction id, QObject *parent); 0238 0239 /** 0240 * This overloads create() to allow using the new connect syntax 0241 * @note if you use @c OpenRecent as @p id, you should manually connect to the urlSelected(const QUrl &) 0242 * signal of the returned KRecentFilesAction instead or use KStandardAction::openRecent(Receiver *, Func). 0243 * 0244 * If not explicitely specified, @p connectionType will be AutoConnection for all actions 0245 * except for ConfigureToolbars that will be QueuedConnection. 0246 * 0247 * @see create(StandardAction, const QObject *, const char *, QObject *) 0248 * @since 5.23 (The connectionType argument was added in 5.95) 0249 */ 0250 #ifdef K_DOXYGEN 0251 inline QAction *create(StandardAction id, const QObject *recvr, Func slot, QObject *parent, Qt::ConnectionType connectionType = -1) 0252 #else 0253 template<class Receiver, class Func> 0254 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, QAction>::type * 0255 create(StandardAction id, const Receiver *recvr, Func slot, QObject *parent, Qt::ConnectionType connectionType = static_cast<Qt::ConnectionType>(-1)) 0256 #endif 0257 { 0258 QAction *action = _k_createInternal(id, parent); 0259 // ConfigureToolbars is special because of bug #200815 0260 const Qt::ConnectionType defaultConnectionType = (id == ConfigureToolbars) ? Qt::QueuedConnection : Qt::AutoConnection; 0261 QObject::connect(action, &QAction::triggered, recvr, slot, connectionType != static_cast<Qt::ConnectionType>(-1) ? connectionType : defaultConnectionType); 0262 return action; 0263 } 0264 0265 /** 0266 * This will return the internal name of a given standard action. 0267 * 0268 * The returned const char* only contains ASCII characters. 0269 */ 0270 KCONFIGWIDGETS_EXPORT const char *name(StandardAction id); 0271 0272 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(4, 0) 0273 /// @deprecated Since 4.0, use name(StandardAction) 0274 KCONFIGWIDGETS_DEPRECATED_VERSION(4, 0, "Use KStandardAction::name(StandardAction)") 0275 inline const char *stdName(StandardAction act_enum) 0276 { 0277 return name(act_enum); 0278 } 0279 #endif 0280 0281 /** 0282 * Returns a list of all standard names. Used by KAccelManager 0283 * to give those higher weight. 0284 */ 0285 KCONFIGWIDGETS_EXPORT QStringList stdNames(); 0286 0287 /** 0288 * Returns a list of all actionIds. 0289 * 0290 * @since 4.2 0291 */ 0292 KCONFIGWIDGETS_EXPORT QList<StandardAction> actionIds(); 0293 0294 /** 0295 * Returns the standardshortcut associated with @a actionId. 0296 * 0297 * @param id The identifier whose associated shortcut is wanted. 0298 * 0299 * @since 4.2 0300 */ 0301 KCONFIGWIDGETS_EXPORT KStandardShortcut::StandardShortcut shortcutForActionId(StandardAction id); 0302 0303 // clang-format off 0304 // we have to disable the templated function for const char* as Func, since it is ambiguous otherwise 0305 // TODO: KF6: unify const char* version and new style by removing std::enable_if 0306 #ifdef K_DOXYGEN 0307 #define KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(name, enumValue) \ 0308 inline QAction *name(const QObject *recvr, Func slot, QObject *parent); 0309 #else 0310 #define KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(name, enumValue) \ 0311 template<class Receiver, class Func> \ 0312 inline typename std::enable_if<!std::is_convertible<Func, const char*>::value, QAction>::type *name(const Receiver *recvr, Func slot, QObject *parent) \ 0313 { return create(enumValue, recvr, slot, parent); } 0314 #endif 0315 // clang-format on 0316 0317 /** 0318 * Create a new document or window. 0319 */ 0320 KCONFIGWIDGETS_EXPORT QAction *openNew(const QObject *recvr, const char *slot, QObject *parent); 0321 0322 /** 0323 * Create a new document or window. 0324 * @since 5.23 0325 */ 0326 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(openNew, New) 0327 0328 /** 0329 * Open an existing file. 0330 */ 0331 KCONFIGWIDGETS_EXPORT QAction *open(const QObject *recvr, const char *slot, QObject *parent); 0332 0333 /** 0334 * Open an existing file. 0335 * @since 5.23 0336 */ 0337 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(open, Open) 0338 0339 /** 0340 * Open a recently used document. The signature of the slot being called 0341 * is of the form slotURLSelected( const QUrl & ). 0342 * @param recvr object to receive slot 0343 * @param slot The SLOT to invoke when a URL is selected. The slot's 0344 * signature is slotURLSelected( const QUrl & ). 0345 * @param parent parent widget 0346 */ 0347 KCONFIGWIDGETS_EXPORT KRecentFilesAction *openRecent(const QObject *recvr, const char *slot, QObject *parent); 0348 0349 /** 0350 * The same as openRecent(const QObject *, const char *, QObject *), but using new-style connect syntax 0351 * @see openRecent(const QObject *, const char *, QObject *) 0352 * @since 5.23 0353 */ 0354 #ifdef K_DOXYGEN 0355 inline KRecentFilesAction *openRecent(const QObject *recvr, Func slot, QObject *parent) 0356 #else 0357 template<class Receiver, class Func> 0358 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, KRecentFilesAction>::type * 0359 openRecent(const Receiver *recvr, Func slot, QObject *parent) 0360 #endif 0361 { 0362 QAction *action = _k_createInternal(OpenRecent, parent); 0363 KRecentFilesAction *recentAction = qobject_cast<KRecentFilesAction *>(action); 0364 Q_ASSERT(recentAction); 0365 QObject::connect(recentAction, &KRecentFilesAction::urlSelected, recvr, slot); 0366 return recentAction; 0367 } 0368 0369 /** 0370 * Save the current document. 0371 */ 0372 KCONFIGWIDGETS_EXPORT QAction *save(const QObject *recvr, const char *slot, QObject *parent); 0373 0374 /** 0375 * Save the current document. 0376 * @since 5.23 0377 */ 0378 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(save, Save) 0379 0380 /** 0381 * Save the current document under a different name. 0382 */ 0383 KCONFIGWIDGETS_EXPORT QAction *saveAs(const QObject *recvr, const char *slot, QObject *parent); 0384 0385 /** 0386 * Save the current document under a different name. 0387 * @since 5.23 0388 */ 0389 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(saveAs, SaveAs) 0390 0391 /** 0392 * Revert the current document to the last saved version 0393 * (essentially will undo all changes). 0394 */ 0395 KCONFIGWIDGETS_EXPORT QAction *revert(const QObject *recvr, const char *slot, QObject *parent); 0396 0397 /** 0398 * Revert the current document to the last saved version 0399 * (essentially will undo all changes). 0400 * @since 5.23 0401 */ 0402 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(revert, Revert) 0403 0404 /** 0405 * Close the current document. 0406 */ 0407 KCONFIGWIDGETS_EXPORT QAction *close(const QObject *recvr, const char *slot, QObject *parent); 0408 0409 /** 0410 * Close the current document. 0411 * @since 5.23 0412 */ 0413 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(close, Close) 0414 0415 /** 0416 * Print the current document. 0417 */ 0418 KCONFIGWIDGETS_EXPORT QAction *print(const QObject *recvr, const char *slot, QObject *parent); 0419 0420 /** 0421 * Print the current document. 0422 * @since 5.23 0423 */ 0424 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(print, Print) 0425 0426 /** 0427 * Show a print preview of the current document. 0428 */ 0429 KCONFIGWIDGETS_EXPORT QAction *printPreview(const QObject *recvr, const char *slot, QObject *parent); 0430 0431 /** 0432 * Show a print preview of the current document. 0433 * @since 5.23 0434 */ 0435 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(printPreview, PrintPreview) 0436 0437 /** 0438 * Send the current document by mail. 0439 */ 0440 KCONFIGWIDGETS_EXPORT QAction *mail(const QObject *recvr, const char *slot, QObject *parent); 0441 0442 /** 0443 * Mail this document. 0444 * @since 5.23 0445 */ 0446 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(mail, Mail) 0447 0448 /** 0449 * Quit the program. 0450 * 0451 * Note that you probably want to connect this action to either QWidget::close() 0452 * or QApplication::closeAllWindows(), but not QApplication::quit(), so that 0453 * KMainWindow::queryClose() is called on any open window (to warn the user 0454 * about unsaved changes for example). 0455 */ 0456 KCONFIGWIDGETS_EXPORT QAction *quit(const QObject *recvr, const char *slot, QObject *parent); 0457 0458 /** 0459 * Quit the program. 0460 * @see quit(const QObject *recvr, const char *slot, QObject *parent) 0461 * @since 5.23 0462 */ 0463 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(quit, Quit) 0464 0465 /** 0466 * Undo the last operation. 0467 */ 0468 KCONFIGWIDGETS_EXPORT QAction *undo(const QObject *recvr, const char *slot, QObject *parent); 0469 0470 /** 0471 * Undo the last operation. 0472 * @since 5.23 0473 */ 0474 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(undo, Undo) 0475 0476 /** 0477 * Redo the last operation. 0478 */ 0479 KCONFIGWIDGETS_EXPORT QAction *redo(const QObject *recvr, const char *slot, QObject *parent); 0480 0481 /** 0482 * Redo the last operation. 0483 * @since 5.23 0484 */ 0485 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(redo, Redo) 0486 0487 /** 0488 * Cut selected area and store it in the clipboard. 0489 * Calls cut() on the widget with the current focus. 0490 */ 0491 KCONFIGWIDGETS_EXPORT QAction *cut(QObject *parent); 0492 0493 /** 0494 * Copy selected area and store it in the clipboard. 0495 * Calls copy() on the widget with the current focus. 0496 */ 0497 KCONFIGWIDGETS_EXPORT QAction *copy(QObject *parent); 0498 0499 /** 0500 * Paste the contents of clipboard at the current mouse or cursor 0501 * Calls paste() on the widget with the current focus. 0502 */ 0503 KCONFIGWIDGETS_EXPORT QAction *paste(QObject *parent); 0504 0505 /** 0506 * Clear selected area. Calls clear() on the widget with the current focus. 0507 * Note that for some widgets, this may not provide the intended behavior. For 0508 * example if you make use of the code above and a K3ListView has the focus, clear() 0509 * will clear all of the items in the list. If this is not the intended behavior 0510 * and you want to make use of this slot, you can subclass K3ListView and reimplement 0511 * this slot. For example the following code would implement a K3ListView without this 0512 * behavior: 0513 * 0514 * \code 0515 * class MyListView : public K3ListView { 0516 * Q_OBJECT 0517 * public: 0518 * MyListView( QWidget * parent = 0, const char * name = 0, WFlags f = 0 ) : K3ListView( parent, name, f ) {} 0519 * virtual ~MyListView() {} 0520 * public Q_SLOTS: 0521 * virtual void clear() {} 0522 * }; 0523 * \endcode 0524 */ 0525 KCONFIGWIDGETS_EXPORT QAction *clear(QObject *parent); 0526 0527 /** 0528 * Calls selectAll() on the widget with the current focus. 0529 */ 0530 KCONFIGWIDGETS_EXPORT QAction *selectAll(QObject *parent); 0531 0532 /** 0533 * Cut selected area and store it in the clipboard. 0534 */ 0535 KCONFIGWIDGETS_EXPORT QAction *cut(const QObject *recvr, const char *slot, QObject *parent); 0536 0537 /** 0538 * Cut selected area and store it in the clipboard. 0539 * @since 5.23 0540 */ 0541 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(cut, Cut) 0542 0543 /** 0544 * Copy the selected area into the clipboard. 0545 */ 0546 KCONFIGWIDGETS_EXPORT QAction *copy(const QObject *recvr, const char *slot, QObject *parent); 0547 0548 /** 0549 * Copy the selected area into the clipboard. 0550 * @since 5.23 0551 */ 0552 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(copy, Copy) 0553 0554 /** 0555 * Paste the contents of clipboard at the current mouse or cursor 0556 * position. 0557 */ 0558 KCONFIGWIDGETS_EXPORT QAction *paste(const QObject *recvr, const char *slot, QObject *parent); 0559 0560 /** 0561 * Paste the contents of clipboard at the current mouse or cursor 0562 * position. 0563 * @since 5.23 0564 */ 0565 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(paste, Paste) 0566 0567 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 39) 0568 /** 0569 * @deprecated since 5.39. Use paste() instead. 0570 */ 0571 KCONFIGWIDGETS_EXPORT 0572 KCONFIGWIDGETS_DEPRECATED_VERSION(5, 39, "Use KStandardAction::paste(const QObject *, const char *, QObject *)") 0573 QAction *pasteText(const QObject *recvr, const char *slot, QObject *parent); 0574 #endif 0575 0576 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 39) 0577 /** 0578 * @since 5.23 0579 * @deprecated since 5.39. Use paste() instead. 0580 */ 0581 #ifdef K_DOXYGEN 0582 inline QAction *pasteText(const QObject *recvr, Func slot, QObject *parent); 0583 #else 0584 template<class Receiver, class Func> 0585 KCONFIGWIDGETS_DEPRECATED_VERSION(5, 39, "Use KStandardAction::paste(const QObject *, Func, QObject *)") 0586 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, QAction>::type *pasteText(const Receiver *recvr, Func slot, QObject *parent) 0587 { 0588 return create(PasteText, recvr, slot, parent); 0589 } 0590 #endif // K_DOXYGEN 0591 #endif // KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE 0592 0593 /** 0594 * Clear the content of the focus widget 0595 */ 0596 KCONFIGWIDGETS_EXPORT QAction *clear(const QObject *recvr, const char *slot, QObject *parent); 0597 0598 /** 0599 * Clear the content of the focus widget 0600 * @since 5.23 0601 */ 0602 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(clear, Clear) 0603 0604 /** 0605 * Select all elements in the current document. 0606 */ 0607 KCONFIGWIDGETS_EXPORT QAction *selectAll(const QObject *recvr, const char *slot, QObject *parent); 0608 0609 /** 0610 * Select all elements in the current document. 0611 * @since 5.23 0612 */ 0613 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(selectAll, SelectAll) 0614 0615 /** 0616 * Deselect any selected elements in the current document. 0617 */ 0618 KCONFIGWIDGETS_EXPORT QAction *deselect(const QObject *recvr, const char *slot, QObject *parent); 0619 0620 /** 0621 * Deselect any selected elements in the current document. 0622 * @since 5.23 0623 */ 0624 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(deselect, Deselect) 0625 0626 /** 0627 * Initiate a 'find' request in the current document. 0628 */ 0629 KCONFIGWIDGETS_EXPORT QAction *find(const QObject *recvr, const char *slot, QObject *parent); 0630 0631 /** 0632 * Initiate a 'find' request in the current document. 0633 * @since 5.23 0634 */ 0635 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(find, Find) 0636 0637 /** 0638 * Find the next instance of a stored 'find'. 0639 */ 0640 KCONFIGWIDGETS_EXPORT QAction *findNext(const QObject *recvr, const char *slot, QObject *parent); 0641 0642 /** 0643 * Find the next instance of a stored 'find'. 0644 * @since 5.23 0645 */ 0646 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(findNext, FindNext) 0647 0648 /** 0649 * Find a previous instance of a stored 'find'. 0650 */ 0651 KCONFIGWIDGETS_EXPORT QAction *findPrev(const QObject *recvr, const char *slot, QObject *parent); 0652 0653 /** 0654 * Find a previous instance of a stored 'find'. 0655 * @since 5.23 0656 */ 0657 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(findPrev, FindPrev) 0658 0659 /** 0660 * Find and replace matches. 0661 */ 0662 KCONFIGWIDGETS_EXPORT QAction *replace(const QObject *recvr, const char *slot, QObject *parent); 0663 0664 /** 0665 * Find and replace matches. 0666 * @since 5.23 0667 */ 0668 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(replace, Replace) 0669 0670 /** 0671 * View the document at its actual size. 0672 */ 0673 KCONFIGWIDGETS_EXPORT QAction *actualSize(const QObject *recvr, const char *slot, QObject *parent); 0674 0675 /** 0676 * View the document at its actual size. 0677 * @since 5.23 0678 */ 0679 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(actualSize, ActualSize) 0680 0681 /** 0682 * Fit the document view to the size of the current window. 0683 */ 0684 KCONFIGWIDGETS_EXPORT QAction *fitToPage(const QObject *recvr, const char *slot, QObject *parent); 0685 0686 /** 0687 * Fit the document view to the size of the current window. 0688 * @since 5.23 0689 */ 0690 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(fitToPage, FitToPage) 0691 0692 /** 0693 * Fit the document view to the width of the current window. 0694 */ 0695 KCONFIGWIDGETS_EXPORT QAction *fitToWidth(const QObject *recvr, const char *slot, QObject *parent); 0696 0697 /** 0698 * Fit the document view to the width of the current window. 0699 * @since 5.23 0700 */ 0701 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(fitToWidth, FitToWidth) 0702 0703 /** 0704 * Fit the document view to the height of the current window. 0705 */ 0706 KCONFIGWIDGETS_EXPORT QAction *fitToHeight(const QObject *recvr, const char *slot, QObject *parent); 0707 0708 /** 0709 * Fit the document view to the height of the current window. 0710 * @since 5.23 0711 */ 0712 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(fitToHeight, FitToHeight) 0713 0714 /** 0715 * Zoom in the current document view. 0716 */ 0717 KCONFIGWIDGETS_EXPORT QAction *zoomIn(const QObject *recvr, const char *slot, QObject *parent); 0718 0719 /** 0720 * Zoom in the current document view. 0721 * @since 5.23 0722 */ 0723 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(zoomIn, ZoomIn) 0724 0725 /** 0726 * Zoom out the current document view. 0727 */ 0728 KCONFIGWIDGETS_EXPORT QAction *zoomOut(const QObject *recvr, const char *slot, QObject *parent); 0729 0730 /** 0731 * Zoom out the current document view. 0732 * @since 5.23 0733 */ 0734 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(zoomOut, ZoomOut) 0735 0736 /** 0737 * Select the current zoom level. 0738 */ 0739 KCONFIGWIDGETS_EXPORT QAction *zoom(const QObject *recvr, const char *slot, QObject *parent); 0740 0741 /** 0742 * Select the current zoom level. 0743 * @since 5.23 0744 */ 0745 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(zoom, Zoom) 0746 0747 /** 0748 * Redisplay or redraw the document. 0749 */ 0750 KCONFIGWIDGETS_EXPORT QAction *redisplay(const QObject *recvr, const char *slot, QObject *parent); 0751 0752 /** 0753 * Redisplay or redraw the document. 0754 * @since 5.23 0755 */ 0756 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(redisplay, Redisplay) 0757 0758 /** 0759 * Move up (web style menu). 0760 */ 0761 KCONFIGWIDGETS_EXPORT QAction *up(const QObject *recvr, const char *slot, QObject *parent); 0762 0763 /** 0764 * Move up (web style menu). 0765 * @since 5.23 0766 */ 0767 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(up, Up) 0768 0769 /** 0770 * Move back (web style menu). 0771 */ 0772 KCONFIGWIDGETS_EXPORT QAction *back(const QObject *recvr, const char *slot, QObject *parent); 0773 0774 /** 0775 * Move back (web style menu). 0776 * @since 5.23 0777 */ 0778 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(back, Back) 0779 0780 /** 0781 * Move forward (web style menu). 0782 */ 0783 KCONFIGWIDGETS_EXPORT QAction *forward(const QObject *recvr, const char *slot, QObject *parent); 0784 0785 /** 0786 * Move forward (web style menu). 0787 * @since 5.23 0788 */ 0789 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(forward, Forward) 0790 0791 /** 0792 * Go to the "Home" position or document. 0793 */ 0794 KCONFIGWIDGETS_EXPORT QAction *home(const QObject *recvr, const char *slot, QObject *parent); 0795 0796 /** 0797 * Go to the "Home" position or document. 0798 * @since 5.23 0799 */ 0800 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(home, Home) 0801 0802 /** 0803 * Scroll up one page. 0804 */ 0805 KCONFIGWIDGETS_EXPORT QAction *prior(const QObject *recvr, const char *slot, QObject *parent); 0806 0807 /** 0808 * Scroll up one page. 0809 * @since 5.23 0810 */ 0811 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(prior, Prior) 0812 0813 /** 0814 * Scroll down one page. 0815 */ 0816 KCONFIGWIDGETS_EXPORT QAction *next(const QObject *recvr, const char *slot, QObject *parent); 0817 0818 /** 0819 * Scroll down one page. 0820 * @since 5.23 0821 */ 0822 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(next, Next) 0823 0824 /** 0825 * Jump to some specific location in the document. 0826 */ 0827 KCONFIGWIDGETS_EXPORT QAction *goTo(const QObject *recvr, const char *slot, QObject *parent); 0828 0829 /** 0830 * Jump to some specific location in the document. 0831 * @since 5.23 0832 */ 0833 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(goTo, Goto) 0834 0835 /** 0836 * Go to a specific page. 0837 */ 0838 KCONFIGWIDGETS_EXPORT QAction *gotoPage(const QObject *recvr, const char *slot, QObject *parent); 0839 0840 /** 0841 * Go to a specific page. 0842 * @since 5.23 0843 */ 0844 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(gotoPage, GotoPage) 0845 0846 /** 0847 * Go to a specific line. 0848 */ 0849 KCONFIGWIDGETS_EXPORT QAction *gotoLine(const QObject *recvr, const char *slot, QObject *parent); 0850 0851 /** 0852 * Go to a specific line. 0853 * @since 5.23 0854 */ 0855 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(gotoLine, GotoLine) 0856 0857 /** 0858 * Jump to the first page. 0859 */ 0860 KCONFIGWIDGETS_EXPORT QAction *firstPage(const QObject *recvr, const char *slot, QObject *parent); 0861 0862 /** 0863 * Jump to the first page. 0864 * @since 5.23 0865 */ 0866 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(firstPage, FirstPage) 0867 0868 /** 0869 * Jump to the last page. 0870 */ 0871 KCONFIGWIDGETS_EXPORT QAction *lastPage(const QObject *recvr, const char *slot, QObject *parent); 0872 0873 /** 0874 * Jump to the last page. 0875 * @since 5.23 0876 */ 0877 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(lastPage, LastPage) 0878 0879 /** 0880 * Move back (document style menu). 0881 */ 0882 KCONFIGWIDGETS_EXPORT QAction *documentBack(const QObject *recvr, const char *slot, QObject *parent); 0883 0884 /** 0885 * Move back (document style menu). 0886 * @since 5.23 0887 */ 0888 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(documentBack, DocumentBack) 0889 0890 /** 0891 * Move forward (document style menu). 0892 */ 0893 KCONFIGWIDGETS_EXPORT QAction *documentForward(const QObject *recvr, const char *slot, QObject *parent); 0894 0895 /** 0896 * Move forward (document style menu). 0897 * @since 5.23 0898 */ 0899 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(documentForward, DocumentForward) 0900 0901 /** 0902 * Add the current page to the bookmarks tree. 0903 */ 0904 KCONFIGWIDGETS_EXPORT QAction *addBookmark(const QObject *recvr, const char *slot, QObject *parent); 0905 0906 /** 0907 * Add the current page to the bookmarks tree. 0908 * @since 5.23 0909 */ 0910 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(addBookmark, AddBookmark) 0911 0912 /** 0913 * Edit the application bookmarks. 0914 */ 0915 KCONFIGWIDGETS_EXPORT QAction *editBookmarks(const QObject *recvr, const char *slot, QObject *parent); 0916 0917 /** 0918 * Edit the application bookmarks. 0919 * @since 5.23 0920 */ 0921 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(editBookmarks, EditBookmarks) 0922 0923 /** 0924 * Pop up the spell checker. 0925 */ 0926 KCONFIGWIDGETS_EXPORT QAction *spelling(const QObject *recvr, const char *slot, QObject *parent); 0927 0928 /** 0929 * Pop up the spell checker. 0930 * @since 5.23 0931 */ 0932 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(spelling, Spelling) 0933 0934 /** 0935 * Show/Hide the menubar. 0936 */ 0937 KCONFIGWIDGETS_EXPORT KToggleAction *showMenubar(const QObject *recvr, const char *slot, QObject *parent); 0938 0939 /** 0940 * The same as showMenubar(const QObject *, const char *, QObject *), but using new-style connect syntax 0941 * @see showMenubar(const QObject *, const char *, QObject *) 0942 * @since 5.23 0943 */ 0944 #ifdef K_DOXYGEN 0945 inline KToggleAction *showMenubar(const QObject *recvr, Func slot, QObject *parent) 0946 #else 0947 template<class Receiver, class Func> 0948 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, KToggleAction>::type * 0949 showMenubar(const Receiver *recvr, Func slot, QObject *parent) 0950 #endif 0951 { 0952 QAction *ret = create(ShowMenubar, recvr, slot, parent); 0953 Q_ASSERT(qobject_cast<KToggleAction *>(ret)); 0954 return static_cast<KToggleAction *>(ret); 0955 } 0956 0957 /** 0958 * Show/Hide the statusbar. 0959 */ 0960 KCONFIGWIDGETS_EXPORT KToggleAction *showStatusbar(const QObject *recvr, const char *slot, QObject *parent); 0961 0962 /** 0963 * Show/Hide the statusbar. 0964 * @since 5.23 0965 */ 0966 #ifdef K_DOXYGEN 0967 inline KToggleAction *showStatusbar(const QObject *recvr, Func slot, QObject *parent) 0968 #else 0969 template<class Receiver, class Func> 0970 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, KToggleAction>::type * 0971 showStatusbar(const Receiver *recvr, Func slot, QObject *parent) 0972 #endif 0973 { 0974 QAction *ret = create(ShowStatusbar, recvr, slot, parent); 0975 Q_ASSERT(qobject_cast<KToggleAction *>(ret)); 0976 return static_cast<KToggleAction *>(ret); 0977 } 0978 0979 /** 0980 * Switch to/from full screen mode 0981 */ 0982 KCONFIGWIDGETS_EXPORT KToggleFullScreenAction *fullScreen(const QObject *recvr, const char *slot, QWidget *window, QObject *parent); 0983 0984 /** 0985 * Switch to/from full screen mode 0986 * @since 5.23 0987 */ 0988 #ifdef K_DOXYGEN 0989 inline KToggleFullScreenAction *fullScreen(const QObject *recvr, Func slot, QWidget *window, QObject *parent) 0990 #else 0991 template<class Receiver, class Func> 0992 inline typename std::enable_if<!std::is_convertible<Func, const char *>::value, KToggleFullScreenAction>::type * 0993 fullScreen(const Receiver *recvr, Func slot, QWidget *window, QObject *parent) 0994 #endif 0995 { 0996 QAction *a = create(FullScreen, recvr, slot, parent); 0997 Q_ASSERT(qobject_cast<KToggleFullScreenAction *>(a)); 0998 KToggleFullScreenAction *ret = static_cast<KToggleFullScreenAction *>(a); 0999 ret->setWindow(window); 1000 return ret; 1001 } 1002 1003 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 38) 1004 /** 1005 * Display the save options dialog. 1006 * @deprecated since 5.38 1007 */ 1008 KCONFIGWIDGETS_EXPORT 1009 KCONFIGWIDGETS_DEPRECATED_VERSION(5, 38, "No usage known, candidate for removal on next ABI break") 1010 QAction *saveOptions(const QObject *recvr, const char *slot, QObject *parent); 1011 #endif 1012 1013 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 38) 1014 /** 1015 * Display the save options dialog. 1016 * @since 5.23 1017 * @deprecated since 5.38 1018 */ 1019 #ifdef K_DOXYGEN 1020 inline QAction *saveOptions(const QObject *recvr, Func slot, QObject *parent); 1021 #else 1022 template<class Receiver, class Func> 1023 KCONFIGWIDGETS_EXPORT KCONFIGWIDGETS_DEPRECATED_VERSION(5, 38, "No usage known, candidate for removal on next ABI break") inline 1024 typename std::enable_if<!std::is_convertible<Func, const char *>::value, QAction>::type *saveOptions(const Receiver *recvr, Func slot, QObject *parent) 1025 { 1026 return create(SaveOptions, recvr, slot, parent); 1027 } 1028 #endif // K_DOXYGEN 1029 #endif // KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE 1030 1031 /** 1032 * Display the configure keyboard shortcuts dialog. 1033 * 1034 * Note that you might be able to use the pre-built KXMLGUIFactory's function: 1035 * @code 1036 * // For versions older than 5.84: 1037 * KStandardAction::keyBindings(guiFactory(), SLOT(configureShortcuts()), actionCollection()); 1038 * // Starting from 5.84 you can use this (the KXMLGUIFactory::configureShortcuts() method is 1039 * // deprecated in 5.84): 1040 * KStandardAction::keyBindings(guiFactory(), &KXMLGUIFactory::showConfigureShortcutsDialog, actionCollection()); 1041 * @endcode 1042 * 1043 */ 1044 KCONFIGWIDGETS_EXPORT QAction *keyBindings(const QObject *recvr, const char *slot, QObject *parent); 1045 1046 /** 1047 * Display the configure key bindings dialog. 1048 * @see keyBindings(const QObject *recvr, const char *slot, QObject *parent) 1049 * @since 5.23 1050 */ 1051 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(keyBindings, KeyBindings) 1052 1053 /** 1054 * Display the preferences/options dialog. 1055 */ 1056 KCONFIGWIDGETS_EXPORT QAction *preferences(const QObject *recvr, const char *slot, QObject *parent); 1057 1058 /** 1059 * Display the preferences/options dialog. 1060 * @since 5.23 1061 */ 1062 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(preferences, Preferences) 1063 1064 /** 1065 * Display the toolbar configuration dialog. 1066 */ 1067 KCONFIGWIDGETS_EXPORT QAction *configureToolbars(const QObject *recvr, const char *slot, QObject *parent); 1068 1069 /** 1070 * Display the toolbar configuration dialog. 1071 * @since 5.23 1072 */ 1073 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(configureToolbars, ConfigureToolbars) 1074 1075 /** 1076 * Display the notifications configuration dialog. 1077 */ 1078 KCONFIGWIDGETS_EXPORT QAction *configureNotifications(const QObject *recvr, const char *slot, QObject *parent); 1079 1080 /** 1081 * Display the notifications configuration dialog. 1082 * @since 5.23 1083 */ 1084 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(configureNotifications, ConfigureNotifications) 1085 1086 /** 1087 * Display the Switch Application Language dialog. 1088 * @since 5.67 1089 */ 1090 KCONFIGWIDGETS_EXPORT QAction *switchApplicationLanguage(const QObject *recvr, const char *slot, QObject *parent); 1091 1092 /** 1093 * Display the Switch Application Language dialog. 1094 * @since 5.67 1095 */ 1096 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(switchApplicationLanguage, SwitchApplicationLanguage) 1097 1098 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 23) 1099 /** 1100 * @deprecated since 5.38 Use helpContents() instead. 1101 */ 1102 KCONFIGWIDGETS_EXPORT 1103 KCONFIGWIDGETS_DEPRECATED_VERSION(5, 23, "Use KStandardAction::helpContents(const QObject *, const char *, QObject *)") 1104 QAction *help(const QObject *recvr, const char *slot, QObject *parent); 1105 #endif 1106 1107 #if KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE(5, 38) 1108 /** 1109 * @since 5.23 1110 * @deprecated since 5.38 Use helpContents() instead. 1111 */ 1112 #ifdef K_DOXYGEN 1113 inline QAction *help(const QObject *recvr, Func slot, QObject *parent); 1114 #else 1115 template<class Receiver, class Func> 1116 KCONFIGWIDGETS_EXPORT KCONFIGWIDGETS_DEPRECATED_VERSION(5, 38, "Use KStandardAction::helpContents(const QObject *, Func, QObject *)") inline 1117 typename std::enable_if<!std::is_convertible<Func, const char *>::value, QAction>::type *help(const Receiver *recvr, Func slot, QObject *parent) 1118 { 1119 return create(Help, recvr, slot, parent); 1120 } 1121 #endif // K_DOXYGEN 1122 #endif // KCONFIGWIDGETS_ENABLE_DEPRECATED_SINCE 1123 1124 /** 1125 * Display the handbook of the application. 1126 */ 1127 KCONFIGWIDGETS_EXPORT QAction *helpContents(const QObject *recvr, const char *slot, QObject *parent); 1128 1129 /** 1130 * Display the handbook of the application. 1131 * @since 5.23 1132 */ 1133 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(helpContents, HelpContents) 1134 1135 /** 1136 * Trigger the What's This cursor. 1137 */ 1138 KCONFIGWIDGETS_EXPORT QAction *whatsThis(const QObject *recvr, const char *slot, QObject *parent); 1139 1140 /** 1141 * Trigger the What's This cursor. 1142 * @since 5.23 1143 */ 1144 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(whatsThis, WhatsThis) 1145 1146 /** 1147 * Display "Tip of the Day" 1148 */ 1149 KCONFIGWIDGETS_EXPORT QAction *tipOfDay(const QObject *recvr, const char *slot, QObject *parent); 1150 1151 /** 1152 * Display "Tip of the Day" 1153 * @since 5.23 1154 */ 1155 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(tipOfDay, TipofDay) 1156 1157 /** 1158 * Open up the Report Bug dialog. 1159 */ 1160 KCONFIGWIDGETS_EXPORT QAction *reportBug(const QObject *recvr, const char *slot, QObject *parent); 1161 1162 /** 1163 * Open up the Report Bug dialog. 1164 * @since 5.23 1165 */ 1166 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(reportBug, ReportBug) 1167 1168 /** 1169 * Display the application's About box. 1170 */ 1171 KCONFIGWIDGETS_EXPORT QAction *aboutApp(const QObject *recvr, const char *slot, QObject *parent); 1172 1173 /** 1174 * Display the application's About box. 1175 * @since 5.23 1176 */ 1177 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(aboutApp, AboutApp) 1178 1179 /** 1180 * Display the About KDE dialog. 1181 */ 1182 KCONFIGWIDGETS_EXPORT QAction *aboutKDE(const QObject *recvr, const char *slot, QObject *parent); 1183 1184 /** 1185 * Display the About KDE dialog. 1186 * @since 5.23 1187 */ 1188 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(aboutKDE, AboutKDE) 1189 1190 /** 1191 * Permanently deletes files or folders. 1192 * @since 5.25 1193 */ 1194 KCONFIGWIDGETS_EXPORT QAction *deleteFile(const QObject *recvr, const char *slot, QObject *parent); 1195 1196 /** 1197 * Permanently deletes files or folders. 1198 * @since 5.25 1199 */ 1200 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(deleteFile, DeleteFile) 1201 1202 /** 1203 * Renames files or folders. 1204 * @since 5.25 1205 */ 1206 KCONFIGWIDGETS_EXPORT QAction *renameFile(const QObject *recvr, const char *slot, QObject *parent); 1207 1208 /** 1209 * Renames files or folders. 1210 * @since 5.25 1211 */ 1212 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(renameFile, RenameFile) 1213 1214 /** 1215 * Moves files or folders to the trash. 1216 * @since 5.25 1217 */ 1218 KCONFIGWIDGETS_EXPORT QAction *moveToTrash(const QObject *recvr, const char *slot, QObject *parent); 1219 1220 /** 1221 * Moves files or folders to the trash. 1222 * @since 5.25 1223 */ 1224 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(moveToTrash, MoveToTrash) 1225 1226 /** 1227 * Open donation page on kde.org. 1228 * @since 5.26 1229 */ 1230 KCONFIGWIDGETS_EXPORT QAction *donate(const QObject *recvr, const char *slot, QObject *parent); 1231 1232 /** 1233 * Open donation page on kde.org. 1234 * @since 5.26 1235 */ 1236 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(donate, Donate) 1237 1238 /** 1239 * Opens a menu that substitutes the menubar. 1240 * @since 5.81 1241 */ 1242 KCONFIGWIDGETS_EXPORT KHamburgerMenu *hamburgerMenu(const QObject *recvr, const char *slot, QObject *parent); 1243 1244 /** 1245 * Opens a menu that substitutes the menubar. 1246 * @since 5.81 1247 */ 1248 KSTANDARDACTION_WITH_NEW_STYLE_CONNECT(hamburgerMenu, HamburgerMenu) 1249 1250 } 1251 1252 #endif // KSTDACTION_H