home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / SLAX 6.0.8 / slax-6.0.8.iso / slax / base / 006-devel.lzm / usr / include / kstdaction.h < prev    next >
Encoding:
C/C++ Source or Header  |  2007-10-08  |  18.5 KB  |  615 lines

  1. /* This file is part of the KDE libraries
  2.    Copyright (C) 1999,2000 Kurt Granroth <granroth@kde.org>
  3.    Copyright (C) 2001,2002 Ellis Whitehead <ellis@kde.org>
  4.  
  5.    This library is free software; you can redistribute it and/or
  6.    modify it under the terms of the GNU Library General Public
  7.    License version 2 as published by the Free Software Foundation.
  8.  
  9.    This library is distributed in the hope that it will be useful,
  10.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12.    Library General Public License for more details.
  13.  
  14.    You should have received a copy of the GNU Library General Public License
  15.    along with this library; see the file COPYING.LIB.  If not, write to
  16.    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17.    Boston, MA 02110-1301, USA.
  18. */
  19. #ifndef KSTDACTION_H
  20. #define KSTDACTION_H
  21.  
  22. class QObject;
  23. class QWidget;
  24. class KAction;
  25. class KActionCollection;
  26. class KRecentFilesAction;
  27. class KToggleAction;
  28. class KToggleToolBarAction;
  29. class KToggleFullScreenAction;
  30.  
  31. #include <qstringlist.h>
  32.  
  33. #include <kdelibs_export.h>
  34.  
  35. /**
  36.  * Convenience methods to access all standard KDE actions.
  37.  *
  38.  * These actions should be used instead of hardcoding menubar and
  39.  * toolbar items.  Using these actions helps your application easily
  40.  * conform to the KDE UI Style Guide
  41.  * @see http://developer.kde.org/documentation/standards/kde/style/basics/index.html .
  42.  *
  43.  * All of the documentation for KAction holds for KStdAction
  44.  * also.  When in doubt on how things work, check the KAction
  45.  * documention first.
  46.  *
  47.  * <b>Simple Example:</b>\n
  48.  *
  49.  * In general, using standard actions should be a drop in replacement
  50.  * for regular actions.  For example, if you previously had:
  51.  *
  52.  * \code
  53.  * KAction *newAct = new KAction(i18n("&New"), QIconSet(BarIcon("filenew")),
  54.  *                               KStdAccel::shortcut(KStdAccel::New), this,
  55.  *                               SLOT(fileNew()), actionCollection());
  56.  * \endcode
  57.  *
  58.  * You could drop that and replace it with:
  59.  *
  60.  * \code
  61.  * KAction *newAct = KStdAction::openNew(this, SLOT(fileNew()),
  62.  *                                       actionCollection());
  63.  * \endcode
  64.  *
  65.  * <b>Non-standard Usages</b>\n
  66.  *
  67.  * It is possible to use the standard actions in various
  68.  * non-recommended ways.  Say, for instance, you wanted to have a
  69.  * standard action (with the associated correct text and icon and
  70.  * accelerator, etc) but you didn't want it to go in the standard
  71.  * place (this is not recommended, by the way).  One way to do this is
  72.  * to simply not use the XML UI framework and plug it into wherever
  73.  * you want.  If you do want to use the XML UI framework (good!), then
  74.  * it is still possible.
  75.  *
  76.  * Basically, the XML building code matches names in the XML code with
  77.  * the internal names of the actions.  You can find out the internal
  78.  * names of each of the standard actions by using the stdName
  79.  * action like so: KStdAction::stdName(KStdAction::Cut) would return
  80.  * 'edit_cut'.  The XML building code will match 'edit_cut' to the
  81.  * attribute in the global XML file and place your action there.
  82.  *
  83.  * However, you can change the internal name.  In this example, just
  84.  * do something like:
  85.  *
  86.  * \code
  87.  * (void)KStdAction::cut(this, SLOT(editCut()), actionCollection(), "my_cut");
  88.  * \endcode
  89.  *
  90.  * Now, in your local XML resource file (e.g., yourappui.rc), simply
  91.  * put 'my_cut' where you want it to go.
  92.  *
  93.  * Another non-standard usage concerns getting a pointer to an
  94.  * existing action if, say, you want to enable or disable the action.
  95.  * You could do it the recommended way and just grab a pointer when
  96.  * you instantiate it as in the the 'openNew' example above... or you
  97.  * could do it the hard way:
  98.  *
  99.  * \code
  100.  * KAction *cut = actionCollection()->action(KStdAction::stdName(KStdAction::Cut));
  101.  * \endcode
  102.  *
  103.  * Another non-standard usage concerns instantiating the action in the
  104.  * first place.  Usually, you would use the member functions as
  105.  * shown above (e.g., KStdAction::cut(this, SLOT, parent)).  You
  106.  * may, however, do this using the enums provided.  This author can't
  107.  * think of a reason why you would want to, but, hey, if you do,
  108.  * here's how:
  109.  *
  110.  * \code
  111.  * (void)KStdAction::action(KStdAction::New, this, SLOT(fileNew()), actionCollection());
  112.  * (void)KStdAction::action(KStdAction::Cut, this, SLOT(editCut()), actionCollection());
  113.  * \endcode
  114.  *
  115.  * @author Kurt Granroth <granroth@kde.org>
  116.  */
  117. namespace KStdAction
  118. {
  119.     /**
  120.      * The standard menubar and toolbar actions.
  121.      */
  122.     enum StdAction {
  123.         ActionNone,
  124.  
  125.         // File Menu
  126.         New, Open, OpenRecent, Save, SaveAs, Revert, Close,
  127.         Print, PrintPreview, Mail, Quit,
  128.  
  129.         // Edit Menu
  130.         Undo, Redo, Cut, Copy, Paste, SelectAll, Deselect, Find, FindNext, FindPrev,
  131.         Replace,
  132.  
  133.         // View Menu
  134.         ActualSize, FitToPage, FitToWidth, FitToHeight, ZoomIn, ZoomOut,
  135.         Zoom, Redisplay,
  136.  
  137.         // Go Menu
  138.         Up, Back, Forward, Home, Prior, Next, Goto, GotoPage, GotoLine,
  139.         FirstPage, LastPage,
  140.  
  141.         // Bookmarks Menu
  142.         AddBookmark, EditBookmarks,
  143.  
  144.         // Tools Menu
  145.         Spelling,
  146.  
  147.         // Settings Menu
  148.         ShowMenubar, ShowToolbar, ShowStatusbar,
  149.         SaveOptions, KeyBindings,
  150.         Preferences, ConfigureToolbars,
  151.  
  152.         // Help Menu
  153.         Help, HelpContents, WhatsThis, ReportBug, AboutApp, AboutKDE,
  154.         TipofDay, ///< @since 3.1
  155.  
  156.         // Another settings menu item
  157.         ConfigureNotifications,
  158.         FullScreen, ///< @since 3.2
  159.         Clear, ///< @since 3.2
  160.         PasteText, ///< @since 3.2
  161.         SwitchApplicationLanguage ///< @since 3.5.8
  162.     };
  163.  
  164.     /**
  165.      * Creates an action corresponding to the
  166.      * KStdAction::StdAction enum.
  167.      */
  168.     KDEUI_EXPORT KAction* create( StdAction id, const char *name,
  169.         const QObject *recvr, const char *slot,
  170.         KActionCollection* parent );
  171.  
  172.     inline KAction* create( StdAction id,
  173.         const QObject *recvr, const char *slot,
  174.         KActionCollection* parent )
  175.         { return KStdAction::create( id, 0, recvr, slot, parent ); }
  176.  
  177.     /**
  178.     * @obsolete. Creates an action corresponding to the
  179.     * KStdAction::StdAction enum.
  180.     */
  181.     inline KAction *action(StdAction act_enum,
  182.         const QObject *recvr, const char *slot,
  183.         KActionCollection *parent, const char *name = 0L )
  184.         { return KStdAction::create( act_enum, name, recvr, slot, parent ); }
  185.  
  186.     /**
  187.      * This will return the internal name of a given standard action.
  188.      */
  189.     KDEUI_EXPORT const char* name( StdAction id );
  190.  
  191.         /// @obsolete. Use name()
  192.     inline const char* stdName(StdAction act_enum) { return name( act_enum ); }
  193.  
  194.        /**
  195.          * Returns a list of all standard names. Used by KAccelManager
  196.          * to give those heigher weight.
  197.      * @since 3.1
  198.         */
  199.         KDEUI_EXPORT QStringList stdNames();
  200.  
  201.     /**
  202.      * Create a new document or window.
  203.      */
  204.     KDEUI_EXPORT KAction *openNew(const QObject *recvr, const char *slot, KActionCollection* parent, const char *name = 0 );
  205.  
  206.     /**
  207.      * Open an existing file.
  208.      */
  209.     KDEUI_EXPORT KAction *open(const QObject *recvr, const char *slot, KActionCollection* parent, const char *name = 0 );
  210.  
  211.     /**
  212.      * Open a recently used document. The signature of the slot being called
  213.      * is of the form slotURLSelected( const KURL & ).
  214.      * @param recvr object to receive slot
  215.      * @param slot The SLOT to invoke when a URL is selected. The slot's
  216.      * signature is slotURLSelected( const KURL & ).
  217.      * @param parent parent widget
  218.      * @param name name of widget
  219.      */
  220.     KDEUI_EXPORT KRecentFilesAction *openRecent(const QObject *recvr, const char *slot, KActionCollection* parent, const char *name = 0 );
  221.  
  222.     /**
  223.      * Save the current document.
  224.      */
  225.     KDEUI_EXPORT KAction *save(const QObject *recvr, const char *slot,
  226.         KActionCollection* parent, const char *name = 0 );
  227.  
  228.     /**
  229.     * Save the current document under a different name.
  230.     */
  231.     KDEUI_EXPORT KAction *saveAs(const QObject *recvr, const char *slot,
  232.         KActionCollection* parent, const char *name = 0 );
  233.  
  234.     /**
  235.     * Revert the current document to the last saved version
  236.     * (essentially will undo all changes).
  237.     */
  238.     KDEUI_EXPORT KAction *revert(const QObject *recvr, const char *slot,
  239.         KActionCollection* parent, const char *name = 0 );
  240.  
  241.     /**
  242.     * Close the current document.
  243.     */
  244.     KDEUI_EXPORT KAction *close(const QObject *recvr, const char *slot,
  245.         KActionCollection* parent, const char *name = 0 );
  246.  
  247.     /**
  248.     * Print the current document.
  249.     */
  250.     KDEUI_EXPORT KAction *print(const QObject *recvr, const char *slot,
  251.         KActionCollection* parent, const char *name = 0 );
  252.  
  253.     /**
  254.     * Show a print preview of the current document.
  255.     */
  256.     KDEUI_EXPORT KAction *printPreview(const QObject *recvr, const char *slot,
  257.         KActionCollection* parent, const char *name = 0 );
  258.  
  259.     /**
  260.     * Mail this document.
  261.     */
  262.     KDEUI_EXPORT KAction *mail(const QObject *recvr, const char *slot,
  263.         KActionCollection* parent, const char *name = 0 );
  264.  
  265.     /**
  266.     * Quit the program.
  267.     */
  268.     KDEUI_EXPORT KAction *quit(const QObject *recvr, const char *slot,
  269.         KActionCollection* parent, const char *name = 0 );
  270.  
  271.     /**
  272.     * Undo the last operation.
  273.     */
  274.     KDEUI_EXPORT KAction *undo(const QObject *recvr, const char *slot,
  275.         KActionCollection* parent, const char *name = 0 );
  276.  
  277.     /**
  278.     * Redo the last operation.
  279.     */
  280.     KDEUI_EXPORT KAction *redo(const QObject *recvr, const char *slot,
  281.         KActionCollection* parent, const char *name = 0 );
  282.  
  283.     /**
  284.     * Cut selected area and store it in the clipboard.
  285.     */
  286.     KDEUI_EXPORT KAction *cut(const QObject *recvr, const char *slot,
  287.         KActionCollection* parent, const char *name = 0 );
  288.  
  289.     /**
  290.     * Copy the selected area into the clipboard.
  291.     */
  292.     KDEUI_EXPORT KAction *copy(const QObject *recvr, const char *slot,
  293.         KActionCollection* parent, const char *name = 0 );
  294.  
  295.     /**
  296.     * Paste the contents of clipboard at the current mouse or cursor
  297.     * position.
  298.     */
  299.     KDEUI_EXPORT KAction *paste(const QObject *recvr, const char *slot,
  300.         KActionCollection* parent, const char *name = 0 );
  301.  
  302.     /**
  303.     * Paste the contents of clipboard at the current mouse or cursor
  304.     * position. Provide a button on the toolbar with the clipboard history
  305.     * menu if Klipper is running.
  306.     * @since 3.2
  307.     */
  308.     KDEUI_EXPORT KAction *pasteText(const QObject *recvr, const char *slot,
  309.         KActionCollection* parent, const char *name = 0 );
  310.  
  311.     /**
  312.     * Clear the content of the focus widget
  313.     * @since 3.2
  314.     */
  315.     KDEUI_EXPORT KAction *clear(const QObject *recvr, const char *slot,
  316.         KActionCollection* parent, const char *name = 0 );
  317.  
  318.     /**
  319.     * Select all elements in the current document.
  320.     */
  321.     KDEUI_EXPORT KAction *selectAll(const QObject *recvr, const char *slot,
  322.         KActionCollection* parent, const char *name = 0 );
  323.  
  324.     /**
  325.     * Deselect any selected elements in the current document.
  326.     */
  327.     KDEUI_EXPORT KAction *deselect(const QObject *recvr, const char *slot,
  328.         KActionCollection* parent, const char *name = 0 );
  329.  
  330.     /**
  331.     * Initiate a 'find' request in the current document.
  332.     */
  333.     KDEUI_EXPORT KAction *find(const QObject *recvr, const char *slot,
  334.         KActionCollection* parent, const char *name = 0 );
  335.  
  336.     /**
  337.     * Find the next instance of a stored 'find'.
  338.     */
  339.     KDEUI_EXPORT KAction *findNext(const QObject *recvr, const char *slot,
  340.         KActionCollection* parent, const char *name = 0 );
  341.  
  342.     /**
  343.     * Find a previous instance of a stored 'find'.
  344.     */
  345.     KDEUI_EXPORT KAction *findPrev(const QObject *recvr, const char *slot,
  346.         KActionCollection* parent, const char *name = 0 );
  347.  
  348.     /**
  349.     * Find and replace matches.
  350.     */
  351.     KDEUI_EXPORT KAction *replace(const QObject *recvr, const char *slot,
  352.         KActionCollection* parent, const char *name = 0 );
  353.  
  354.     /**
  355.     * View the document at its actual size.
  356.     */
  357.     KDEUI_EXPORT KAction *actualSize(const QObject *recvr, const char *slot,
  358.         KActionCollection* parent, const char *name = 0 );
  359.  
  360.     /**
  361.     * Fit the document view to the size of the current window.
  362.     */
  363.     KDEUI_EXPORT KAction *fitToPage(const QObject *recvr, const char *slot,
  364.         KActionCollection* parent, const char *name = 0 );
  365.  
  366.     /**
  367.     * Fit the document view to the width of the current window.
  368.     */
  369.     KDEUI_EXPORT KAction *fitToWidth(const QObject *recvr, const char *slot,
  370.         KActionCollection* parent, const char *name = 0 );
  371.  
  372.     /**
  373.     * Fit the document view to the height of the current window.
  374.     */
  375.     KDEUI_EXPORT KAction *fitToHeight(const QObject *recvr, const char *slot,
  376.                     KActionCollection* parent, const char *name = 0 );
  377.  
  378.     /**
  379.     * Zoom in.
  380.     */
  381.     KDEUI_EXPORT KAction *zoomIn(const QObject *recvr, const char *slot,
  382.                 KActionCollection* parent, const char *name = 0 );
  383.  
  384.     /**
  385.     * Zoom out.
  386.     */
  387.     KDEUI_EXPORT KAction *zoomOut(const QObject *recvr, const char *slot,
  388.                 KActionCollection* parent, const char *name = 0 );
  389.  
  390.     /**
  391.     * Popup a zoom dialog.
  392.     */
  393.     KDEUI_EXPORT KAction *zoom(const QObject *recvr, const char *slot,
  394.                 KActionCollection* parent, const char *name = 0 );
  395.  
  396.     /**
  397.     * Redisplay or redraw the document.
  398.     */
  399.     KDEUI_EXPORT KAction *redisplay(const QObject *recvr, const char *slot,
  400.                 KActionCollection* parent, const char *name = 0 );
  401.  
  402.     /**
  403.     * Move up (web style menu).
  404.     */
  405.     KDEUI_EXPORT KAction *up(const QObject *recvr, const char *slot,
  406.             KActionCollection* parent, const char *name = 0 );
  407.  
  408.     /**
  409.     * Move back (web style menu).
  410.     */
  411.     KDEUI_EXPORT KAction *back(const QObject *recvr, const char *slot,
  412.                 KActionCollection* parent, const char *name = 0 );
  413.  
  414.     /**
  415.     * Move forward (web style menu).
  416.     */
  417.     KDEUI_EXPORT KAction *forward(const QObject *recvr, const char *slot,
  418.                 KActionCollection* parent, const char *name = 0 );
  419.  
  420.     /**
  421.     * Go to the "Home" position or document.
  422.     */
  423.     KDEUI_EXPORT KAction *home(const QObject *recvr, const char *slot,
  424.                 KActionCollection* parent, const char *name = 0 );
  425.  
  426.     /**
  427.     * Scroll up one page.
  428.     */
  429.     KDEUI_EXPORT KAction *prior(const QObject *recvr, const char *slot,
  430.                 KActionCollection* parent, const char *name = 0 );
  431.  
  432.     /**
  433.     * Scroll down one page.
  434.     */
  435.     KDEUI_EXPORT KAction *next(const QObject *recvr, const char *slot,
  436.                 KActionCollection* parent, const char *name = 0 );
  437.  
  438.     /**
  439.     * Go to somewhere in general.
  440.     */
  441.     KDEUI_EXPORT KAction *goTo(const QObject *recvr, const char *slot,
  442.                 KActionCollection* parent, const char *name = 0 );
  443.  
  444.  
  445.     /**
  446.     * Go to a specific page (dialog).
  447.     */
  448.     KDEUI_EXPORT KAction *gotoPage(const QObject *recvr, const char *slot,
  449.                 KActionCollection* parent, const char *name = 0 );
  450.  
  451.     /**
  452.     * Go to a specific line (dialog).
  453.     */
  454.     KDEUI_EXPORT KAction *gotoLine(const QObject *recvr, const char *slot,
  455.                 KActionCollection* parent, const char *name = 0 );
  456.  
  457.     /**
  458.     * Jump to the first page.
  459.     */
  460.     KDEUI_EXPORT KAction *firstPage(const QObject *recvr, const char *slot,
  461.                 KActionCollection* parent, const char *name = 0 );
  462.  
  463.     /**
  464.     * Jump to the last page.
  465.     */
  466.     KDEUI_EXPORT KAction *lastPage(const QObject *recvr, const char *slot,
  467.                 KActionCollection* parent, const char *name = 0 );
  468.  
  469.     /**
  470.     * Add the current page to the bookmarks tree.
  471.     */
  472.     KDEUI_EXPORT KAction *addBookmark(const QObject *recvr, const char *slot,
  473.                     KActionCollection* parent, const char *name = 0 );
  474.  
  475.     /**
  476.     * Edit the application bookmarks.
  477.     */
  478.     KDEUI_EXPORT KAction *editBookmarks(const QObject *recvr, const char *slot,
  479.                     KActionCollection* parent, const char *name = 0 );
  480.  
  481.     /**
  482.     * Pop up the spell checker.
  483.     */
  484.     KDEUI_EXPORT KAction *spelling(const QObject *recvr, const char *slot,
  485.                     KActionCollection* parent, const char *name = 0 );
  486.  
  487.  
  488.     /**
  489.     * Show/Hide the menubar.
  490.     */
  491.     KDEUI_EXPORT KToggleAction *showMenubar(const QObject *recvr, const char *slot,
  492.                     KActionCollection* parent, const char *name = 0 );
  493.  
  494.     /**
  495.     * @obsolete. toolbar actions are created automatically now in the
  496.     * Settings menu. Don't use this anymore.
  497.     * See: KMainWindow::createStandardStatusBarAction()
  498.     * Show/Hide the primary toolbar.
  499.     * @since 3.1
  500.     */
  501.     KDEUI_EXPORT KToggleAction *showToolbar(const QObject *recvr, const char *slot,
  502.                     KActionCollection* parent, const char *name = 0 ) KDE_DEPRECATED;
  503.     /**
  504.     * @obsolete. toolbar actions are created automatically now in the
  505.     * Settings menu. Don't use this anymore.
  506.     * See: KMainWindow::setStandardToolBarMenuEnabled(bool);
  507.     * Show/Hide the primary toolbar.
  508.     */
  509.     KDEUI_EXPORT KToggleToolBarAction *showToolbar(const char* toolBarName,
  510.                     KActionCollection* parent, const char *name = 0 ) KDE_DEPRECATED;
  511.  
  512.     /**
  513.     * Show/Hide the statusbar.
  514.     */
  515.     KDEUI_EXPORT KToggleAction *showStatusbar(const QObject *recvr, const char *slot,
  516.                     KActionCollection* parent, const char *name = 0 );
  517.  
  518.     /**
  519.     * Switch to/from full screen mode
  520.     * @since 3.2
  521.     */
  522.     KDEUI_EXPORT KToggleFullScreenAction *fullScreen(const QObject *recvr, const char *slot,
  523.                     KActionCollection* parent, QWidget* window, const char *name = 0 );
  524.  
  525.     /**
  526.     * Display the save options dialog.
  527.     */
  528.     KDEUI_EXPORT KAction *saveOptions(const QObject *recvr, const char *slot,
  529.                     KActionCollection* parent, const char *name = 0 );
  530.  
  531.     /**
  532.     * Display the configure key bindings dialog.
  533.     *
  534.     *  Note that you might be able to use the pre-built KXMLGUIFactory's fuction:
  535.     *  KStdAction::keyBindings(guiFactory(), SLOT(configureShortcuts()), actionCollection());
  536.         */
  537.     KDEUI_EXPORT KAction *keyBindings(const QObject *recvr, const char *slot,
  538.                     KActionCollection* parent, const char *name = 0 );
  539.  
  540.     /**
  541.     * Display the preferences/options dialog.
  542.     */
  543.     KDEUI_EXPORT KAction *preferences(const QObject *recvr, const char *slot,
  544.                     KActionCollection* parent, const char *name = 0 );
  545.  
  546.     /**
  547.     * The Customize Toolbar dialog.
  548.     */
  549.     KDEUI_EXPORT KAction *configureToolbars(const QObject *recvr,
  550.                     const char *slot,
  551.                     KActionCollection* parent,
  552.                     const char *name = 0 );
  553.  
  554.     /**
  555.     * The Configure Notifications dialog.
  556.     * @since 3.1
  557.     */
  558.     KDEUI_EXPORT KAction *configureNotifications(const QObject *recvr,
  559.                     const char *slot,
  560.                     KActionCollection *parent,
  561.                     const char *name = 0);
  562.  
  563.     /**
  564.     * Display the help.
  565.     */
  566.     KDEUI_EXPORT KAction *help(const QObject *recvr, const char *slot,
  567.                 KActionCollection* parent, const char *name = 0 );
  568.  
  569.     /**
  570.     * Display the help contents.
  571.     */
  572.     KDEUI_EXPORT KAction *helpContents(const QObject *recvr, const char *slot,
  573.                     KActionCollection* parent, const char *name = 0 );
  574.  
  575.     /**
  576.     * Trigger the What's This cursor.
  577.     */
  578.     KDEUI_EXPORT KAction *whatsThis(const QObject *recvr, const char *slot,
  579.                 KActionCollection* parent, const char *name = 0 );
  580.  
  581.     /**
  582.     * Display "Tip of the Day"
  583.     * @since 3.1
  584.     */
  585.     KDEUI_EXPORT KAction *tipOfDay(const QObject *recvr, const char *slot,
  586.                 KActionCollection* parent, const char *name = 0 );
  587.  
  588.     /**
  589.     * Open up the Report Bug dialog.
  590.     */
  591.     KDEUI_EXPORT KAction *reportBug(const QObject *recvr, const char *slot,
  592.                 KActionCollection* parent, const char *name = 0 );
  593.  
  594.     /**
  595.     * Display the application's About box.
  596.     */
  597.     KDEUI_EXPORT KAction *aboutApp(const QObject *recvr, const char *slot,
  598.                 KActionCollection* parent, const char *name = 0 );
  599.  
  600.     /**
  601.     * Display the About KDE dialog.
  602.     */
  603.     KDEUI_EXPORT KAction *aboutKDE(const QObject *recvr, const char *slot,
  604.                 KActionCollection* parent, const char *name = 0 );
  605.  
  606.     /**
  607.     * Display "Switch application language" dialog.
  608.     * @since 3.5.8
  609.     */
  610.     KDEUI_EXPORT KAction *switchApplicationLanguage(const QObject *recvr, const char *slot,
  611.                 KActionCollection* parent, const char *name = 0 );
  612. }
  613.  
  614. #endif // KSTDACTION_H
  615.