org.kde.koala

Class KApplication

public class KApplication extends QApplication implements KInstanceInterface

Controls and provides information to all KDE applications. Only one object of this class can be instantiated in a single app. This instance is always accessible via the 'kapp' global variable. See cut() for an example. This class provides the following services to all KDE applications.
  • It controls the event queue (see QApplication ).
  • It provides the application with KDE resources such as accelerators, common menu entries, a KConfig object. session management events, help invocation etc.
  • Installs a signal handler for the SIGCHLD signal in order to avoid zombie children. If you want to catch this signal yourself or don't want it to be caught at all, you have set a new signal handler (or SIG_IGN) after KApplication's constructor has run.
  • Installs an empty signal handler for the SIGPIPE signal using installSigpipeHandler(). If you want to catch this signal yourself, you have set a new signal handler after KApplication's constructor has run.
  • It can start new services
  • The way a service gets started depends on the 'X-DCOP-ServiceType' entry in the desktop file of the service: There are three possibilities:
  • X-DCOP-ServiceType=None (default) Always start a new service, don't wait till the service registers with dcop.
  • X-DCOP-ServiceType=Multi Always start a new service, wait until the service has registered with dcop.
  • X-DCOP-ServiceType=Unique Only start the service if it isn't already running, wait until the service has registered with dcop.
  • See KApplicationSignals for signals emitted by KApplication

    Author: Matthias Kalle Dalheimer

    UNKNOWN: Controls and provides information to all KDE applications.

    Field Summary
    static intButton1Pressed
    static intButton2Pressed
    static intButton3Pressed
    static intButton4Pressed
    static intButton5Pressed
    static intCaptionAppFirst
    static intCaptionAppLast
    Position of the caption (presumably in the application window's title bar).
    static intCaptionNoApp
    static intControlModifier
    static intLockModifier
    static intModifier1
    static intModifier2
    static intModifier3
    static intModifier4
    static intModifier5
    static intSETTINGS_COMPLETION
    static intSETTINGS_MOUSE
    Valid values for the settingsChanged signal
    static intSETTINGS_PATHS
    static intSETTINGS_POPUPMENU
    static intSETTINGS_QT
    static intSETTINGS_SHORTCUTS
    static intShiftModifier
    static intShutdownConfirmDefault
    The possible values for the confirm parameter of requestShutDown().
    static intShutdownConfirmNo
    static intShutdownConfirmYes
    static intShutdownModeDefault
    The possible values for the sdmode parameter of requestShutDown().
    static intShutdownModeForceNow
    static intShutdownModeInteractive
    static intShutdownModeSchedule
    static intShutdownModeTryNow
    static intShutdownTypeDefault
    The possible values for the sdtype parameter of requestShutDown().
    static intShutdownTypeHalt
    static intShutdownTypeNone
    static intShutdownTypeReboot
    Constructor Summary
    protected KApplication(Class dummy)
    KApplication(boolean allowStyles, boolean GUIenabled)
    This constructor takes aboutData and command line arguments from KCmdLineArgs.
    KApplication(boolean allowStyles)
    KApplication()
    KApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance)
    Method Summary
    KAboutDataaboutData()
    Returns the about data of this instance Warning, can be null
    static voidaddCmdLineOptions()
    Add Qt and KDE command line options to KCmdLineArgs.
    voidaddKipcEventMask(int id)
    Adds a message type to the KIPC event mask.
    voidallowURLAction(String action, KURL _baseURL, KURL _destURL)
    Allow a certain URL action.
    booleanauthorize(String genericAction)
    Returns whether a certain action is authorized
    booleanauthorizeControlModule(String menuId)
    Returns whether access to a certain control module is authorized.
    ArrayListauthorizeControlModules(String[] menuIds)
    Returns whether access to a certain control modules is authorized.
    booleanauthorizeKAction(String action)
    Returns whether a certain KAction is authorized.
    booleanauthorizeURLAction(String action, KURL baseURL, KURL destURL)
    Returns whether a certain URL related action is authorized.
    Stringcaption()
    Returns a text for the window caption.
    StringcheckRecoverFile(String pFilename, boolean bRecover)
    Check whether an auto-save file exists for the document you want to open.
    StringclassName()
    voidclear()
    If the widget with focus provides a clear() slot, call that slot.
    voidcommitData(QSessionManager sm)
    Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.
    KConfigconfig()
    Returns the general config object ("appnamerc").
    voidcopy()
    If the widget with focus provides a copy() slot, call that slot.
    static QPalettecreateApplicationPalette()
    Used to obtain the QPalette that will be used to set the application palette.
    static QPalettecreateApplicationPalette(KConfig config, int contrast)
    Raw access for use by KDM.
    voidcut()
    If the widget with focus provides a cut() slot, call that slot.
    static DCOPClientdcopClient()
    Returns a pointer to a DCOPClient for the application.
    voidderef()
    Tells KApplication that one operation such as those described in ref() just finished.
    KStandardDirsdirs()
    Returns the application standard dirs object.
    static voiddisableAutoDcopRegistration()
    Disable automatic dcop registration Must be called before creating a KApplication instance to have an effect.
    voiddisableSessionManagement()
    Disables session management for this application.
    voiddisableStyles()
    Disables style plugins.
    voiddispose()
    Delete the wrapped C++ instance ahead of finalize()
    voidenableSessionManagement()
    Enables again session management for this application, formerly disabled by calling disableSessionManagement().
    voidenableStyles()
    Enables style plugins.
    protected voidfinalize()
    Deletes the wrapped C++ instance
    StringgeometryArgument()
    Returns the argument to --geometry if any, so the geometry can be set wherever necessary
    static booleanguiEnabled()
    Whether widgets can be used.
    QPixmapicon()
    Returns a QPixmap with the application icon.
    KIconLoadericonLoader()
    Returns an iconloader object.
    StringiconName()
    Returns the name of the application icon.
    voidinstallKDEPropertyMap()
    Install a Qt SQL property map with entries for all KDE widgets Call this in any application using KDE widgets in QSqlForm or QDataView.
    static voidinstallSigpipeHandler()
    Installs a handler for the SIGPIPE signal.
    voidinstallX11EventFilter(QWidget filter)
    Installs widget filter as global X11 event filter.
    StringinstanceName()
    Returns the name of the instance
    voidinvokeBrowser(String url, String startup_id)
    Invokes the standard browser.
    voidinvokeBrowser(String url)
    Invoke the standard browser.
    protected voidinvokeEditSlot(String slot)
    This method is used internally to determine which edit slots are implemented by the widget that has the focus, and to invoke those slots if available.
    voidinvokeHelp(String anchor, String appname, String startup_id)
    Invokes the KHelpCenter HTML help viewer from docbook sources.
    voidinvokeHelp(String anchor, String appname)
    voidinvokeHelp(String anchor)
    voidinvokeHelp()
    voidinvokeMailer(String address, String subject, String startup_id)
    Convenience method; invokes the standard email application.
    voidinvokeMailer(String address, String subject)
    voidinvokeMailer(KURL mailtoURL, String startup_id, boolean allowAttachments)
    Invokes the standard email application.
    voidinvokeMailer(KURL mailtoURL, String startup_id)
    voidinvokeMailer(KURL mailtoURL)
    voidinvokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs, String startup_id)
    Convenience method; invokes the standard email application.
    voidinvokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs)
    voidinvokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile)
    voidinvokeMailer(String to, String cc, String bcc, String subject, String body)
    booleanisDisposed()
    Has the wrapped C++ instance been deleted?
    booleanisRestored()
    Is the application restored from the session manager?
    static KApplicationkApplication()
    Returns the current application object.
    static intkdeinitExec(String name, String[] args, StringBuffer error, int[] pid, String startup_id)
    Starts a program via kdeinit. program name and arguments are converted to according to the local encoding and passed as is to kdeinit.
    static intkdeinitExec(String name, String[] args, StringBuffer error, int[] pid)
    static intkdeinitExec(String name, String[] args, StringBuffer error)
    static intkdeinitExec(String name, String[] args)
    static intkdeinitExec(String name)
    static intkdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid, String startup_id)
    Starts a program via kdeinit and wait for it to finish.
    static intkdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid)
    static intkdeinitExecWait(String name, String[] args, StringBuffer error)
    static intkdeinitExecWait(String name, String[] args)
    static intkdeinitExecWait(String name)
    static intkeyboardMouseState()
    Returns the state of the currently pressed keyboard modifiers (e.g. shift, control, etc.) and mouse buttons, similarly to QKeyEvent.state() and QMouseEvent.state().
    static Stringlauncher()
    Returns the DCOP name of the service launcher.
    StringmakeStdCaption(String userCaption, boolean withAppName, boolean modified)
    Builds a caption that contains the application name along with the userCaption using a standard layout.
    StringmakeStdCaption(String userCaption, boolean withAppName)
    StringmakeStdCaption(String userCaption)
    QMetaObjectmetaObject()
    KMimeSourceFactorymimeSourceFactory()
    Returns the KMimeSourceFactory of the instance.
    QPixmapminiIcon()
    Returns the mini-icon for the application as a QPixmap.
    StringminiIconName()
    Returns the name of the mini-icon for the application.
    voidnewIconLoader()
    Re-allocate the global iconloader.
    booleannotify(QObject receiver, QEvent event)
    voidpaste()
    If the widget with focus provides a paste() slot, call that slot.
    voidpropagateSessionManager()
    Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up.
    static intrandom()
    Generates a uniform random number.
    static StringrandomString(int length)
    Generates a random string.
    voidref()
    Tells KApplication about one more operation that should be finished before the application exits.
    voidremoveKipcEventMask(int id)
    Removes a message type from the KIPC event mask.
    voidremoveX11EventFilter(QWidget filter)
    Removes global X11 event filter previously installed by installX11EventFilter().
    booleanrequestShutDown(int confirm, int sdtype, int sdmode)
    Asks the session manager to shut the session down.
    booleanrequestShutDown(int confirm, int sdtype)
    booleanrequestShutDown(int confirm)
    booleanrequestShutDown()
    voidsaveState(QSessionManager sm)
    Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.
    voidselectAll()
    If the widget with focus provides a selectAll() slot, call that slot.
    KConfigsessionConfig()
    Returns the application session config object.
    booleansessionSaving()
    Returns true if the application is currently saving its session data (most probably before KDE logout).
    protected voidsetConfigName(String name)
    Set name of default config file.
    static voidsetJavaSlotFactory()
    Used internally by the KDE Koala Java bindings runtime
    voidsetStartupId(String startup_id)
    Sets a new value for the application startup notification window property for newly created toplevel windows.
    voidsetTopWidget(QWidget topWidget)
    Sets the top widget of the application.
    KSharedConfigsharedConfig()
    Returns the general config object ("appnamerc").
    static voidstartKdeinit()
    static intstartServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop name of the service.
    static intstartServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByDesktopName(String _name, String URL, StringBuffer error)
    static intstartServiceByDesktopName(String _name, String URL)
    static intstartServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop name of the service.
    static intstartServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByDesktopName(String _name, String[] URLs, StringBuffer error)
    static intstartServiceByDesktopName(String _name, String[] URLs)
    static intstartServiceByDesktopName(String _name)
    static intstartServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop path of the service.
    static intstartServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByDesktopPath(String _name, String URL, StringBuffer error)
    static intstartServiceByDesktopPath(String _name, String URL)
    static intstartServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop path of the service.
    static intstartServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByDesktopPath(String _name, String[] URLs, StringBuffer error)
    static intstartServiceByDesktopPath(String _name, String[] URLs)
    static intstartServiceByDesktopPath(String _name)
    static intstartServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the (translated) name of the service.
    static intstartServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByName(String _name, String URL, StringBuffer error)
    static intstartServiceByName(String _name, String URL)
    static intstartServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the (translated) name of the service.
    static intstartServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)
    static intstartServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)
    static intstartServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)
    static intstartServiceByName(String _name, String[] URLs, StringBuffer error)
    static intstartServiceByName(String _name, String[] URLs)
    static intstartServiceByName(String _name)
    StringstartupId()
    Returns the app startup notification identifier for this running application.
    StringtempSaveName(String pFilename)
    Get a file name in order to make a temporary copy of your document.
    voidupdateRemoteUserTimestamp(String dcopId, long time)
    Updates the last user action timestamp in the application registered to DCOP with dcopId to the given time, or to this application's user time, if 0 is given.
    voidupdateRemoteUserTimestamp(String dcopId)
    voidupdateUserTimestamp(long time)
    Updates the last user action timestamp to the given time, or to the current time, if 0 is given.
    voidupdateUserTimestamp()
    longuserTimestamp()
    Returns the last user action timestamp or 0 if no user activity has taken place yet.

    Field Detail

    Button1Pressed

    public static final int Button1Pressed

    Deprecated: Same values as Button1Mask etc. in X.h @short @deprecated Same values as Button1Mask etc.

    Button2Pressed

    public static final int Button2Pressed

    Button3Pressed

    public static final int Button3Pressed

    Button4Pressed

    public static final int Button4Pressed

    Button5Pressed

    public static final int Button5Pressed

    CaptionAppFirst

    public static final int CaptionAppFirst

    CaptionAppLast

    public static final int CaptionAppLast
    Position of the caption (presumably in the application window's title bar). This enum appears to be unused.

    UNKNOWN: Find out if this is used anywhere. Position of the caption (presumably in the application window's title bar).

    CaptionNoApp

    public static final int CaptionNoApp

    ControlModifier

    public static final int ControlModifier

    LockModifier

    public static final int LockModifier

    Modifier1

    public static final int Modifier1

    Modifier2

    public static final int Modifier2

    Modifier3

    public static final int Modifier3

    Modifier4

    public static final int Modifier4

    Modifier5

    public static final int Modifier5

    SETTINGS_COMPLETION

    public static final int SETTINGS_COMPLETION

    SETTINGS_MOUSE

    public static final int SETTINGS_MOUSE
    Valid values for the settingsChanged signal

    UNKNOWN: Valid values for the settingsChanged signal

    SETTINGS_PATHS

    public static final int SETTINGS_PATHS

    SETTINGS_POPUPMENU

    public static final int SETTINGS_POPUPMENU

    SETTINGS_QT

    public static final int SETTINGS_QT

    SETTINGS_SHORTCUTS

    public static final int SETTINGS_SHORTCUTS

    ShiftModifier

    public static final int ShiftModifier

    ShutdownConfirmDefault

    public static final int ShutdownConfirmDefault
    The possible values for the confirm parameter of requestShutDown().

    UNKNOWN: The possible values for the confirm parameter of requestShutDown().

    ShutdownConfirmNo

    public static final int ShutdownConfirmNo

    ShutdownConfirmYes

    public static final int ShutdownConfirmYes

    ShutdownModeDefault

    public static final int ShutdownModeDefault
    The possible values for the sdmode parameter of requestShutDown().

    UNKNOWN: The possible values for the sdmode parameter of requestShutDown().

    ShutdownModeForceNow

    public static final int ShutdownModeForceNow

    ShutdownModeInteractive

    public static final int ShutdownModeInteractive

    ShutdownModeSchedule

    public static final int ShutdownModeSchedule

    ShutdownModeTryNow

    public static final int ShutdownModeTryNow

    ShutdownTypeDefault

    public static final int ShutdownTypeDefault
    The possible values for the sdtype parameter of requestShutDown().

    UNKNOWN: The possible values for the sdtype parameter of requestShutDown().

    ShutdownTypeHalt

    public static final int ShutdownTypeHalt

    ShutdownTypeNone

    public static final int ShutdownTypeNone

    ShutdownTypeReboot

    public static final int ShutdownTypeReboot

    Constructor Detail

    KApplication

    protected KApplication(Class dummy)

    KApplication

    public KApplication(boolean allowStyles, boolean GUIenabled)
    This constructor takes aboutData and command line arguments from KCmdLineArgs.

    Parameters: allowStyles Set to false to disable the loading on plugin based styles. This is only useful to applications that do not display a GUI normally. If you do create an application with allowStyles set to false it normally runs in the background but under special circumstances displays widgets. Call enableStyles() before displaying any widgets. GUIenabled Set to false to disable all GUI stuff. This implies no styles either.

    UNKNOWN: This constructor takes aboutData and command line arguments from KCmdLineArgs.

    KApplication

    public KApplication(boolean allowStyles)

    KApplication

    public KApplication()

    KApplication

    public KApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance)

    UNKNOWN:

    Method Detail

    aboutData

    public KAboutData aboutData()
    Returns the about data of this instance Warning, can be null

    Returns: the about data of the instance, or 0 if it has not been set yet

    UNKNOWN: Returns the about data of this instance Warning, can be 0L

    addCmdLineOptions

    public static void addCmdLineOptions()
    Add Qt and KDE command line options to KCmdLineArgs.

    UNKNOWN: Add Qt and KDE command line options to KCmdLineArgs.

    addKipcEventMask

    public void addKipcEventMask(int id)
    Adds a message type to the KIPC event mask. You can only add "system messages" to the event mask. These are the messages with id < 32. Messages with id >= 32 are user messages.

    Parameters: id The message id. See KIPC.Message.

    See Also: KIPC KApplication KApplication

    UNKNOWN: Adds a message type to the KIPC event mask.

    allowURLAction

    public void allowURLAction(String action, KURL _baseURL, KURL _destURL)
    Allow a certain URL action. This can be useful if your application needs to ensure access to an application specific directory that may otherwise be subject to KIOSK restrictions.

    Parameters: action The name of the action. _baseURL The url where the action originates from _destURL The object of the action

    UNKNOWN: Allow a certain URL action.

    authorize

    public boolean authorize(String genericAction)
    Returns whether a certain action is authorized

    Parameters: genericAction The name of a generic action

    Returns: true if the action is authorized

    UNKNOWN: Returns whether a certain action is authorized

    authorizeControlModule

    public boolean authorizeControlModule(String menuId)
    Returns whether access to a certain control module is authorized.

    Parameters: menuId identifying the control module, e.g. kde-mouse.desktop

    Returns: true if access to the module is authorized, false otherwise.

    UNKNOWN: Returns whether access to a certain control module is authorized.

    authorizeControlModules

    public ArrayList authorizeControlModules(String[] menuIds)
    Returns whether access to a certain control modules is authorized.

    Parameters: menuIds list of menu-ids of control module, an example of a menu-id is kde-mouse.desktop.

    Returns: Those control modules for which access has been authorized.

    UNKNOWN: Returns whether access to a certain control modules is authorized.

    authorizeKAction

    public boolean authorizeKAction(String action)
    Returns whether a certain KAction is authorized.

    Parameters: action The name of a KAction action. The name is prepended with "action/" before being passed to authorize()

    Returns: true if the KAction is authorized

    UNKNOWN: Returns whether a certain KAction is authorized.

    authorizeURLAction

    public boolean authorizeURLAction(String action, KURL baseURL, KURL destURL)
    Returns whether a certain URL related action is authorized.

    Parameters: action The name of the action. Known actions are list (may be listed (e.g. in file selection dialog)), link (may be linked to), open (may open) and redirect (may be redirected to) baseURL The url where the action originates from destURL The object of the action

    Returns: true when the action is authorized, false otherwise.

    UNKNOWN: Returns whether a certain URL related action is authorized.

    caption

    public String caption()
    Returns a text for the window caption. This may be set by "-caption", otherwise it will be equivalent to the name of the executable.

    Returns: the text for the window caption

    UNKNOWN: Returns a text for the window caption.

    checkRecoverFile

    public String checkRecoverFile(String pFilename, boolean bRecover)
    Check whether an auto-save file exists for the document you want to open.

    Parameters: pFilename The full path to the document you want to open. bRecover This gets set to true if there was a recover file.

    Returns: The full path of the file to open.

    UNKNOWN: Check whether an auto-save file exists for the document you want to open.

    className

    public String className()

    clear

    public void clear()
    If the widget with focus provides a clear() slot, call that slot. Thus for a simple application clear() can be implemented as:
    		 new KAction( i18n( "Clear" ), "editclear", 0, kapp, SLOT("clear()"), actionCollection(), "clear" );
    		 
    Note that for some widgets, this may not provide the intended bahavior. For example if you make use of the code above and a KListView has the focus, clear() will clear all of the items in the list. If this is not the intened behavior and you want to make use of this slot, you can subclass KListView and reimplement this slot. For example the following code would implement a KListView without this behavior:
    		 public class MyListView implements KListView {
    		    public    MyListView( QWidget  parent = 0, String  name = 0, WFlags f = 0 ) {}
    		   
    		 public    void clear() {}
    		 }
    		 

    UNKNOWN: If the widget with focus provides a clear() slot, call that slot.

    commitData

    public void commitData(QSessionManager sm)
    Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.

    UNKNOWN: Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.

    config

    public KConfig config()
    Returns the general config object ("appnamerc").

    Returns: the KConfig object for the instance.

    UNKNOWN: Returns the general config object ("appnamerc").

    copy

    public void copy()
    If the widget with focus provides a copy() slot, call that slot. Thus for a simple application copy can be implemented as:
    		 KStdAction.copy( kapp, SLOT("copy()"), actionCollection() );
    		 

    UNKNOWN: If the widget with focus provides a copy() slot, call that slot.

    createApplicationPalette

    public static QPalette createApplicationPalette()
    Used to obtain the QPalette that will be used to set the application palette. This is only useful for configuration modules such as krdb and should not be used in normal circumstances.

    Returns: the QPalette

    UNKNOWN: Used to obtain the QPalette that will be used to set the application palette.

    createApplicationPalette

    public static QPalette createApplicationPalette(KConfig config, int contrast)
    Raw access for use by KDM.

    UNKNOWN:

    cut

    public void cut()
    If the widget with focus provides a cut() slot, call that slot. Thus for a simple application cut can be implemented as:
    		 KStdAction.cut( kapp, SLOT("cut()"), actionCollection() );
    		 

    UNKNOWN: If the widget with focus provides a cut() slot, call that slot.

    dcopClient

    public static DCOPClient dcopClient()
    Returns a pointer to a DCOPClient for the application. If a client does not exist yet, it is created when this function is called.

    Returns: the DCOPClient for the application

    UNKNOWN: Returns a pointer to a DCOPClient for the application.

    deref

    public void deref()
    Tells KApplication that one operation such as those described in ref() just finished. The application exits if the counter is back to 0.

    UNKNOWN: Tells KApplication that one operation such as those described in ref() just finished.

    dirs

    public KStandardDirs dirs()
    Returns the application standard dirs object.

    Returns: The KStandardDirs of the application.

    UNKNOWN: Returns the application standard dirs object.

    disableAutoDcopRegistration

    public static void disableAutoDcopRegistration()
    Disable automatic dcop registration Must be called before creating a KApplication instance to have an effect.

    UNKNOWN: Disable automatic dcop registration Must be called before creating a KApplication instance to have an effect.

    disableSessionManagement

    public void disableSessionManagement()
    Disables session management for this application. Useful in case your application is started by the initial "startkde" script.

    UNKNOWN: Disables session management for this application.

    disableStyles

    public void disableStyles()
    Disables style plugins. Current style plugins do not get unloaded. This is only useful when used in combination with enableStyles().

    UNKNOWN: Disables style plugins.

    dispose

    public void dispose()
    Delete the wrapped C++ instance ahead of finalize()

    enableSessionManagement

    public void enableSessionManagement()
    Enables again session management for this application, formerly disabled by calling disableSessionManagement(). You usually shouldn't call this function, as the session management is enabled by default.

    UNKNOWN: Enables again session management for this application, formerly disabled by calling disableSessionManagement().

    enableStyles

    public void enableStyles()
    Enables style plugins. This is useful only to applications that normally do not display a GUI and create the KApplication with allowStyles set to false.

    UNKNOWN: Enables style plugins.

    finalize

    protected void finalize()
    Deletes the wrapped C++ instance

    geometryArgument

    public String geometryArgument()
    Returns the argument to --geometry if any, so the geometry can be set wherever necessary

    Returns: the geometry argument, or null if there is none

    UNKNOWN: Returns the argument to --geometry if any, so the geometry can be set wherever necessary

    guiEnabled

    public static boolean guiEnabled()
    Whether widgets can be used.

    UNKNOWN:

    icon

    public QPixmap icon()
    Returns a QPixmap with the application icon.

    Returns: the application icon

    UNKNOWN: Returns a QPixmap with the application icon.

    iconLoader

    public KIconLoader iconLoader()
    Returns an iconloader object.

    Returns: the iconloader object.

    UNKNOWN: Returns an iconloader object.

    iconName

    public String iconName()
    Returns the name of the application icon.

    Returns: the icon's name

    UNKNOWN: Returns the name of the application icon.

    installKDEPropertyMap

    public void installKDEPropertyMap()
    Install a Qt SQL property map with entries for all KDE widgets Call this in any application using KDE widgets in QSqlForm or QDataView.

    UNKNOWN: Install a Qt SQL property map with entries for all KDE widgets Call this in any application using KDE widgets in QSqlForm or QDataView.

    installSigpipeHandler

    public static void installSigpipeHandler()
    Installs a handler for the SIGPIPE signal. It is thrown when you write to a pipe or socket that has been closed. The handler is installed automatically in the constructor, but you may need it if your application or component does not have a KApplication instance.

    UNKNOWN: Installs a handler for the SIGPIPE signal.

    installX11EventFilter

    public void installX11EventFilter(QWidget filter)
    Installs widget filter as global X11 event filter. The widget filter receives XEvents in its standard QWidget.x11Event() function. Warning: Only do this when absolutely necessary. An installed X11 filter can slow things down.

    UNKNOWN: Installs widget filter as global X11 event filter.

    instanceName

    public String instanceName()
    Returns the name of the instance

    Returns: the instance name, can be null if the KInstance has been created with a null name

    UNKNOWN: Returns the name of the instance

    invokeBrowser

    public void invokeBrowser(String url, String startup_id)
    Invokes the standard browser. Note that you should only do this when you know for sure that the browser can handle the URL (i.e. its mimetype). In doubt, if the URL can point to an image or anything else than directory or HTML, prefer to use new KRun( url ).

    Parameters: url The destination address startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    UNKNOWN: Invokes the standard browser.

    invokeBrowser

    public void invokeBrowser(String url)
    Invoke the standard browser. Uses a startup_id of "" (empty) and is otherwise the same as the above function.

    UNKNOWN: Invoke the standard browser.

    invokeEditSlot

    protected void invokeEditSlot(String slot)
    This method is used internally to determine which edit slots are implemented by the widget that has the focus, and to invoke those slots if available.

    Parameters: slot is the slot as returned using the SLOT() macro, for example SLOT("cut()") This method can be used in KApplication subclasses to implement application wide edit actions not supported by the KApplication class. For example (in your subclass):

    		 void MyApplication.deselect()
    		 {
    		   invokeEditSlot( SLOT("deselect()") );
    		 }
    		 
    Now in your application calls to MyApplication.deselect() will call this slot on the focused widget if it provides this slot. You can combine this with KAction with:
    		 KStdAction.deselect( (MyApplication)( kapp ), SLOT("cut()"), actionCollection() );
    		 

    See Also: KApplication KApplication KApplication KApplication KApplication

    UNKNOWN: This method is used internally to determine which edit slots are implemented by the widget that has the focus, and to invoke those slots if available.

    invokeHelp

    public void invokeHelp(String anchor, String appname, String startup_id)
    Invokes the KHelpCenter HTML help viewer from docbook sources.

    Parameters: anchor This has to be a defined anchor in your docbook sources. If empty the main index is loaded appname This allows you to show the help of another application. If empty the current name() is used startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    UNKNOWN: Invokes the KHelpCenter HTML help viewer from docbook sources.

    invokeHelp

    public void invokeHelp(String anchor, String appname)

    invokeHelp

    public void invokeHelp(String anchor)

    invokeHelp

    public void invokeHelp()

    invokeMailer

    public void invokeMailer(String address, String subject, String startup_id)
    Convenience method; invokes the standard email application.

    Parameters: address The destination address subject Subject string. Can be null. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    UNKNOWN: Convenience method; invokes the standard email application.

    invokeMailer

    public void invokeMailer(String address, String subject)

    invokeMailer

    public void invokeMailer(KURL mailtoURL, String startup_id, boolean allowAttachments)
    Invokes the standard email application.

    Parameters: mailtoURL A mailto URL. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default allowAttachments whether attachments specified in mailtoURL should be honoured. The default is false; do not honour requests for attachments.

    UNKNOWN: Invokes the standard email application.

    invokeMailer

    public void invokeMailer(KURL mailtoURL, String startup_id)

    invokeMailer

    public void invokeMailer(KURL mailtoURL)

    invokeMailer

    public void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs, String startup_id)
    Convenience method; invokes the standard email application. All parameters are optional.

    Parameters: to The destination address. cc The Cc field bcc The Bcc field subject Subject string body A string containing the body of the mail (exclusive with messageFile) messageFile A file (URL) containing the body of the mail (exclusive with body) - currently unsupported attachURLs List of URLs to be attached to the mail. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    UNKNOWN: Convenience method; invokes the standard email application.

    invokeMailer

    public void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs)

    invokeMailer

    public void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile)

    invokeMailer

    public void invokeMailer(String to, String cc, String bcc, String subject, String body)

    isDisposed

    public boolean isDisposed()
    Has the wrapped C++ instance been deleted?

    isRestored

    public boolean isRestored()
    Is the application restored from the session manager?

    Returns: If true, this application was restored by the session manager. Note that this may mean the config object returned by sessionConfig() contains data saved by a session closedown.

    See Also: KApplication

    UNKNOWN: Is the application restored from the session manager?

    kApplication

    public static KApplication kApplication()
    Returns the current application object. This is similar to the global QApplication pointer qApp. It allows access to the single global KApplication object, since more than one cannot be created in the same application. It saves you the trouble of having to pass the pointer explicitly to every function that may require it.

    Returns: the current application object

    UNKNOWN: Returns the current application object.

    kdeinitExec

    public static int kdeinitExec(String name, String[] args, StringBuffer error, int[] pid, String startup_id)
    Starts a program via kdeinit. program name and arguments are converted to according to the local encoding and passed as is to kdeinit.

    Parameters: name Name of the program to start args Arguments to pass to the program error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a program via kdeinit.

    kdeinitExec

    public static int kdeinitExec(String name, String[] args, StringBuffer error, int[] pid)

    kdeinitExec

    public static int kdeinitExec(String name, String[] args, StringBuffer error)

    kdeinitExec

    public static int kdeinitExec(String name, String[] args)

    kdeinitExec

    public static int kdeinitExec(String name)

    kdeinitExecWait

    public static int kdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid, String startup_id)
    Starts a program via kdeinit and wait for it to finish. Like kdeinitExec(), but it waits till the program is finished. As such it behaves similar to the system(...) function.

    Parameters: name Name of the program to start args Arguments to pass to the program error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a program via kdeinit and wait for it to finish.

    kdeinitExecWait

    public static int kdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid)

    kdeinitExecWait

    public static int kdeinitExecWait(String name, String[] args, StringBuffer error)

    kdeinitExecWait

    public static int kdeinitExecWait(String name, String[] args)

    kdeinitExecWait

    public static int kdeinitExecWait(String name)

    keyboardMouseState

    public static int keyboardMouseState()
    Returns the state of the currently pressed keyboard modifiers (e.g. shift, control, etc.) and mouse buttons, similarly to QKeyEvent.state() and QMouseEvent.state(). You usually should simply use the information provided by QKeyEvent and QMouseEvent, but it can be useful to query for the status of the modifiers at another moment (e.g. some KDE apps do that upon a drop event).

    Returns: the keyboard modifiers and mouse buttons state

    UNKNOWN: Returns the state of the currently pressed keyboard modifiers (e.

    launcher

    public static String launcher()
    Returns the DCOP name of the service launcher. This will be something like klaucher_$host_$uid.

    Returns: the name of the service launcher

    UNKNOWN: Returns the DCOP name of the service launcher.

    makeStdCaption

    public String makeStdCaption(String userCaption, boolean withAppName, boolean modified)
    Builds a caption that contains the application name along with the userCaption using a standard layout. To make a compliant caption for your window, simply do: setCaption(kapp.makeStdCaption(yourCaption));

    Parameters: userCaption The caption string you want to display in the window caption area. Do not include the application name! withAppName Indicates that the method shall include or ignore the application name when making the caption string. You are not compliant if you set this to false. modified If true, a 'modified' sign will be included in the returned string. This is useful when indicating that a file is modified, i.e., it contains data that has not been saved.

    Returns: the created caption

    UNKNOWN: Builds a caption that contains the application name along with the userCaption using a standard layout.

    makeStdCaption

    public String makeStdCaption(String userCaption, boolean withAppName)

    makeStdCaption

    public String makeStdCaption(String userCaption)

    metaObject

    public QMetaObject metaObject()

    mimeSourceFactory

    public KMimeSourceFactory mimeSourceFactory()
    Returns the KMimeSourceFactory of the instance. Mainly added for API completeness and future extensibility.

    Returns: the KMimeSourceFactory set as default for this application.

    UNKNOWN: Returns the KMimeSourceFactory of the instance.

    miniIcon

    public QPixmap miniIcon()
    Returns the mini-icon for the application as a QPixmap.

    Returns: the application's mini icon

    UNKNOWN: Returns the mini-icon for the application as a QPixmap.

    miniIconName

    public String miniIconName()
    Returns the name of the mini-icon for the application.

    Returns: the mini icon's name

    UNKNOWN: Returns the name of the mini-icon for the application.

    newIconLoader

    public void newIconLoader()
    Re-allocate the global iconloader.

    UNKNOWN: Re-allocate the global iconloader.

    notify

    public boolean notify(QObject receiver, QEvent event)

    UNKNOWN:

    paste

    public void paste()
    If the widget with focus provides a paste() slot, call that slot. Thus for a simple application copy can be implemented as:
    		 KStdAction.paste( kapp, SLOT("paste()"), actionCollection() );
    		 

    UNKNOWN: If the widget with focus provides a paste() slot, call that slot.

    propagateSessionManager

    public void propagateSessionManager()
    Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up. If SESSION_MANAGER isn't defined yet, the address is searched in $HOME/.KSMserver. This function is called by clients that are started outside the session ( i.e. before ksmserver is started), but want to launch other processes that should participate in the session. Examples are kdesktop or kicker.

    UNKNOWN: Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up.

    random

    public static int random()
    Generates a uniform random number.

    Returns: A truly unpredictable number in the range [0, RAND_MAX)

    UNKNOWN: Generates a uniform random number.

    randomString

    public static String randomString(int length)
    Generates a random string. It operates in the range [A-Za-z0-9]

    Parameters: length Generate a string of this length.

    Returns: the random string

    UNKNOWN: Generates a random string.

    ref

    public void ref()
    Tells KApplication about one more operation that should be finished before the application exits. The standard behavior is to exit on the "last window closed" event, but some events should outlive the last window closed (e.g. a file copy for a file manager, or 'compacting folders on exit' for a mail client).

    UNKNOWN: Tells KApplication about one more operation that should be finished before the application exits.

    removeKipcEventMask

    public void removeKipcEventMask(int id)
    Removes a message type from the KIPC event mask. This message will not be handled anymore.

    Parameters: id The message id.

    See Also: KIPC KApplication KApplication

    UNKNOWN: Removes a message type from the KIPC event mask.

    removeX11EventFilter

    public void removeX11EventFilter(QWidget filter)
    Removes global X11 event filter previously installed by installX11EventFilter().

    UNKNOWN: Removes global X11 event filter previously installed by installX11EventFilter().

    requestShutDown

    public boolean requestShutDown(int confirm, int sdtype, int sdmode)
    Asks the session manager to shut the session down. Using confirm == ShutdownConfirmYes or sdtype != ShutdownTypeDefault or sdmode != ShutdownModeDefault causes the use of ksmserver's DCOP interface. The remaining two combinations use the standard XSMP and will work with any session manager compliant with it.

    Parameters: confirm Whether to ask the user if he really wants to log out. ShutdownConfirm sdtype The action to take after logging out. ShutdownType sdmode If/When the action should be taken. ShutdownMode

    Returns: true on success, false if the session manager could not be contacted.

    UNKNOWN: Asks the session manager to shut the session down.

    requestShutDown

    public boolean requestShutDown(int confirm, int sdtype)

    requestShutDown

    public boolean requestShutDown(int confirm)

    requestShutDown

    public boolean requestShutDown()

    saveState

    public void saveState(QSessionManager sm)
    Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.

    UNKNOWN: Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.

    selectAll

    public void selectAll()
    If the widget with focus provides a selectAll() slot, call that slot. Thus for a simple application select all can be implemented as:
    		 KStdAction.selectAll( kapp, SLOT("selectAll()"), actionCollection() );
    		 

    UNKNOWN: If the widget with focus provides a selectAll() slot, call that slot.

    sessionConfig

    public KConfig sessionConfig()
    Returns the application session config object.

    Returns: A pointer to the application's instance specific KConfig object.

    See Also: KConfig

    UNKNOWN: Returns the application session config object.

    sessionSaving

    public boolean sessionSaving()
    Returns true if the application is currently saving its session data (most probably before KDE logout). This is intended for use mainly in KMainWindow.queryClose() and KMainWindow.queryExit().

    See Also: KMainWindow KMainWindow

    UNKNOWN: Returns true if the application is currently saving its session data (most probably before KDE logout).

    setConfigName

    protected void setConfigName(String name)
    Set name of default config file.

    Parameters: name the name of the default config file

    UNKNOWN: Set name of default config file.

    setJavaSlotFactory

    public static void setJavaSlotFactory()
    Used internally by the KDE Koala Java bindings runtime

    setStartupId

    public void setStartupId(String startup_id)
    Sets a new value for the application startup notification window property for newly created toplevel windows.

    Parameters: startup_id the startup notification identifier

    See Also: KStartupInfo#setNewStartupId

    UNKNOWN:

    setTopWidget

    public void setTopWidget(QWidget topWidget)
    Sets the top widget of the application. This means basically applying the right window caption and icon. An application may have several top widgets. You don't need to call this function manually when using KMainWindow.

    Parameters: topWidget A top widget of the application.

    See Also: KApplication KApplication

    UNKNOWN: Sets the top widget of the application.

    sharedConfig

    public KSharedConfig sharedConfig()
    Returns the general config object ("appnamerc").

    Returns: the KConfig object for the instance.

    UNKNOWN: Returns the general config object ("appnamerc").

    startKdeinit

    public static void startKdeinit()

    UNKNOWN:

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop name of the service. E.g. "konqueror"

    Parameters: _name the desktop name of the service URL if not empty this URL is passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the desktop name of the service.

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL, StringBuffer error)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String URL)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop name of the service. E.g. "konqueror"

    Parameters: _name the desktop name of the service URLs if not empty these URLs will be passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the desktop name of the service.

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name, String[] URLs)

    startServiceByDesktopName

    public static int startServiceByDesktopName(String _name)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop path of the service. E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop"

    Parameters: _name the path of the desktop file URL if not empty this URL is passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the desktop path of the service.

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL, StringBuffer error)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String URL)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the desktop path of the service. E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop"

    Parameters: _name the path of the desktop file URLs if not empty these URLs will be passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the desktop path of the service.

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name, String[] URLs)

    startServiceByDesktopPath

    public static int startServiceByDesktopPath(String _name)

    startServiceByName

    public static int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the (translated) name of the service. E.g. "Web Browser"

    Parameters: _name the name of the service URL if not empty this URL is passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the (translated) name of the service.

    startServiceByName

    public static int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByName

    public static int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByName

    public static int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService)

    startServiceByName

    public static int startServiceByName(String _name, String URL, StringBuffer error)

    startServiceByName

    public static int startServiceByName(String _name, String URL)

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait)
    Starts a service based on the (translated) name of the service. E.g. "Web Browser"

    Parameters: _name the name of the service URLs if not empty these URLs will be passed to the service error On failure, error contains a description of the error that occurred. If the pointer is 0, the argument will be ignored dcopService On success, dcopService contains the DCOP name under which this service is available. If empty, the service does not provide DCOP services. If the pointer is 0 the argument will be ignored pid On success, the process id of the new service will be written here. If the pointer is 0, the argument will be ignored. startup_id for app startup notification, "0" for none, "" ( empty string ) is the default noWait if set, the function does not wait till the service is running.

    Returns: an error code indicating success (== 0) or failure (> 0).

    UNKNOWN: Starts a service based on the (translated) name of the service.

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id)

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid)

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService)

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs, StringBuffer error)

    startServiceByName

    public static int startServiceByName(String _name, String[] URLs)

    startServiceByName

    public static int startServiceByName(String _name)

    startupId

    public String startupId()
    Returns the app startup notification identifier for this running application.

    Returns: the startup notification identifier

    UNKNOWN: Returns the app startup notification identifier for this running application.

    tempSaveName

    public String tempSaveName(String pFilename)
    Get a file name in order to make a temporary copy of your document.

    Parameters: pFilename The full path to the current file of your document.

    Returns: A new filename for auto-saving.

    UNKNOWN: Get a file name in order to make a temporary copy of your document.

    updateRemoteUserTimestamp

    public void updateRemoteUserTimestamp(String dcopId, long time)
    Updates the last user action timestamp in the application registered to DCOP with dcopId to the given time, or to this application's user time, if 0 is given. Use before causing user interaction in the remote application, e.g. invoking a dialog in the application using a DCOP call. Consult focus stealing prevention section in kdebase/kwin/README.

    UNKNOWN: Updates the last user action timestamp in the application registered to DCOP with dcopId to the given time, or to this application's user time, if 0 is given.

    updateRemoteUserTimestamp

    public void updateRemoteUserTimestamp(String dcopId)

    updateUserTimestamp

    public void updateUserTimestamp(long time)
    Updates the last user action timestamp to the given time, or to the current time, if 0 is given. Do not use unless you're really sure what you're doing. Consult focus stealing prevention section in kdebase/kwin/README.

    UNKNOWN: Updates the last user action timestamp to the given time, or to the current time, if 0 is given.

    updateUserTimestamp

    public void updateUserTimestamp()

    userTimestamp

    public long userTimestamp()
    Returns the last user action timestamp or 0 if no user activity has taken place yet.

    See Also: KApplication

    UNKNOWN: Returns the last user action timestamp or 0 if no user activity has taken place yet.