org.kde.koala
public class KApplication extends QApplication implements KInstanceInterface
UNKNOWN: Controls and provides information to all KDE applications.
Field Summary | |
---|---|
static int | Button1Pressed |
static int | Button2Pressed |
static int | Button3Pressed |
static int | Button4Pressed |
static int | Button5Pressed |
static int | CaptionAppFirst |
static int | CaptionAppLast Position of the caption (presumably in the application window's
title bar). |
static int | CaptionNoApp |
static int | ControlModifier |
static int | LockModifier |
static int | Modifier1 |
static int | Modifier2 |
static int | Modifier3 |
static int | Modifier4 |
static int | Modifier5 |
static int | SETTINGS_COMPLETION |
static int | SETTINGS_MOUSE
Valid values for the settingsChanged signal |
static int | SETTINGS_PATHS |
static int | SETTINGS_POPUPMENU |
static int | SETTINGS_QT |
static int | SETTINGS_SHORTCUTS |
static int | ShiftModifier |
static int | ShutdownConfirmDefault
The possible values for the confirm parameter of requestShutDown(). |
static int | ShutdownConfirmNo |
static int | ShutdownConfirmYes |
static int | ShutdownModeDefault
The possible values for the sdmode parameter of requestShutDown(). |
static int | ShutdownModeForceNow |
static int | ShutdownModeInteractive |
static int | ShutdownModeSchedule |
static int | ShutdownModeTryNow |
static int | ShutdownTypeDefault
The possible values for the sdtype parameter of requestShutDown(). |
static int | ShutdownTypeHalt |
static int | ShutdownTypeNone |
static int | ShutdownTypeReboot |
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 | |
---|---|
KAboutData | aboutData()
Returns the about data of this instance
Warning, can be null |
static void | addCmdLineOptions()
Add Qt and KDE command line options to KCmdLineArgs. |
void | addKipcEventMask(int id)
Adds a message type to the KIPC event mask. |
void | allowURLAction(String action, KURL _baseURL, KURL _destURL)
Allow a certain URL action. |
boolean | authorize(String genericAction)
Returns whether a certain action is authorized |
boolean | authorizeControlModule(String menuId)
Returns whether access to a certain control module is authorized. |
ArrayList | authorizeControlModules(String[] menuIds)
Returns whether access to a certain control modules is authorized. |
boolean | authorizeKAction(String action)
Returns whether a certain KAction is authorized. |
boolean | authorizeURLAction(String action, KURL baseURL, KURL destURL)
Returns whether a certain URL related action is authorized. |
String | caption()
Returns a text for the window caption.
|
String | checkRecoverFile(String pFilename, boolean bRecover)
Check whether an auto-save file exists for the document you want to
open. |
String | className() |
void | clear()
If the widget with focus provides a clear() slot, call that slot. |
void | commitData(QSessionManager sm)
Reimplemented for internal purposes, mainly the highlevel
handling of session management with KSessionManaged. |
KConfig | config()
Returns the general config object ("appnamerc"). |
void | copy()
If the widget with focus provides a copy() slot, call that slot. |
static QPalette | createApplicationPalette()
Used to obtain the QPalette that will be used to set the application palette.
|
static QPalette | createApplicationPalette(KConfig config, int contrast)
Raw access for use by KDM. |
void | cut()
If the widget with focus provides a cut() slot, call that slot. |
static DCOPClient | dcopClient()
Returns a pointer to a DCOPClient for the application.
|
void | deref()
Tells KApplication that one operation such as those described in ref() just finished.
|
KStandardDirs | dirs()
Returns the application standard dirs object. |
static void | disableAutoDcopRegistration()
Disable automatic dcop registration
Must be called before creating a KApplication instance to have an effect. |
void | disableSessionManagement()
Disables session management for this application.
|
void | disableStyles()
Disables style plugins.
|
void | dispose() Delete the wrapped C++ instance ahead of finalize() |
void | enableSessionManagement()
Enables again session management for this application, formerly
disabled by calling disableSessionManagement(). |
void | enableStyles()
Enables style plugins.
|
protected void | finalize() Deletes the wrapped C++ instance |
String | geometryArgument()
Returns the argument to --geometry if any, so the geometry can be set
wherever necessary |
static boolean | guiEnabled()
Whether widgets can be used. |
QPixmap | icon()
Returns a QPixmap with the application icon. |
KIconLoader | iconLoader()
Returns an iconloader object. |
String | iconName()
Returns the name of the application icon. |
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. |
static void | installSigpipeHandler()
Installs a handler for the SIGPIPE signal. |
void | installX11EventFilter(QWidget filter)
Installs widget filter as global X11 event filter.
|
String | instanceName()
Returns the name of the instance |
void | invokeBrowser(String url, String startup_id)
Invokes the standard browser.
|
void | invokeBrowser(String url)
Invoke the standard browser. |
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. |
void | invokeHelp(String anchor, String appname, String startup_id)
Invokes the KHelpCenter HTML help viewer from docbook sources. |
void | invokeHelp(String anchor, String appname) |
void | invokeHelp(String anchor) |
void | invokeHelp() |
void | invokeMailer(String address, String subject, String startup_id)
Convenience method; invokes the standard email application. |
void | invokeMailer(String address, String subject) |
void | invokeMailer(KURL mailtoURL, String startup_id, boolean allowAttachments)
Invokes the standard email application. |
void | invokeMailer(KURL mailtoURL, String startup_id) |
void | invokeMailer(KURL mailtoURL) |
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.
|
void | invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs) |
void | invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile) |
void | invokeMailer(String to, String cc, String bcc, String subject, String body) |
boolean | isDisposed() Has the wrapped C++ instance been deleted? |
boolean | isRestored()
Is the application restored from the session manager? |
static KApplication | kApplication()
Returns the current application object.
|
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. |
static int | kdeinitExec(String name, String[] args, StringBuffer error, int[] pid) |
static int | kdeinitExec(String name, String[] args, StringBuffer error) |
static int | kdeinitExec(String name, String[] args) |
static int | kdeinitExec(String name) |
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.
|
static int | kdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid) |
static int | kdeinitExecWait(String name, String[] args, StringBuffer error) |
static int | kdeinitExecWait(String name, String[] args) |
static int | kdeinitExecWait(String name) |
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().
|
static String | launcher()
Returns the DCOP name of the service launcher. |
String | makeStdCaption(String userCaption, boolean withAppName, boolean modified)
Builds a caption that contains the application name along with the
userCaption using a standard layout.
|
String | makeStdCaption(String userCaption, boolean withAppName) |
String | makeStdCaption(String userCaption) |
QMetaObject | metaObject() |
KMimeSourceFactory | mimeSourceFactory()
Returns the KMimeSourceFactory of the instance.
|
QPixmap | miniIcon()
Returns the mini-icon for the application as a QPixmap. |
String | miniIconName()
Returns the name of the mini-icon for the application. |
void | newIconLoader()
Re-allocate the global iconloader. |
boolean | notify(QObject receiver, QEvent event) |
void | paste()
If the widget with focus provides a paste() slot, call that slot. |
void | propagateSessionManager()
Propagates the network address of the session manager in the
SESSION_MANAGER environment variable so that child processes can
pick it up.
|
static int | random()
Generates a uniform random number. |
static String | randomString(int length)
Generates a random string. |
void | ref()
Tells KApplication about one more operation that should be finished
before the application exits. |
void | removeKipcEventMask(int id)
Removes a message type from the KIPC event mask. |
void | removeX11EventFilter(QWidget filter)
Removes global X11 event filter previously installed by
installX11EventFilter(). |
boolean | requestShutDown(int confirm, int sdtype, int sdmode)
Asks the session manager to shut the session down.
|
boolean | requestShutDown(int confirm, int sdtype) |
boolean | requestShutDown(int confirm) |
boolean | requestShutDown() |
void | saveState(QSessionManager sm)
Reimplemented for internal purposes, mainly the highlevel
handling of session management with KSessionManaged. |
void | selectAll()
If the widget with focus provides a selectAll() slot, call that slot. |
KConfig | sessionConfig()
Returns the application session config object. |
boolean | sessionSaving()
Returns true if the application is currently saving its session
data (most probably before KDE logout). |
protected void | setConfigName(String name)
Set name of default config file. |
static void | setJavaSlotFactory()
Used internally by the KDE Koala Java bindings runtime |
void | setStartupId(String startup_id)
Sets a new value for the application startup notification window property for newly
created toplevel windows. |
void | setTopWidget(QWidget topWidget)
Sets the top widget of the application.
|
KSharedConfig | sharedConfig()
Returns the general config object ("appnamerc"). |
static void | startKdeinit() |
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.
|
static int | startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByDesktopName(String _name, String URL, StringBuffer error) |
static int | startServiceByDesktopName(String _name, String URL) |
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.
|
static int | startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByDesktopName(String _name, String[] URLs, StringBuffer error) |
static int | startServiceByDesktopName(String _name, String[] URLs) |
static int | startServiceByDesktopName(String _name) |
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.
|
static int | startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByDesktopPath(String _name, String URL, StringBuffer error) |
static int | startServiceByDesktopPath(String _name, String URL) |
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.
|
static int | startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error) |
static int | startServiceByDesktopPath(String _name, String[] URLs) |
static int | startServiceByDesktopPath(String _name) |
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.
|
static int | startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByName(String _name, String URL, StringBuffer error) |
static int | startServiceByName(String _name, String URL) |
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.
|
static int | startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id) |
static int | startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid) |
static int | startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService) |
static int | startServiceByName(String _name, String[] URLs, StringBuffer error) |
static int | startServiceByName(String _name, String[] URLs) |
static int | startServiceByName(String _name) |
String | startupId()
Returns the app startup notification identifier for this running
application. |
String | tempSaveName(String pFilename)
Get a file name in order to make a temporary copy of your document. |
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.
|
void | updateRemoteUserTimestamp(String dcopId) |
void | updateUserTimestamp(long time)
Updates the last user action timestamp to the given time, or to the current time,
if 0 is given. |
void | updateUserTimestamp() |
long | userTimestamp()
Returns the last user action timestamp or 0 if no user activity has taken place yet. |
Deprecated: Same values as Button1Mask etc. in X.h @short @deprecated Same values as Button1Mask etc.
UNKNOWN: Find out if this is used anywhere. Position of the caption (presumably in the application window's title bar).
UNKNOWN: Valid values for the settingsChanged signal
confirm
parameter of requestShutDown().UNKNOWN: The possible values for the confirm
parameter of requestShutDown().
sdmode
parameter of requestShutDown().UNKNOWN: The possible values for the sdmode
parameter of requestShutDown().
sdtype
parameter of requestShutDown().UNKNOWN: The possible values for the sdtype
parameter of requestShutDown().
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.
UNKNOWN:
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
UNKNOWN: Add Qt and KDE command line options to KCmdLineArgs.
Parameters: id The message id. See KIPC.Message.
See Also: KIPC KApplication KApplication
UNKNOWN: Adds a message type to the KIPC event mask.
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.
Parameters: genericAction The name of a generic action
Returns: true if the action is authorized
UNKNOWN: Returns whether a certain action 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.
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.
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.
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.
Returns: the text for the window caption
UNKNOWN: Returns a text for the window caption.
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.
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.
UNKNOWN: Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.
Returns: the KConfig object for the instance.
UNKNOWN: Returns the general config object ("appnamerc").
KStdAction.copy( kapp, SLOT("copy()"), actionCollection() );
UNKNOWN: If the widget with focus provides a copy() slot, call that slot.
Returns: the QPalette
UNKNOWN: Used to obtain the QPalette that will be used to set the application palette.
UNKNOWN:
KStdAction.cut( kapp, SLOT("cut()"), actionCollection() );
UNKNOWN: If the widget with focus provides a cut() slot, call that slot.
Returns: the DCOPClient for the application
UNKNOWN: Returns a pointer to a DCOPClient for the application.
UNKNOWN: Tells KApplication that one operation such as those described in ref() just finished.
Returns: The KStandardDirs of the application.
UNKNOWN: Returns the application standard dirs object.
UNKNOWN: Disable automatic dcop registration Must be called before creating a KApplication instance to have an effect.
UNKNOWN: Disables session management for this application.
UNKNOWN: Disables style plugins.
UNKNOWN: Enables again session management for this application, formerly disabled by calling disableSessionManagement().
UNKNOWN: Enables style plugins.
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
UNKNOWN:
Returns: the application icon
UNKNOWN: Returns a QPixmap with the application icon.
Returns: the iconloader object.
UNKNOWN: Returns an iconloader object.
Returns: the icon's name
UNKNOWN: Returns the name of the application icon.
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.
UNKNOWN: Installs a handler for the SIGPIPE signal.
UNKNOWN: Installs widget filter as global X11 event filter.
Returns: the instance name, can be null if the KInstance has been created with a null name
UNKNOWN: Returns the name of the instance
Parameters: url The destination address startup_id for app startup notification, "0" for none, "" ( empty string ) is the default
UNKNOWN: Invokes the standard browser.
startup_id
of "" (empty)
and is otherwise the same as the above function.UNKNOWN: Invoke the standard browser.
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.
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.
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.
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.
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.
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?
Returns: the current application object
UNKNOWN: Returns the current application object.
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.
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.
Returns: the keyboard modifiers and mouse buttons state
UNKNOWN: Returns the state of the currently pressed keyboard modifiers (e.
Returns: the name of the service launcher
UNKNOWN: Returns the DCOP name of the service launcher.
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.
Returns: the KMimeSourceFactory set as default for this application.
UNKNOWN: Returns the KMimeSourceFactory of the instance.
Returns: the application's mini icon
UNKNOWN: Returns the mini-icon for the application as a QPixmap.
Returns: the mini icon's name
UNKNOWN: Returns the name of the mini-icon for the application.
UNKNOWN: Re-allocate the global iconloader.
UNKNOWN:
KStdAction.paste( kapp, SLOT("paste()"), actionCollection() );
UNKNOWN: If the widget with focus provides a paste() slot, call that slot.
UNKNOWN: Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up.
Returns: A truly unpredictable number in the range [0, RAND_MAX)
UNKNOWN: Generates a uniform random number.
Parameters: length Generate a string of this length.
Returns: the random string
UNKNOWN: Generates a random string.
UNKNOWN: Tells KApplication about one more operation that should be finished before the application exits.
Parameters: id The message id.
See Also: KIPC KApplication KApplication
UNKNOWN: Removes a message type from the KIPC event mask.
UNKNOWN: Removes global X11 event filter previously installed by installX11EventFilter().
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.
UNKNOWN: Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged.
KStdAction.selectAll( kapp, SLOT("selectAll()"), actionCollection() );
UNKNOWN: If the widget with focus provides a selectAll() slot, call that slot.
Returns: A pointer to the application's instance specific KConfig object.
See Also: KConfig
UNKNOWN: Returns the application session config object.
See Also: KMainWindow KMainWindow
UNKNOWN: Returns true if the application is currently saving its session data (most probably before KDE logout).
Parameters: name the name of the default config file
UNKNOWN: Set name of default config file.
Parameters: startup_id the startup notification identifier
See Also: KStartupInfo#setNewStartupId
UNKNOWN:
Parameters: topWidget A top widget of the application.
See Also: KApplication KApplication
UNKNOWN: Sets the top widget of the application.
Returns: the KConfig object for the instance.
UNKNOWN: Returns the general config object ("appnamerc").
UNKNOWN:
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.
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.
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.
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.
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.
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.
Returns: the startup notification identifier
UNKNOWN: Returns the app startup notification identifier for this running application.
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.
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.
UNKNOWN: Updates the last user action timestamp to the given time, or to the current time, if 0 is given.
See Also: KApplication
UNKNOWN: Returns the last user action timestamp or 0 if no user activity has taken place yet.