From 3b8c3eec420595c4532e4c4f2282b6bc2802d5a9 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Mon, 21 Jan 2013 12:14:42 -0600 Subject: Rename files with KApplication or KCmdLineArgs in their names --- kdejava/koala/org/kde/koala/KApplication.java | 1088 -------------------- .../koala/org/kde/koala/KApplicationSignals.java | 116 --- kdejava/koala/org/kde/koala/KCmdLineArgs.java | 478 --------- kdejava/koala/org/kde/koala/TDEApplication.java | 1088 ++++++++++++++++++++ .../koala/org/kde/koala/TDEApplicationSignals.java | 116 +++ kdejava/koala/org/kde/koala/TDECmdLineArgs.java | 478 +++++++++ 6 files changed, 1682 insertions(+), 1682 deletions(-) delete mode 100644 kdejava/koala/org/kde/koala/KApplication.java delete mode 100644 kdejava/koala/org/kde/koala/KApplicationSignals.java delete mode 100644 kdejava/koala/org/kde/koala/KCmdLineArgs.java create mode 100644 kdejava/koala/org/kde/koala/TDEApplication.java create mode 100644 kdejava/koala/org/kde/koala/TDEApplicationSignals.java create mode 100644 kdejava/koala/org/kde/koala/TDECmdLineArgs.java (limited to 'kdejava/koala/org/kde') diff --git a/kdejava/koala/org/kde/koala/KApplication.java b/kdejava/koala/org/kde/koala/KApplication.java deleted file mode 100644 index e8f7194e..00000000 --- a/kdejava/koala/org/kde/koala/KApplication.java +++ /dev/null @@ -1,1088 +0,0 @@ -//Auto-generated by kalyptus. DO NOT EDIT. -package org.kde.koala; - -import org.kde.qt.Qt; -import org.kde.qt.TQMetaObject; -import org.kde.qt.QtSupport; -import org.kde.qt.TQObject; -import org.kde.qt.TQPixmap; -import org.kde.qt.TQSessionManager; -import java.util.ArrayList; -import org.kde.qt.TQEvent; -import org.kde.qt.TQWidget; -import org.kde.qt.TQPalette; -import org.kde.qt.TQApplication; - -/** - - 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 TQApplication ). -
  • - -
  • - 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 TDEApplication'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 TDEApplication'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 {@link TDEApplicationSignals} for signals emitted by TDEApplication - @author Matthias Kalle Dalheimer - - @short Controls and provides information to all KDE applications. - -*/ -public class TDEApplication extends TQApplication implements KInstanceInterface { - protected TDEApplication(Class dummy){super((Class) null);} - public static final int ShiftModifier = 1<<0; - public static final int LockModifier = 1<<1; - public static final int ControlModifier = 1<<2; - public static final int Modifier1 = 1<<3; - public static final int Modifier2 = 1<<4; - public static final int Modifier3 = 1<<5; - public static final int Modifier4 = 1<<6; - public static final int Modifier5 = 1<<7; - - /** @deprecated Same values as Button1Mask etc. in X.h @short @deprecated Same values as Button1Mask etc. - */ - public static final int Button1Pressed = 1<<8; - public static final int Button2Pressed = 1<<9; - public static final int Button3Pressed = 1<<10; - public static final int Button4Pressed = 1<<11; - public static final int Button5Pressed = 1<<12; - - /** Position of the caption (presumably in the application window's - title bar). This enum appears to be unused. - @todo Find out if this is used anywhere. - @short Position of the caption (presumably in the application window's title bar). - */ - public static final int CaptionAppLast = 1; - public static final int CaptionAppFirst = 2; - public static final int CaptionNoApp = 3; - - /** - The possible values for the confirm parameter of requestShutDown(). - @short The possible values for the confirm parameter of requestShutDown(). - */ - public static final int ShutdownConfirmDefault = -1; - public static final int ShutdownConfirmNo = 0; - public static final int ShutdownConfirmYes = 1; - - /** - The possible values for the sdtype parameter of requestShutDown(). - @short The possible values for the sdtype parameter of requestShutDown(). - */ - public static final int ShutdownTypeDefault = -1; - public static final int ShutdownTypeNone = 0; - public static final int ShutdownTypeReboot = 1; - public static final int ShutdownTypeHalt = 2; - - /** - The possible values for the sdmode parameter of requestShutDown(). - @short The possible values for the sdmode parameter of requestShutDown(). - */ - public static final int ShutdownModeDefault = -1; - public static final int ShutdownModeSchedule = 0; - public static final int ShutdownModeTryNow = 1; - public static final int ShutdownModeForceNow = 2; - public static final int ShutdownModeInteractive = 3; - - /** - Valid values for the settingsChanged signal - @short Valid values for the settingsChanged signal - */ - public static final int SETTINGS_MOUSE = 0; - public static final int SETTINGS_COMPLETION = 1; - public static final int SETTINGS_PATHS = 2; - public static final int SETTINGS_POPUPMENU = 3; - public static final int SETTINGS_QT = 4; - public static final int SETTINGS_SHORTCUTS = 5; - - public native TQMetaObject metaObject(); - public native String className(); - /** - This constructor takes aboutData and command line - arguments from KCmdLineArgs. - @param 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. - @param GUIenabled Set to false to disable all GUI stuff. This implies - no styles either. - @short This constructor takes aboutData and command line arguments from KCmdLineArgs. - */ - public TDEApplication(boolean allowStyles, boolean GUIenabled) { - super((Class) null); - newTDEApplication(allowStyles,GUIenabled); - } - private native void newTDEApplication(boolean allowStyles, boolean GUIenabled); - public TDEApplication(boolean allowStyles) { - super((Class) null); - newTDEApplication(allowStyles); - } - private native void newTDEApplication(boolean allowStyles); - public TDEApplication() { - super((Class) null); - newTDEApplication(); - } - private native void newTDEApplication(); - /** - Returns the application session config object. - @return A pointer to the application's instance specific - KConfig object. - - @short Returns the application session config object. - @see KConfig - */ - public native KConfig sessionConfig(); - /** - Is the application restored from the session manager? - @return 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. - - @short Is the application restored from the session manager? - @see #sessionConfig - */ - public native boolean isRestored(); - /** - Disables session management for this application. - Useful in case your application is started by the - initial "starttde" script. - @short Disables session management for this application. - */ - public native void disableSessionManagement(); - /** - 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. - @short Enables again session management for this application, formerly disabled by calling disableSessionManagement(). - */ - public native void enableSessionManagement(); - /** - 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. - @param confirm Whether to ask the user if he really wants to log out. - ShutdownConfirm - @param sdtype The action to take after logging out. ShutdownType - @param sdmode If/When the action should be taken. ShutdownMode - @return true on success, false if the session manager could not be - contacted. - - @short Asks the session manager to shut the session down. - */ - public native boolean requestShutDown(int confirm, int sdtype, int sdmode); - public native boolean requestShutDown(int confirm, int sdtype); - public native boolean requestShutDown(int confirm); - public native boolean requestShutDown(); - /** - 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. - @short Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up. - */ - public native void propagateSessionManager(); - /** - Reimplemented for internal purposes, mainly the highlevel - handling of session management with KSessionManaged. - @short Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged. - */ - public native void commitData(TQSessionManager sm); - /** - Reimplemented for internal purposes, mainly the highlevel - handling of session management with KSessionManaged. - @short Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged. - */ - public native void saveState(TQSessionManager sm); - /** - 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(). - @short Returns true if the application is currently saving its session data (most probably before KDE logout). - @see KMainWindow#queryClose - @see KMainWindow#queryExit - */ - public native boolean sessionSaving(); - /** - Returns a TQPixmap with the application icon. - @return the application icon - - @short Returns a TQPixmap with the application icon. - */ - public native TQPixmap icon(); - /** - Returns the name of the application icon. - @return the icon's name - - @short Returns the name of the application icon. - */ - public native String iconName(); - /** - Returns the mini-icon for the application as a TQPixmap. - @return the application's mini icon - - @short Returns the mini-icon for the application as a TQPixmap. - */ - public native TQPixmap miniIcon(); - /** - Returns the name of the mini-icon for the application. - @return the mini icon's name - - @short Returns the name of the mini-icon for the application. - */ - public native String miniIconName(); - /** - 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. - @param topWidget A top widget of the application. - @short Sets the top widget of the application. - @see #icon - @see #caption - */ - public native void setTopWidget(TQWidget topWidget); - /** - Invokes the KHelpCenter HTML help viewer from docbook sources. - @param anchor This has to be a defined anchor in your - docbook sources. If empty the main index - is loaded - @param appname This allows you to show the help of another - application. If empty the current name() is - used - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @short Invokes the KHelpCenter HTML help viewer from docbook sources. - */ - public native void invokeHelp(String anchor, String appname, String startup_id); - public native void invokeHelp(String anchor, String appname); - public native void invokeHelp(String anchor); - public native void invokeHelp(); - /** - Convenience method; invokes the standard email application. - @param address The destination address - @param subject Subject string. Can be null. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @short Convenience method; invokes the standard email application. - */ - public native void invokeMailer(String address, String subject, String startup_id); - public native void invokeMailer(String address, String subject); - /** - Invokes the standard email application. - @param mailtoURL A mailto URL. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param allowAttachments whether attachments specified in mailtoURL should be honoured. - The default is false; do not honour requests for attachments. - @short Invokes the standard email application. - */ - public native void invokeMailer(KURL mailtoURL, String startup_id, boolean allowAttachments); - public native void invokeMailer(KURL mailtoURL, String startup_id); - public native void invokeMailer(KURL mailtoURL); - /** - Convenience method; invokes the standard email application. - All parameters are optional. - @param to The destination address. - @param cc The Cc field - @param bcc The Bcc field - @param subject Subject string - @param body A string containing the body of the mail (exclusive with messageFile) - @param messageFile A file (URL) containing the body of the mail (exclusive with body) - currently unsupported - @param attachURLs List of URLs to be attached to the mail. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @short Convenience method; invokes the standard email application. - */ - public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs, String startup_id); - public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs); - public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile); - public native void invokeMailer(String to, String cc, String bcc, String subject, String body); - /** - Returns a text for the window caption. - This may be set by - "-caption", otherwise it will be equivalent to the name of the - executable. - @return the text for the window caption - - @short Returns a text for the window caption. - */ - public native String caption(); - /** - 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)); - @param userCaption The caption string you want to display in the - window caption area. Do not include the application name! - @param 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. - @param 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. - @return the created caption - - @short Builds a caption that contains the application name along with the userCaption using a standard layout. - */ - public native String makeStdCaption(String userCaption, boolean withAppName, boolean modified); - public native String makeStdCaption(String userCaption, boolean withAppName); - public native String makeStdCaption(String userCaption); - /** - Get a file name in order to make a temporary copy of your document. - @param pFilename The full path to the current file of your - document. - @return A new filename for auto-saving. - - @short Get a file name in order to make a temporary copy of your document. - */ - public native String tempSaveName(String pFilename); - /** - Check whether an auto-save file exists for the document you want to - open. - @param pFilename The full path to the document you want to open. - @param bRecover This gets set to true if there was a recover - file. - @return The full path of the file to open. - - @short Check whether an auto-save file exists for the document you want to open. - */ - public native String checkRecoverFile(String pFilename, boolean bRecover); - /** - Enables style plugins. - This is useful only to applications that normally - do not display a GUI and create the TDEApplication with - allowStyles set to false. - @short Enables style plugins. - */ - public native void enableStyles(); - /** - Disables style plugins. - Current style plugins do not get unloaded. - This is only useful when used in combination with enableStyles(). - @short Disables style plugins. - */ - public native void disableStyles(); - /** - Installs widget filter as global X11 event filter. - The widget - filter receives XEvents in its standard TQWidget.x11Event() function. - Warning: Only do this when absolutely necessary. An installed X11 filter - can slow things down. - @short Installs widget filter as global X11 event filter. - */ - public native void installX11EventFilter(TQWidget filter); - /** - Removes global X11 event filter previously installed by - installX11EventFilter(). - @short Removes global X11 event filter previously installed by installX11EventFilter(). - */ - public native void removeX11EventFilter(TQWidget filter); - /** - 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. - @param id The message id. See KIPC.Message. - @short Adds a message type to the KIPC event mask. - @see KIPC - @see #removeKipcEventMask - @see #kipcMessage - */ - public native void addKipcEventMask(int id); - /** - Removes a message type from the KIPC event mask. This message will - not be handled anymore. - @param id The message id. - @short Removes a message type from the KIPC event mask. - @see KIPC - @see #addKipcEventMask - @see #kipcMessage - */ - public native void removeKipcEventMask(int id); - /** - Returns the app startup notification identifier for this running - application. - @return the startup notification identifier - - @short Returns the app startup notification identifier for this running application. - */ - public native String startupId(); - /** - Sets a new value for the application startup notification window property for newly - created toplevel windows. - @param startup_id the startup notification identifier - @short - @see KStartupInfo#setNewStartupId - */ - public native void setStartupId(String startup_id); - /** - 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 tdebase/twin/README. - @short Updates the last user action timestamp to the given time, or to the current time, if 0 is given. - */ - public native void updateUserTimestamp(long time); - public native void updateUserTimestamp(); - /** - Returns the last user action timestamp or 0 if no user activity has taken place yet. - @short Returns the last user action timestamp or 0 if no user activity has taken place yet. - @see #updateuserTimestamp - */ - public native long userTimestamp(); - /** - 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 tdebase/twin/README. - @short 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. - */ - public native void updateRemoteUserTimestamp(String dcopId, long time); - public native void updateRemoteUserTimestamp(String dcopId); - /** - Returns the argument to --geometry if any, so the geometry can be set - wherever necessary - @return the geometry argument, or null if there is none - - @short Returns the argument to --geometry if any, so the geometry can be set wherever necessary - */ - public native String geometryArgument(); - /** - Install a Qt SQL property map with entries for all KDE widgets - Call this in any application using KDE widgets in TQSqlForm or TQDataView. - @short Install a Qt SQL property map with entries for all KDE widgets Call this in any application using KDE widgets in TQSqlForm or TQDataView. - */ - public native void installKDEPropertyMap(); - /** - Returns whether a certain action is authorized - @param genericAction The name of a generic action - @return true if the action is authorized - - @short Returns whether a certain action is authorized - */ - public native boolean authorize(String genericAction); - /** - Returns whether a certain KAction is authorized. - @param action The name of a KAction action. The name is prepended - with "action/" before being passed to authorize() - @return true if the KAction is authorized - - @short Returns whether a certain KAction is authorized. - */ - public native boolean authorizeKAction(String action); - /** - Returns whether a certain URL related action is authorized. - @param 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) - @param baseURL The url where the action originates from - @param destURL The object of the action - @return true when the action is authorized, false otherwise. - - @short Returns whether a certain URL related action is authorized. - */ - public native boolean authorizeURLAction(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. - @param action The name of the action. - @param _baseURL The url where the action originates from - @param _destURL The object of the action - @short Allow a certain URL action. - */ - public native void allowURLAction(String action, KURL _baseURL, KURL _destURL); - /** - Returns whether access to a certain control module is authorized. - @param menuId identifying the control module, e.g. tde-mouse.desktop - @return true if access to the module is authorized, false otherwise. - - @short Returns whether access to a certain control module is authorized. - */ - public native boolean authorizeControlModule(String menuId); - /** - Returns whether access to a certain control modules is authorized. - @param menuIds list of menu-ids of control module, - an example of a menu-id is tde-mouse.desktop. - @return Those control modules for which access has been authorized. - - @short Returns whether access to a certain control modules is authorized. - */ - public native ArrayList authorizeControlModules(String[] menuIds); - /** - @short - */ - public native boolean notify(TQObject receiver, TQEvent event); - /** - @short - */ - // int xErrhandler(Display* arg1,void* arg2); >>>> NOT CONVERTED - /** - @short - */ - // int xioErrhandler(Display* arg1); >>>> NOT CONVERTED - /** - @short - */ - // void iceIOErrorHandler(_IceConn* arg1); >>>> NOT CONVERTED - /** - 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 ). - @param url The destination address - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @short Invokes the standard browser. - */ - public native void invokeBrowser(String url, String startup_id); - /** - Invoke the standard browser. Uses a startup_id of "" (empty) - and is otherwise the same as the above function. - @short Invoke the standard browser. - */ - public native void invokeBrowser(String url); - /** - 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() );
    -		 
    - @short If the widget with focus provides a cut() slot, call that slot. - */ - public native void cut(); - /** - 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() );
    -		 
    - @short If the widget with focus provides a copy() slot, call that slot. - */ - public native void copy(); - /** - 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() );
    -		 
    - @short If the widget with focus provides a paste() slot, call that slot. - */ - public native void paste(); - /** - 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( TQWidget  parent = 0, String  name = 0, WFlags f = 0 ) {}
    -		   
    -		 public    void clear() {}
    -		 }
    -		 
    - @short If the widget with focus provides a clear() slot, call that slot. - */ - public native void clear(); - /** - 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() );
    -		 
    - @short If the widget with focus provides a selectAll() slot, call that slot. - */ - public native void selectAll(); - /** - Tells TDEApplication 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). - @short Tells TDEApplication about one more operation that should be finished before the application exits. - */ - public native void ref(); - /** - Tells TDEApplication that one operation such as those described in ref() just finished. - The application exits if the counter is back to 0. - @short Tells TDEApplication that one operation such as those described in ref() just finished. - */ - public native void deref(); - /** - Add Qt and KDE command line options to KCmdLineArgs. - @short Add Qt and KDE command line options to KCmdLineArgs. - */ - public static native void addCmdLineOptions(); - /** - Returns the current application object. - This is similar to the global TQApplication pointer tqApp. It - allows access to the single global TDEApplication 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. - @return the current application object - - @short Returns the current application object. - */ - public static native TDEApplication kApplication(); - /** - Returns a pointer to a DCOPClient for the application. - If a client does not exist yet, it is created when this - function is called. - @return the DCOPClient for the application - - @short Returns a pointer to a DCOPClient for the application. - */ - public static native DCOPClient dcopClient(); - /** - Disable automatic dcop registration - Must be called before creating a TDEApplication instance to have an effect. - @short Disable automatic dcop registration Must be called before creating a TDEApplication instance to have an effect. - */ - public static native void disableAutoDcopRegistration(); - /** - Returns the DCOP name of the service launcher. This will be something like - klaucher_$host_$uid. - @return the name of the service launcher - - @short Returns the DCOP name of the service launcher. - */ - public static native String launcher(); - /** - Starts a service based on the (translated) name of the service. - E.g. "Web Browser" - @param _name the name of the service - @param URL if not empty this URL is passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the (translated) name of the service. - */ - public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByName(String _name, String URL, StringBuffer error); - public static native int startServiceByName(String _name, String URL); - /** - Starts a service based on the (translated) name of the service. - E.g. "Web Browser" - @param _name the name of the service - @param URLs if not empty these URLs will be passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the (translated) name of the service. - */ - public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByName(String _name, String[] URLs, StringBuffer error); - public static native int startServiceByName(String _name, String[] URLs); - public static native int startServiceByName(String _name); - /** - Starts a service based on the desktop path of the service. - E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" - @param _name the path of the desktop file - @param URL if not empty this URL is passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the desktop path of the service. - */ - public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error); - public static native int startServiceByDesktopPath(String _name, String URL); - /** - Starts a service based on the desktop path of the service. - E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" - @param _name the path of the desktop file - @param URLs if not empty these URLs will be passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the desktop path of the service. - */ - public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error); - public static native int startServiceByDesktopPath(String _name, String[] URLs); - public static native int startServiceByDesktopPath(String _name); - /** - Starts a service based on the desktop name of the service. - E.g. "konqueror" - @param _name the desktop name of the service - @param URL if not empty this URL is passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the desktop name of the service. - */ - public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error); - public static native int startServiceByDesktopName(String _name, String URL); - /** - Starts a service based on the desktop name of the service. - E.g. "konqueror" - @param _name the desktop name of the service - @param URLs if not empty these URLs will be passed to the service - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param 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 - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @param noWait if set, the function does not wait till the service is running. - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a service based on the desktop name of the service. - */ - public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); - public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); - public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); - public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); - public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error); - public static native int startServiceByDesktopName(String _name, String[] URLs); - public static native int startServiceByDesktopName(String _name); - /** - Starts a program via tdeinit. - program name and arguments are converted to according to the - local encoding and passed as is to tdeinit. - @param name Name of the program to start - @param args Arguments to pass to the program - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a program via tdeinit. - */ - public static native int tdeinitExec(String name, String[] args, StringBuffer error, int[] pid, String startup_id); - public static native int tdeinitExec(String name, String[] args, StringBuffer error, int[] pid); - public static native int tdeinitExec(String name, String[] args, StringBuffer error); - public static native int tdeinitExec(String name, String[] args); - public static native int tdeinitExec(String name); - /** - Starts a program via tdeinit and wait for it to finish. - Like tdeinitExec(), but it waits till the program is finished. - As such it behaves similar to the system(...) function. - @param name Name of the program to start - @param args Arguments to pass to the program - @param error On failure, error contains a description of the error - that occurred. If the pointer is 0, the argument will be - ignored - @param pid On success, the process id of the new service will be written - here. If the pointer is 0, the argument will be ignored. - @param startup_id for app startup notification, "0" for none, - "" ( empty string ) is the default - @return an error code indicating success (== 0) or failure (> 0). - - @short Starts a program via tdeinit and wait for it to finish. - */ - public static native int tdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid, String startup_id); - public static native int tdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid); - public static native int tdeinitExecWait(String name, String[] args, StringBuffer error); - public static native int tdeinitExecWait(String name, String[] args); - public static native int tdeinitExecWait(String name); - /** - Generates a uniform random number. - @return A truly unpredictable number in the range [0, RAND_MAX) - - @short Generates a uniform random number. - */ - public static native int random(); - /** - Generates a random string. It operates in the range [A-Za-z0-9] - @param length Generate a string of this length. - @return the random string - - @short Generates a random string. - */ - public static native String randomString(int length); - /** - Returns the state of the currently pressed keyboard modifiers (e.g. shift, control, etc.) - and mouse buttons, similarly to TQKeyEvent.state() and TQMouseEvent.state(). - You usually should simply use the information provided by TQKeyEvent and TQMouseEvent, - 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). - @return the keyboard modifiers and mouse buttons state - - @short Returns the state of the currently pressed keyboard modifiers (e. - */ - public static native int keyboardMouseState(); - /** - @short - */ - public static native void startKdeinit(); - /** - Used to obtain the TQPalette 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. - @return the TQPalette - - @short Used to obtain the TQPalette that will be used to set the application palette. - */ - public static native TQPalette createApplicationPalette(); - /** - Raw access for use by TDM. - @short - */ - public static native TQPalette createApplicationPalette(KConfig config, int contrast); - /** - 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 TDEApplication - instance. - @short Installs a handler for the SIGPIPE signal. - */ - public static native void installSigpipeHandler(); - /** - Whether widgets can be used. - @short - */ - public static native boolean guiEnabled(); - /** - @short - */ - public TDEApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance) { - super((Class) null); - newTDEApplication(allowStyles,GUIenabled,_instance); - } - private native void newTDEApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance); - /** - 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. - @param slot is the slot as returned using the SLOT() macro, for example SLOT("cut()") - This method can be used in TDEApplication subclasses to implement application wide - edit actions not supported by the TDEApplication 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() );
    -		 
    - @short 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. - @see #cut - @see #copy - @see #paste - @see #clear - @see #selectAll - */ - protected native void invokeEditSlot(String slot); - /** Deletes the wrapped C++ instance */ - protected native void finalize() throws InternalError; - /** Delete the wrapped C++ instance ahead of finalize() */ - public native void dispose(); - /** Has the wrapped C++ instance been deleted? */ - public native boolean isDisposed(); - /** - Returns the application standard dirs object. - @return The KStandardDirs of the application. - - @short Returns the application standard dirs object. - */ - public native KStandardDirs dirs(); - /** - Returns the general config object ("appnamerc"). - @return the KConfig object for the instance. - - @short Returns the general config object ("appnamerc"). - */ - public native KConfig config(); - /** - Returns the general config object ("appnamerc"). - @return the KConfig object for the instance. - - @short Returns the general config object ("appnamerc"). - */ - public native KSharedConfig sharedConfig(); - /** - Returns an iconloader object. - @return the iconloader object. - - @short Returns an iconloader object. - */ - public native KIconLoader iconLoader(); - /** - Re-allocate the global iconloader. - @short Re-allocate the global iconloader. - */ - public native void newIconLoader(); - /** - Returns the about data of this instance - Warning, can be null - @return the about data of the instance, or 0 if it has - not been set yet - - @short Returns the about data of this instance Warning, can be 0L - */ - public native KAboutData aboutData(); - /** - Returns the name of the instance - @return the instance name, can be null if the KInstance has been - created with a null name - - @short Returns the name of the instance - */ - public native String instanceName(); - /** - Returns the KMimeSourceFactory of the instance. - Mainly added for API completeness and future extensibility. - @return the KMimeSourceFactory set as default for this application. - - @short Returns the KMimeSourceFactory of the instance. - */ - public native KMimeSourceFactory mimeSourceFactory(); - /** - Set name of default config file. - @param name the name of the default config file - @short Set name of default config file. - */ - protected native void setConfigName(String name); - /** - Used internally by the KDE Koala Java bindings runtime - */ - public static native void setJavaSlotFactory(); - -} diff --git a/kdejava/koala/org/kde/koala/KApplicationSignals.java b/kdejava/koala/org/kde/koala/KApplicationSignals.java deleted file mode 100644 index 2e2c276b..00000000 --- a/kdejava/koala/org/kde/koala/KApplicationSignals.java +++ /dev/null @@ -1,116 +0,0 @@ -//Auto-generated by kalyptus. DO NOT EDIT. -package org.kde.koala; - -import org.kde.qt.TQMetaObject; -import org.kde.qt.QtSupport; -import org.kde.qt.TQObject; -import org.kde.qt.TQPixmap; -import org.kde.qt.TQSessionManager; -import java.util.ArrayList; -import org.kde.qt.TQEvent; -import org.kde.qt.TQWidget; -import org.kde.qt.TQPalette; - -public interface TDEApplicationSignals { - /** - Emitted when TDEApplication has changed its palette due to a KControl request. - Normally, widgets will update their palette automatically, but you - should connect to this to program special behavior. - @short Emitted when TDEApplication has changed its palette due to a KControl request. - */ - void kdisplayPaletteChanged(); - /** - Emitted when TDEApplication has changed its GUI style in response to a KControl request. - Normally, widgets will update their styles automatically (as they would - respond to an explicit setGUIStyle() call), but you should connect to - this to program special behavior. - @short Emitted when TDEApplication has changed its GUI style in response to a KControl request. - */ - void kdisplayStyleChanged(); - /** - Emitted when TDEApplication has changed its font in response to a KControl request. - Normally widgets will update their fonts automatically, but you should - connect to this to monitor global font changes, especially if you are - using explicit fonts. - Note: If you derive from a TQWidget-based class, a faster method is to - reimplement TQWidget.fontChange(). This is the preferred way - to get informed about font updates. - @short Emitted when TDEApplication has changed its font in response to a KControl request. - */ - void kdisplayFontChanged(); - /** - Emitted when TDEApplication has changed either its GUI style, its font or its palette - in response to a kdisplay request. Normally, widgets will update their styles - automatically, but you should connect to this to program special - behavior. @short Emitted when TDEApplication has changed either its GUI style, its font or its palette in response to a kdisplay request. - */ - void appearanceChanged(); - /** - Emitted when the settings for toolbars have been changed. KToolBar will know what to do. - @short Emitted when the settings for toolbars have been changed. - */ - void toolbarAppearanceChanged(int arg1); - /** - Emitted when the desktop background has been changed by kcmdisplay. - @param desk The desktop whose background has changed. - @short Emitted when the desktop background has been changed by kcmdisplay. - */ - void backgroundChanged(int desk); - /** - Emitted when the global settings have been changed - see KGlobalSettings - TDEApplication takes care of calling reparseConfiguration on KGlobal.config() - so that applications/classes using this only have to re-read the configuration - @param category the category among the enum above - @short Emitted when the global settings have been changed - see KGlobalSettings TDEApplication takes care of calling reparseConfiguration on KGlobal.config() so that applications/classes using this only have to re-read the configuration - */ - void settingsChanged(int category); - /** - Emitted when the global icon settings have been changed. - @param group the new group - @short Emitted when the global icon settings have been changed. - */ - void iconChanged(int group); - /** - Emitted when a KIPC user message has been received. - @param id the message id - @param data the data - @short Emitted when a KIPC user message has been received. - @see KIPC - @see KIPC#Message - @see #addKipcEventMask - @see #removeKipcEventMask - */ - void kipcMessage(int id, int data); - /** - Session management asks you to save the state of your application. - This signal is provided for compatibility only. For new - applications, simply use KMainWindow. By reimplementing - KMainWindow.queryClose(), KMainWindow.saveProperties() and - KMainWindow.readProperties() you can simply handle session - management for applications with multiple toplevel windows. - For purposes without KMainWindow, create an instance of - KSessionManaged and reimplement the functions - KSessionManaged.commitData() and/or - KSessionManaged.saveState() - If you still want to use this signal, here is what you should do: - Connect to this signal in order to save your data. Do NOT - manipulate the UI in that slot, it is blocked by the session - manager. - Use the sessionConfig() KConfig object to store all your - instance specific data. - Do not do any closing at this point! The user may still select - Cancel wanting to continue working with your - application. Cleanups could be done after shutDown() (see - the following). - @short Session management asks you to save the state of your application. - */ - void saveYourself(); - /** Your application is killed. Either by your program itself, - xkill or (the usual case) by KDE's logout. - The signal is particularly useful if your application has to do some - last-second cleanups. Note that no user interaction is possible at - this state. - @short Your application is killed. - */ - void shutDown(); -} diff --git a/kdejava/koala/org/kde/koala/KCmdLineArgs.java b/kdejava/koala/org/kde/koala/KCmdLineArgs.java deleted file mode 100644 index 3bba5437..00000000 --- a/kdejava/koala/org/kde/koala/KCmdLineArgs.java +++ /dev/null @@ -1,478 +0,0 @@ -//Auto-generated by kalyptus. DO NOT EDIT. -package org.kde.koala; - -import org.kde.qt.Qt; -import org.kde.qt.QtSupport; -import org.kde.qt.TQDataStream; -import java.util.ArrayList; - -/** - - KCmdLineArgs provides simple access to the command-line arguments - for an application. It takes into account Qt-specific options, - KDE-specific options and application specific options. - This class is used in %main() via the static method - init(). - A typical %KDE application using %KCmdLineArgs should look like this: -
    -  int main(String[] args)
    -  {
    -     // Initialize command line args
    -     KCmdLineArgs.init(args, appName, programName, description, version);
    -     // Tell which options are supported
    -     KCmdLineArgs.addCmdLineOptions( options );
    -     // Add options from other components
    -     KUniqueApplication.addCmdLineOptions();
    -     ....
    -     // Create application object without passing 'argc' and 'argv' again.
    -     KUniqueApplication app;
    -     ....
    -     // Handle our own options/arguments
    -     // A TDEApplication will usually do this in main but this is not
    -     // necessary.
    -     // A KUniqueApplication might want to handle it in newInstance().
    -     KCmdLineArgs args = KCmdLineArgs.parsedArgs();
    -     // A binary option (on / off)
    -     if (args.isSet("some-option"))
    -        ....
    -     // An option which takes an additional argument
    -     String anotherOptionArg = args.getOption("another-option");
    -     // Arguments (e.g. files to open)
    -     for(int i = 0; i < args.count(); i++) // Counting start at 0!
    -     {
    -        // don't forget to convert to Unicode!
    -        openFile( TQFile.decodeName( args.arg(i)));
    -        // Or more convenient:
    -        // openURL( args.url(i));
    -     }
    -     args.clear(); // Free up some memory.
    -     ....
    -  }
    -  
    - The options that an application supports are configured using the - String[][] class. An example is shown below: -
    -  static String[][] options =
    -  {
    -     { "a", I18N_NOOP("A short binary option"), 0 },
    -     { "b \", I18N_NOOP("A short option which takes an argument"), 0 },
    -     { "c \", I18N_NOOP("As above but with a default value"), "9600" },
    -     { "option1", I18N_NOOP("A long binary option, off by default"), 0 },
    -     { "nooption2", I18N_NOOP("A long binary option, on by default"), 0 },
    -     { ":", I18N_NOOP("Extra options:"), 0 },
    -     { "option3 \", I18N_NOOP("A long option which takes an argument"), 0 },
    -     { "option4 \", I18N_NOOP("A long option which takes an argument, defaulting to 9600"), "9600" },
    -     { "d", 0, 0 },
    -     { "option5", I18N_NOOP("A long option which has a short option as alias"), 0 },
    -     { "e", 0, 0 },
    -     { "nooption6", I18N_NOOP("Another long option with an alias"), 0 },
    -     { "f", 0, 0 },
    -     { "option7 \", I18N_NOOP("'--option7 speed' is the same as '-f speed'"), 0 },
    -     { "!option8 \", I18N_NOOP("All options following this one will be treated as arguments"), 0 },
    -     { "+file", I18N_NOOP("A required argument 'file'"), 0 },
    -     { "+[arg1]", I18N_NOOP("An optional argument 'arg1'"), 0 },
    -     { "!+command", I18N_NOOP("A required argument 'command', that can contain multiple words, even starting with '-'"), 0 },
    -     { "", I18N_NOOP("Additional help text not associated with any particular option") 0 },
    -      // End of options.
    -  }
    -  
    - The I18N_NOOP macro is used to indicate that these strings should be - marked for translation. The actual translation is done by KCmdLineArgs. - You can't use i18n() here because we are setting up a static data - structure and can't do translations at compile time. - Note that a program should define the options before any arguments. - When a long option has a short option as an alias, a program should - only test for the long option. - With the above options a command line could look like: -
    -     myapp -a -c 4800 --display localhost:0.0 --nooption5 -d /tmp/file
    -  
    - Long binary options can be in the form 'option' and 'nooption'. - A command line may contain the same binary option multiple times, - the last option determines the outcome: -
    -     myapp --nooption4 --option4 --nooption4
    -  
    - is the same as: -
    -     myapp --nooption4
    -  
    - If an option value is provided multiple times, normally only the last - value is used: -
    -     myapp -c 1200 -c 2400 -c 4800
    -  
    - is usually the same as: -
    -     myapp -c 4800
    -  
    - However, an application can choose to use all values specified as well. - As an example of this, consider that you may wish to specify a - number of directories to use: -
    -     myapp -I /usr/include -I /opt/kde/include -I /usr/X11/include
    -  
    - When an application does this it should mention this in the description - of the option. To access these options, use getOptionList() - Tips for end-users: - -
  • - Single char options like "-a -b -c" may be combined into "-abc" -
  • - -
  • - The option "--foo bar" may also be written "--foo=bar" -
  • - -
  • - The option "-P lp1" may also be written "-P=lp1" or "-Plp1" -
  • - -
  • - The option "--foo bar" may also be written "-foo bar" -
  • - @author Waldo Bastian - - @version 0.0.4 - - @short A class for command-line argument handling. - -*/ -public class KCmdLineArgs implements QtSupport { - private long _qt; - private boolean _allocatedInJavaWorld = true; - protected KCmdLineArgs(Class dummy){} - - /** - Read out a string option. - The option must have a corresponding String[][] entry - of the form: -
    -		    { "option \", I18N_NOOP("Description"), "default" }
    -		  
    - You cannot test for the presence of an alias - you must always - test for the full option. - @param option The name of the option without '-'. - @return The value of the option. If the option was not - present on the command line the default is returned. - If the option was present more than the value of the - last occurrence is used. - - @short Read out a string option. - */ - public native String getOption(String option); - /** - Read out all occurrences of a string option. - The option must have a corresponding String[][] entry - of the form: -
    -		    { "option \", I18N_NOOP("Description"), "default" }
    -		  
    - You cannot test for the presence of an alias - you must always - test for the full option. - @param option The name of the option, without '-' or '-no'. - @return A list of all option values. If no option was present - on the command line, an empty list is returned. - - @short Read out all occurrences of a string option. - */ - public native ArrayList getOptionList(String option); - /** - Read out a booleanean option or check for the presence of string option. - @param option The name of the option without '-' or '-no'. - @return The value of the option. It will be true if the option - was specifically turned on in the command line, or if the option - is turned on by default (in the String[][] list) and was - not specifically turned off in the command line. Equivalently, - it will be false if the option was specifically turned off in - the command line, or if the option is turned off by default (in - the KCmdLineOptions list) and was not specifically turned on in - the command line. - - @short Read out a boolean option or check for the presence of string option. - */ - public native boolean isSet(String option); - /** - Read the number of arguments that aren't options (but, - for example, filenames). - @return The number of arguments that aren't options - - @short Read the number of arguments that aren't options (but, for example, filenames). - */ - public native int count(); - /** - Read out an argument. - @param n The argument to read. 0 is the first argument. - count()-1 is the last argument. - @return A const char * pointer to the n'th argument. - - @short Read out an argument. - */ - public native String arg(int n); - /** - Read out an argument representing a URL. - The argument can be - -
  • - an absolute filename -
  • - -
  • - a relative filename -
  • - -
  • - a URL -
  • - @param n The argument to read. 0 is the first argument. - count()-1 is the last argument. - @return a URL representing the n'th argument. - - @short Read out an argument representing a URL. - */ - public native KURL url(int n); - /** - Clear all options and arguments. - @short Clear all options and arguments. - */ - public native void clear(); - /** - Initialize class. - This function should be called as the very first thing in - your application. - @param _argv As passed to main(...). - @param _appname The untranslated name of your application. This should - match with argv[0]. - @param programName A program name string to be used for display - purposes. This string should be marked for - translation. Example: I18N_NOOP("KEdit") - @param _description A short description of what your application is about. - @param _version A version. - @param noKApp Set this true to not add commandline options for - TQApplication / TDEApplication - @short Initialize class. - */ - public static native void init(String[] _argv, String _appname, String programName, String _description, String _version, boolean noKApp); - public static native void init(String[] _argv, String _appname, String programName, String _description, String _version); - /** - Initialize class. - This function should be called as the very first thing in - your application. It uses KAboutData to replace some of the - arguments that would otherwise be required. - @param _argv As passed to main(...). - @param about A KAboutData object describing your program. - @param noKApp Set this true to not add commandline options for - TQApplication / TDEApplication - @short Initialize class. - */ - public static native void init(String[] _argv, KAboutData about, boolean noKApp); - public static native void init(String[] _argv, KAboutData about); - /** - Initialize Class - This function should be called as the very first thing in your - application. This method will rarely be used, since it doesn't - provide any argument parsing. It does provide access to the - KAboutData information. - This method is exactly the same as calling - init(0,0, const KAboutData about, true). - @param about the about data. - \see KAboutData - @short Initialize Class - */ - public static native void init(KAboutData about); - /** - Add options to your application. - You must make sure that all possible options have been added before - any class uses the command line arguments. - The list of options should look like this: -
    -		 static String[][] options =
    -		 {
    -		    { "option1 \", I18N_NOOP("Description 1"), "my_extra_arg" },
    -		    { "o", 0, 0 },
    -		    { "option2", I18N_NOOP("Description 2"), 0 },
    -		    { "nooption3", I18N_NOOP("Description 3"), 0 },
    -		    
    -		 }
    -		 
    - -
  • - "option1" is an option that requires an additional argument, - but if one is not provided, it uses "my_extra_arg". -
  • - -
  • - "option2" is an option that can be turned on. The default is off. -
  • - -
  • - "option3" is an option that can be turned off. The default is on. -
  • - -
  • - "o" does not have a description. It is an alias for the option - that follows. In this case "option2". -
  • - -
  • - "+file" specifies an argument. The '+' is removed. If your program - doesn't specify that it can use arguments your program will abort - when an argument is passed to it. Note that the reverse is not - true. If required, you must check yourself the number of arguments - specified by the user: -
    -			       KCmdLineArgs args = KCmdLineArgs.parsedArgs();
    -			       if (args.count() == 0) KCmdLineArgs.usage(i18n("No file specified!"));
    -			     
    -
  • - In BNF: -
    -		 cmd = myapp [options] file
    -		 options = (option)
    -		 option = --option1 \ |
    -		          (-o | --option2 | --nooption2) |
    -		          ( --option3 | --nooption3 )
    -		 
    - Instead of "--option3" one may also use "-option3" - Usage examples: - -
  • - "myapp --option1 test" -
  • - -
  • - "myapp" (same as "myapp --option1 my_extra_arg") -
  • - -
  • - "myapp --option2" -
  • - -
  • - "myapp --nooption2" (same as "myapp", since it is off by default) -
  • - -
  • - "myapp -o" (same as "myapp --option2") -
  • - -
  • - "myapp --nooption3" -
  • - -
  • - "myapp --option3 (same as "myapp", since it is on by default) -
  • - -
  • - "myapp --option2 --nooption2" (same as "myapp", because it - option2 is off by default, and the last usage applies) -
  • - -
  • - "myapp /tmp/file" -
  • - @param options A list of options that your code supplies. - @param name the name of the option, can be 0. - @param id A name with which these options can be identified, can be 0. - @param afterId The options are inserted after this set of options, can be 0. - @short Add options to your application. - */ - public static native void addCmdLineOptions(String[][] options, String name, String id, String afterId); - public static native void addCmdLineOptions(String[][] options, String name, String id); - public static native void addCmdLineOptions(String[][] options, String name); - public static native void addCmdLineOptions(String[][] options); - /** - Access parsed arguments. - This function returns all command line arguments that your code - handles. If unknown command-line arguments are encountered the program - is aborted and usage information is shown. - @param id The name of the options you are interested in, can be 0. - @short Access parsed arguments. - */ - public static native KCmdLineArgs parsedArgs(String id); - public static native KCmdLineArgs parsedArgs(); - /** - Get the CWD (Current Working Directory) associated with the - current command line arguments. - Typically this is needed in KUniqueApplication.newInstance() - since the CWD of the process may be different from the CWD - where the user started a second instance. - @return the current working directory - - @short Get the CWD (Current Working Directory) associated with the current command line arguments. - */ - public static native String cwd(); - /** - Get the appname according to argv[0]. - @return the name of the application - - @short Get the appname according to argv[0]. - */ - public static native String appName(); - /** - Print the usage help to stdout and exit. - @param id if 0, print all options. If id is set, only print the - option specified by id. The id is the value set by - addCmdLineOptions(). - @short Print the usage help to stdout and exit. - */ - public static native void usage(String id); - public static native void usage(); - /** - Enable i18n to be able to print a translated error message. - N.B.: This function leaks memory, therefore you are expected to exit - afterwards (e.g., by calling usage()). - @short Enable i18n to be able to print a translated error message. - */ - public static native void enable_i18n(); - /** - Used by url(). - Made public for apps that don't use KCmdLineArgs - @param urlArg the argument - @return the url. - - @short Used by url(). - */ - public static native KURL makeURL(String urlArg); - /** - Made public for apps that don't use KCmdLineArgs - To be done before makeURL, to set the current working - directory in case makeURL needs it. - @param cwd the new working directory - @short Made public for apps that don't use KCmdLineArgs To be done before makeURL, to set the current working directory in case makeURL needs it. - */ - public static native void setCwd(String cwd); - /** - Reset all option definitions, i.e. cancel all addCmdLineOptions calls. - Note that TDEApplication's options are removed too, you might want to - call TDEApplication.addCmdLineOptions if you want them back. - You usually don't want to call this method. - @short Reset all option definitions, i. - */ - public static native void reset(); - /** - Load arguments from a stream. - @short Load arguments from a stream. - */ - public static native void loadAppArgs(TQDataStream arg1); - /** - Add standard option --tempfile - @short Add standard option --tempfile - */ - public static native void addTempFileOption(); - /** - @return true if --tempfile was set - - @short - */ - public static native boolean isTempFileSet(); - /** - Constructor. - @short - */ - public KCmdLineArgs(String[][] _options, String _name, String _id) { - newKCmdLineArgs(_options,_name,_id); - } - private native void newKCmdLineArgs(String[][] _options, String _name, String _id); -} diff --git a/kdejava/koala/org/kde/koala/TDEApplication.java b/kdejava/koala/org/kde/koala/TDEApplication.java new file mode 100644 index 00000000..e8f7194e --- /dev/null +++ b/kdejava/koala/org/kde/koala/TDEApplication.java @@ -0,0 +1,1088 @@ +//Auto-generated by kalyptus. DO NOT EDIT. +package org.kde.koala; + +import org.kde.qt.Qt; +import org.kde.qt.TQMetaObject; +import org.kde.qt.QtSupport; +import org.kde.qt.TQObject; +import org.kde.qt.TQPixmap; +import org.kde.qt.TQSessionManager; +import java.util.ArrayList; +import org.kde.qt.TQEvent; +import org.kde.qt.TQWidget; +import org.kde.qt.TQPalette; +import org.kde.qt.TQApplication; + +/** + + 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 TQApplication ). +
  • + +
  • + 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 TDEApplication'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 TDEApplication'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 {@link TDEApplicationSignals} for signals emitted by TDEApplication + @author Matthias Kalle Dalheimer + + @short Controls and provides information to all KDE applications. + +*/ +public class TDEApplication extends TQApplication implements KInstanceInterface { + protected TDEApplication(Class dummy){super((Class) null);} + public static final int ShiftModifier = 1<<0; + public static final int LockModifier = 1<<1; + public static final int ControlModifier = 1<<2; + public static final int Modifier1 = 1<<3; + public static final int Modifier2 = 1<<4; + public static final int Modifier3 = 1<<5; + public static final int Modifier4 = 1<<6; + public static final int Modifier5 = 1<<7; + + /** @deprecated Same values as Button1Mask etc. in X.h @short @deprecated Same values as Button1Mask etc. + */ + public static final int Button1Pressed = 1<<8; + public static final int Button2Pressed = 1<<9; + public static final int Button3Pressed = 1<<10; + public static final int Button4Pressed = 1<<11; + public static final int Button5Pressed = 1<<12; + + /** Position of the caption (presumably in the application window's + title bar). This enum appears to be unused. + @todo Find out if this is used anywhere. + @short Position of the caption (presumably in the application window's title bar). + */ + public static final int CaptionAppLast = 1; + public static final int CaptionAppFirst = 2; + public static final int CaptionNoApp = 3; + + /** + The possible values for the confirm parameter of requestShutDown(). + @short The possible values for the confirm parameter of requestShutDown(). + */ + public static final int ShutdownConfirmDefault = -1; + public static final int ShutdownConfirmNo = 0; + public static final int ShutdownConfirmYes = 1; + + /** + The possible values for the sdtype parameter of requestShutDown(). + @short The possible values for the sdtype parameter of requestShutDown(). + */ + public static final int ShutdownTypeDefault = -1; + public static final int ShutdownTypeNone = 0; + public static final int ShutdownTypeReboot = 1; + public static final int ShutdownTypeHalt = 2; + + /** + The possible values for the sdmode parameter of requestShutDown(). + @short The possible values for the sdmode parameter of requestShutDown(). + */ + public static final int ShutdownModeDefault = -1; + public static final int ShutdownModeSchedule = 0; + public static final int ShutdownModeTryNow = 1; + public static final int ShutdownModeForceNow = 2; + public static final int ShutdownModeInteractive = 3; + + /** + Valid values for the settingsChanged signal + @short Valid values for the settingsChanged signal + */ + public static final int SETTINGS_MOUSE = 0; + public static final int SETTINGS_COMPLETION = 1; + public static final int SETTINGS_PATHS = 2; + public static final int SETTINGS_POPUPMENU = 3; + public static final int SETTINGS_QT = 4; + public static final int SETTINGS_SHORTCUTS = 5; + + public native TQMetaObject metaObject(); + public native String className(); + /** + This constructor takes aboutData and command line + arguments from KCmdLineArgs. + @param 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. + @param GUIenabled Set to false to disable all GUI stuff. This implies + no styles either. + @short This constructor takes aboutData and command line arguments from KCmdLineArgs. + */ + public TDEApplication(boolean allowStyles, boolean GUIenabled) { + super((Class) null); + newTDEApplication(allowStyles,GUIenabled); + } + private native void newTDEApplication(boolean allowStyles, boolean GUIenabled); + public TDEApplication(boolean allowStyles) { + super((Class) null); + newTDEApplication(allowStyles); + } + private native void newTDEApplication(boolean allowStyles); + public TDEApplication() { + super((Class) null); + newTDEApplication(); + } + private native void newTDEApplication(); + /** + Returns the application session config object. + @return A pointer to the application's instance specific + KConfig object. + + @short Returns the application session config object. + @see KConfig + */ + public native KConfig sessionConfig(); + /** + Is the application restored from the session manager? + @return 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. + + @short Is the application restored from the session manager? + @see #sessionConfig + */ + public native boolean isRestored(); + /** + Disables session management for this application. + Useful in case your application is started by the + initial "starttde" script. + @short Disables session management for this application. + */ + public native void disableSessionManagement(); + /** + 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. + @short Enables again session management for this application, formerly disabled by calling disableSessionManagement(). + */ + public native void enableSessionManagement(); + /** + 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. + @param confirm Whether to ask the user if he really wants to log out. + ShutdownConfirm + @param sdtype The action to take after logging out. ShutdownType + @param sdmode If/When the action should be taken. ShutdownMode + @return true on success, false if the session manager could not be + contacted. + + @short Asks the session manager to shut the session down. + */ + public native boolean requestShutDown(int confirm, int sdtype, int sdmode); + public native boolean requestShutDown(int confirm, int sdtype); + public native boolean requestShutDown(int confirm); + public native boolean requestShutDown(); + /** + 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. + @short Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up. + */ + public native void propagateSessionManager(); + /** + Reimplemented for internal purposes, mainly the highlevel + handling of session management with KSessionManaged. + @short Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged. + */ + public native void commitData(TQSessionManager sm); + /** + Reimplemented for internal purposes, mainly the highlevel + handling of session management with KSessionManaged. + @short Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManaged. + */ + public native void saveState(TQSessionManager sm); + /** + 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(). + @short Returns true if the application is currently saving its session data (most probably before KDE logout). + @see KMainWindow#queryClose + @see KMainWindow#queryExit + */ + public native boolean sessionSaving(); + /** + Returns a TQPixmap with the application icon. + @return the application icon + + @short Returns a TQPixmap with the application icon. + */ + public native TQPixmap icon(); + /** + Returns the name of the application icon. + @return the icon's name + + @short Returns the name of the application icon. + */ + public native String iconName(); + /** + Returns the mini-icon for the application as a TQPixmap. + @return the application's mini icon + + @short Returns the mini-icon for the application as a TQPixmap. + */ + public native TQPixmap miniIcon(); + /** + Returns the name of the mini-icon for the application. + @return the mini icon's name + + @short Returns the name of the mini-icon for the application. + */ + public native String miniIconName(); + /** + 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. + @param topWidget A top widget of the application. + @short Sets the top widget of the application. + @see #icon + @see #caption + */ + public native void setTopWidget(TQWidget topWidget); + /** + Invokes the KHelpCenter HTML help viewer from docbook sources. + @param anchor This has to be a defined anchor in your + docbook sources. If empty the main index + is loaded + @param appname This allows you to show the help of another + application. If empty the current name() is + used + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @short Invokes the KHelpCenter HTML help viewer from docbook sources. + */ + public native void invokeHelp(String anchor, String appname, String startup_id); + public native void invokeHelp(String anchor, String appname); + public native void invokeHelp(String anchor); + public native void invokeHelp(); + /** + Convenience method; invokes the standard email application. + @param address The destination address + @param subject Subject string. Can be null. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @short Convenience method; invokes the standard email application. + */ + public native void invokeMailer(String address, String subject, String startup_id); + public native void invokeMailer(String address, String subject); + /** + Invokes the standard email application. + @param mailtoURL A mailto URL. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param allowAttachments whether attachments specified in mailtoURL should be honoured. + The default is false; do not honour requests for attachments. + @short Invokes the standard email application. + */ + public native void invokeMailer(KURL mailtoURL, String startup_id, boolean allowAttachments); + public native void invokeMailer(KURL mailtoURL, String startup_id); + public native void invokeMailer(KURL mailtoURL); + /** + Convenience method; invokes the standard email application. + All parameters are optional. + @param to The destination address. + @param cc The Cc field + @param bcc The Bcc field + @param subject Subject string + @param body A string containing the body of the mail (exclusive with messageFile) + @param messageFile A file (URL) containing the body of the mail (exclusive with body) - currently unsupported + @param attachURLs List of URLs to be attached to the mail. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @short Convenience method; invokes the standard email application. + */ + public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs, String startup_id); + public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile, String[] attachURLs); + public native void invokeMailer(String to, String cc, String bcc, String subject, String body, String messageFile); + public native void invokeMailer(String to, String cc, String bcc, String subject, String body); + /** + Returns a text for the window caption. + This may be set by + "-caption", otherwise it will be equivalent to the name of the + executable. + @return the text for the window caption + + @short Returns a text for the window caption. + */ + public native String caption(); + /** + 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)); + @param userCaption The caption string you want to display in the + window caption area. Do not include the application name! + @param 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. + @param 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. + @return the created caption + + @short Builds a caption that contains the application name along with the userCaption using a standard layout. + */ + public native String makeStdCaption(String userCaption, boolean withAppName, boolean modified); + public native String makeStdCaption(String userCaption, boolean withAppName); + public native String makeStdCaption(String userCaption); + /** + Get a file name in order to make a temporary copy of your document. + @param pFilename The full path to the current file of your + document. + @return A new filename for auto-saving. + + @short Get a file name in order to make a temporary copy of your document. + */ + public native String tempSaveName(String pFilename); + /** + Check whether an auto-save file exists for the document you want to + open. + @param pFilename The full path to the document you want to open. + @param bRecover This gets set to true if there was a recover + file. + @return The full path of the file to open. + + @short Check whether an auto-save file exists for the document you want to open. + */ + public native String checkRecoverFile(String pFilename, boolean bRecover); + /** + Enables style plugins. + This is useful only to applications that normally + do not display a GUI and create the TDEApplication with + allowStyles set to false. + @short Enables style plugins. + */ + public native void enableStyles(); + /** + Disables style plugins. + Current style plugins do not get unloaded. + This is only useful when used in combination with enableStyles(). + @short Disables style plugins. + */ + public native void disableStyles(); + /** + Installs widget filter as global X11 event filter. + The widget + filter receives XEvents in its standard TQWidget.x11Event() function. + Warning: Only do this when absolutely necessary. An installed X11 filter + can slow things down. + @short Installs widget filter as global X11 event filter. + */ + public native void installX11EventFilter(TQWidget filter); + /** + Removes global X11 event filter previously installed by + installX11EventFilter(). + @short Removes global X11 event filter previously installed by installX11EventFilter(). + */ + public native void removeX11EventFilter(TQWidget filter); + /** + 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. + @param id The message id. See KIPC.Message. + @short Adds a message type to the KIPC event mask. + @see KIPC + @see #removeKipcEventMask + @see #kipcMessage + */ + public native void addKipcEventMask(int id); + /** + Removes a message type from the KIPC event mask. This message will + not be handled anymore. + @param id The message id. + @short Removes a message type from the KIPC event mask. + @see KIPC + @see #addKipcEventMask + @see #kipcMessage + */ + public native void removeKipcEventMask(int id); + /** + Returns the app startup notification identifier for this running + application. + @return the startup notification identifier + + @short Returns the app startup notification identifier for this running application. + */ + public native String startupId(); + /** + Sets a new value for the application startup notification window property for newly + created toplevel windows. + @param startup_id the startup notification identifier + @short + @see KStartupInfo#setNewStartupId + */ + public native void setStartupId(String startup_id); + /** + 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 tdebase/twin/README. + @short Updates the last user action timestamp to the given time, or to the current time, if 0 is given. + */ + public native void updateUserTimestamp(long time); + public native void updateUserTimestamp(); + /** + Returns the last user action timestamp or 0 if no user activity has taken place yet. + @short Returns the last user action timestamp or 0 if no user activity has taken place yet. + @see #updateuserTimestamp + */ + public native long userTimestamp(); + /** + 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 tdebase/twin/README. + @short 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. + */ + public native void updateRemoteUserTimestamp(String dcopId, long time); + public native void updateRemoteUserTimestamp(String dcopId); + /** + Returns the argument to --geometry if any, so the geometry can be set + wherever necessary + @return the geometry argument, or null if there is none + + @short Returns the argument to --geometry if any, so the geometry can be set wherever necessary + */ + public native String geometryArgument(); + /** + Install a Qt SQL property map with entries for all KDE widgets + Call this in any application using KDE widgets in TQSqlForm or TQDataView. + @short Install a Qt SQL property map with entries for all KDE widgets Call this in any application using KDE widgets in TQSqlForm or TQDataView. + */ + public native void installKDEPropertyMap(); + /** + Returns whether a certain action is authorized + @param genericAction The name of a generic action + @return true if the action is authorized + + @short Returns whether a certain action is authorized + */ + public native boolean authorize(String genericAction); + /** + Returns whether a certain KAction is authorized. + @param action The name of a KAction action. The name is prepended + with "action/" before being passed to authorize() + @return true if the KAction is authorized + + @short Returns whether a certain KAction is authorized. + */ + public native boolean authorizeKAction(String action); + /** + Returns whether a certain URL related action is authorized. + @param 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) + @param baseURL The url where the action originates from + @param destURL The object of the action + @return true when the action is authorized, false otherwise. + + @short Returns whether a certain URL related action is authorized. + */ + public native boolean authorizeURLAction(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. + @param action The name of the action. + @param _baseURL The url where the action originates from + @param _destURL The object of the action + @short Allow a certain URL action. + */ + public native void allowURLAction(String action, KURL _baseURL, KURL _destURL); + /** + Returns whether access to a certain control module is authorized. + @param menuId identifying the control module, e.g. tde-mouse.desktop + @return true if access to the module is authorized, false otherwise. + + @short Returns whether access to a certain control module is authorized. + */ + public native boolean authorizeControlModule(String menuId); + /** + Returns whether access to a certain control modules is authorized. + @param menuIds list of menu-ids of control module, + an example of a menu-id is tde-mouse.desktop. + @return Those control modules for which access has been authorized. + + @short Returns whether access to a certain control modules is authorized. + */ + public native ArrayList authorizeControlModules(String[] menuIds); + /** + @short + */ + public native boolean notify(TQObject receiver, TQEvent event); + /** + @short + */ + // int xErrhandler(Display* arg1,void* arg2); >>>> NOT CONVERTED + /** + @short + */ + // int xioErrhandler(Display* arg1); >>>> NOT CONVERTED + /** + @short + */ + // void iceIOErrorHandler(_IceConn* arg1); >>>> NOT CONVERTED + /** + 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 ). + @param url The destination address + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @short Invokes the standard browser. + */ + public native void invokeBrowser(String url, String startup_id); + /** + Invoke the standard browser. Uses a startup_id of "" (empty) + and is otherwise the same as the above function. + @short Invoke the standard browser. + */ + public native void invokeBrowser(String url); + /** + 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() );
    +		 
    + @short If the widget with focus provides a cut() slot, call that slot. + */ + public native void cut(); + /** + 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() );
    +		 
    + @short If the widget with focus provides a copy() slot, call that slot. + */ + public native void copy(); + /** + 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() );
    +		 
    + @short If the widget with focus provides a paste() slot, call that slot. + */ + public native void paste(); + /** + 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( TQWidget  parent = 0, String  name = 0, WFlags f = 0 ) {}
    +		   
    +		 public    void clear() {}
    +		 }
    +		 
    + @short If the widget with focus provides a clear() slot, call that slot. + */ + public native void clear(); + /** + 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() );
    +		 
    + @short If the widget with focus provides a selectAll() slot, call that slot. + */ + public native void selectAll(); + /** + Tells TDEApplication 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). + @short Tells TDEApplication about one more operation that should be finished before the application exits. + */ + public native void ref(); + /** + Tells TDEApplication that one operation such as those described in ref() just finished. + The application exits if the counter is back to 0. + @short Tells TDEApplication that one operation such as those described in ref() just finished. + */ + public native void deref(); + /** + Add Qt and KDE command line options to KCmdLineArgs. + @short Add Qt and KDE command line options to KCmdLineArgs. + */ + public static native void addCmdLineOptions(); + /** + Returns the current application object. + This is similar to the global TQApplication pointer tqApp. It + allows access to the single global TDEApplication 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. + @return the current application object + + @short Returns the current application object. + */ + public static native TDEApplication kApplication(); + /** + Returns a pointer to a DCOPClient for the application. + If a client does not exist yet, it is created when this + function is called. + @return the DCOPClient for the application + + @short Returns a pointer to a DCOPClient for the application. + */ + public static native DCOPClient dcopClient(); + /** + Disable automatic dcop registration + Must be called before creating a TDEApplication instance to have an effect. + @short Disable automatic dcop registration Must be called before creating a TDEApplication instance to have an effect. + */ + public static native void disableAutoDcopRegistration(); + /** + Returns the DCOP name of the service launcher. This will be something like + klaucher_$host_$uid. + @return the name of the service launcher + + @short Returns the DCOP name of the service launcher. + */ + public static native String launcher(); + /** + Starts a service based on the (translated) name of the service. + E.g. "Web Browser" + @param _name the name of the service + @param URL if not empty this URL is passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the (translated) name of the service. + */ + public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByName(String _name, String URL, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByName(String _name, String URL, StringBuffer error); + public static native int startServiceByName(String _name, String URL); + /** + Starts a service based on the (translated) name of the service. + E.g. "Web Browser" + @param _name the name of the service + @param URLs if not empty these URLs will be passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the (translated) name of the service. + */ + public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByName(String _name, String[] URLs, StringBuffer error); + public static native int startServiceByName(String _name, String[] URLs); + public static native int startServiceByName(String _name); + /** + Starts a service based on the desktop path of the service. + E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" + @param _name the path of the desktop file + @param URL if not empty this URL is passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the desktop path of the service. + */ + public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByDesktopPath(String _name, String URL, StringBuffer error); + public static native int startServiceByDesktopPath(String _name, String URL); + /** + Starts a service based on the desktop path of the service. + E.g. "Applications/konqueror.desktop" or "/home/user/bla/myfile.desktop" + @param _name the path of the desktop file + @param URLs if not empty these URLs will be passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the desktop path of the service. + */ + public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByDesktopPath(String _name, String[] URLs, StringBuffer error); + public static native int startServiceByDesktopPath(String _name, String[] URLs); + public static native int startServiceByDesktopPath(String _name); + /** + Starts a service based on the desktop name of the service. + E.g. "konqueror" + @param _name the desktop name of the service + @param URL if not empty this URL is passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the desktop name of the service. + */ + public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByDesktopName(String _name, String URL, StringBuffer error); + public static native int startServiceByDesktopName(String _name, String URL); + /** + Starts a service based on the desktop name of the service. + E.g. "konqueror" + @param _name the desktop name of the service + @param URLs if not empty these URLs will be passed to the service + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param 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 + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @param noWait if set, the function does not wait till the service is running. + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a service based on the desktop name of the service. + */ + public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id, boolean noWait); + public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid, String startup_id); + public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService, int[] pid); + public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error, StringBuffer dcopService); + public static native int startServiceByDesktopName(String _name, String[] URLs, StringBuffer error); + public static native int startServiceByDesktopName(String _name, String[] URLs); + public static native int startServiceByDesktopName(String _name); + /** + Starts a program via tdeinit. + program name and arguments are converted to according to the + local encoding and passed as is to tdeinit. + @param name Name of the program to start + @param args Arguments to pass to the program + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a program via tdeinit. + */ + public static native int tdeinitExec(String name, String[] args, StringBuffer error, int[] pid, String startup_id); + public static native int tdeinitExec(String name, String[] args, StringBuffer error, int[] pid); + public static native int tdeinitExec(String name, String[] args, StringBuffer error); + public static native int tdeinitExec(String name, String[] args); + public static native int tdeinitExec(String name); + /** + Starts a program via tdeinit and wait for it to finish. + Like tdeinitExec(), but it waits till the program is finished. + As such it behaves similar to the system(...) function. + @param name Name of the program to start + @param args Arguments to pass to the program + @param error On failure, error contains a description of the error + that occurred. If the pointer is 0, the argument will be + ignored + @param pid On success, the process id of the new service will be written + here. If the pointer is 0, the argument will be ignored. + @param startup_id for app startup notification, "0" for none, + "" ( empty string ) is the default + @return an error code indicating success (== 0) or failure (> 0). + + @short Starts a program via tdeinit and wait for it to finish. + */ + public static native int tdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid, String startup_id); + public static native int tdeinitExecWait(String name, String[] args, StringBuffer error, int[] pid); + public static native int tdeinitExecWait(String name, String[] args, StringBuffer error); + public static native int tdeinitExecWait(String name, String[] args); + public static native int tdeinitExecWait(String name); + /** + Generates a uniform random number. + @return A truly unpredictable number in the range [0, RAND_MAX) + + @short Generates a uniform random number. + */ + public static native int random(); + /** + Generates a random string. It operates in the range [A-Za-z0-9] + @param length Generate a string of this length. + @return the random string + + @short Generates a random string. + */ + public static native String randomString(int length); + /** + Returns the state of the currently pressed keyboard modifiers (e.g. shift, control, etc.) + and mouse buttons, similarly to TQKeyEvent.state() and TQMouseEvent.state(). + You usually should simply use the information provided by TQKeyEvent and TQMouseEvent, + 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). + @return the keyboard modifiers and mouse buttons state + + @short Returns the state of the currently pressed keyboard modifiers (e. + */ + public static native int keyboardMouseState(); + /** + @short + */ + public static native void startKdeinit(); + /** + Used to obtain the TQPalette 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. + @return the TQPalette + + @short Used to obtain the TQPalette that will be used to set the application palette. + */ + public static native TQPalette createApplicationPalette(); + /** + Raw access for use by TDM. + @short + */ + public static native TQPalette createApplicationPalette(KConfig config, int contrast); + /** + 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 TDEApplication + instance. + @short Installs a handler for the SIGPIPE signal. + */ + public static native void installSigpipeHandler(); + /** + Whether widgets can be used. + @short + */ + public static native boolean guiEnabled(); + /** + @short + */ + public TDEApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance) { + super((Class) null); + newTDEApplication(allowStyles,GUIenabled,_instance); + } + private native void newTDEApplication(boolean allowStyles, boolean GUIenabled, KInstanceInterface _instance); + /** + 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. + @param slot is the slot as returned using the SLOT() macro, for example SLOT("cut()") + This method can be used in TDEApplication subclasses to implement application wide + edit actions not supported by the TDEApplication 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() );
    +		 
    + @short 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. + @see #cut + @see #copy + @see #paste + @see #clear + @see #selectAll + */ + protected native void invokeEditSlot(String slot); + /** Deletes the wrapped C++ instance */ + protected native void finalize() throws InternalError; + /** Delete the wrapped C++ instance ahead of finalize() */ + public native void dispose(); + /** Has the wrapped C++ instance been deleted? */ + public native boolean isDisposed(); + /** + Returns the application standard dirs object. + @return The KStandardDirs of the application. + + @short Returns the application standard dirs object. + */ + public native KStandardDirs dirs(); + /** + Returns the general config object ("appnamerc"). + @return the KConfig object for the instance. + + @short Returns the general config object ("appnamerc"). + */ + public native KConfig config(); + /** + Returns the general config object ("appnamerc"). + @return the KConfig object for the instance. + + @short Returns the general config object ("appnamerc"). + */ + public native KSharedConfig sharedConfig(); + /** + Returns an iconloader object. + @return the iconloader object. + + @short Returns an iconloader object. + */ + public native KIconLoader iconLoader(); + /** + Re-allocate the global iconloader. + @short Re-allocate the global iconloader. + */ + public native void newIconLoader(); + /** + Returns the about data of this instance + Warning, can be null + @return the about data of the instance, or 0 if it has + not been set yet + + @short Returns the about data of this instance Warning, can be 0L + */ + public native KAboutData aboutData(); + /** + Returns the name of the instance + @return the instance name, can be null if the KInstance has been + created with a null name + + @short Returns the name of the instance + */ + public native String instanceName(); + /** + Returns the KMimeSourceFactory of the instance. + Mainly added for API completeness and future extensibility. + @return the KMimeSourceFactory set as default for this application. + + @short Returns the KMimeSourceFactory of the instance. + */ + public native KMimeSourceFactory mimeSourceFactory(); + /** + Set name of default config file. + @param name the name of the default config file + @short Set name of default config file. + */ + protected native void setConfigName(String name); + /** + Used internally by the KDE Koala Java bindings runtime + */ + public static native void setJavaSlotFactory(); + +} diff --git a/kdejava/koala/org/kde/koala/TDEApplicationSignals.java b/kdejava/koala/org/kde/koala/TDEApplicationSignals.java new file mode 100644 index 00000000..2e2c276b --- /dev/null +++ b/kdejava/koala/org/kde/koala/TDEApplicationSignals.java @@ -0,0 +1,116 @@ +//Auto-generated by kalyptus. DO NOT EDIT. +package org.kde.koala; + +import org.kde.qt.TQMetaObject; +import org.kde.qt.QtSupport; +import org.kde.qt.TQObject; +import org.kde.qt.TQPixmap; +import org.kde.qt.TQSessionManager; +import java.util.ArrayList; +import org.kde.qt.TQEvent; +import org.kde.qt.TQWidget; +import org.kde.qt.TQPalette; + +public interface TDEApplicationSignals { + /** + Emitted when TDEApplication has changed its palette due to a KControl request. + Normally, widgets will update their palette automatically, but you + should connect to this to program special behavior. + @short Emitted when TDEApplication has changed its palette due to a KControl request. + */ + void kdisplayPaletteChanged(); + /** + Emitted when TDEApplication has changed its GUI style in response to a KControl request. + Normally, widgets will update their styles automatically (as they would + respond to an explicit setGUIStyle() call), but you should connect to + this to program special behavior. + @short Emitted when TDEApplication has changed its GUI style in response to a KControl request. + */ + void kdisplayStyleChanged(); + /** + Emitted when TDEApplication has changed its font in response to a KControl request. + Normally widgets will update their fonts automatically, but you should + connect to this to monitor global font changes, especially if you are + using explicit fonts. + Note: If you derive from a TQWidget-based class, a faster method is to + reimplement TQWidget.fontChange(). This is the preferred way + to get informed about font updates. + @short Emitted when TDEApplication has changed its font in response to a KControl request. + */ + void kdisplayFontChanged(); + /** + Emitted when TDEApplication has changed either its GUI style, its font or its palette + in response to a kdisplay request. Normally, widgets will update their styles + automatically, but you should connect to this to program special + behavior. @short Emitted when TDEApplication has changed either its GUI style, its font or its palette in response to a kdisplay request. + */ + void appearanceChanged(); + /** + Emitted when the settings for toolbars have been changed. KToolBar will know what to do. + @short Emitted when the settings for toolbars have been changed. + */ + void toolbarAppearanceChanged(int arg1); + /** + Emitted when the desktop background has been changed by kcmdisplay. + @param desk The desktop whose background has changed. + @short Emitted when the desktop background has been changed by kcmdisplay. + */ + void backgroundChanged(int desk); + /** + Emitted when the global settings have been changed - see KGlobalSettings + TDEApplication takes care of calling reparseConfiguration on KGlobal.config() + so that applications/classes using this only have to re-read the configuration + @param category the category among the enum above + @short Emitted when the global settings have been changed - see KGlobalSettings TDEApplication takes care of calling reparseConfiguration on KGlobal.config() so that applications/classes using this only have to re-read the configuration + */ + void settingsChanged(int category); + /** + Emitted when the global icon settings have been changed. + @param group the new group + @short Emitted when the global icon settings have been changed. + */ + void iconChanged(int group); + /** + Emitted when a KIPC user message has been received. + @param id the message id + @param data the data + @short Emitted when a KIPC user message has been received. + @see KIPC + @see KIPC#Message + @see #addKipcEventMask + @see #removeKipcEventMask + */ + void kipcMessage(int id, int data); + /** + Session management asks you to save the state of your application. + This signal is provided for compatibility only. For new + applications, simply use KMainWindow. By reimplementing + KMainWindow.queryClose(), KMainWindow.saveProperties() and + KMainWindow.readProperties() you can simply handle session + management for applications with multiple toplevel windows. + For purposes without KMainWindow, create an instance of + KSessionManaged and reimplement the functions + KSessionManaged.commitData() and/or + KSessionManaged.saveState() + If you still want to use this signal, here is what you should do: + Connect to this signal in order to save your data. Do NOT + manipulate the UI in that slot, it is blocked by the session + manager. + Use the sessionConfig() KConfig object to store all your + instance specific data. + Do not do any closing at this point! The user may still select + Cancel wanting to continue working with your + application. Cleanups could be done after shutDown() (see + the following). + @short Session management asks you to save the state of your application. + */ + void saveYourself(); + /** Your application is killed. Either by your program itself, + xkill or (the usual case) by KDE's logout. + The signal is particularly useful if your application has to do some + last-second cleanups. Note that no user interaction is possible at + this state. + @short Your application is killed. + */ + void shutDown(); +} diff --git a/kdejava/koala/org/kde/koala/TDECmdLineArgs.java b/kdejava/koala/org/kde/koala/TDECmdLineArgs.java new file mode 100644 index 00000000..3bba5437 --- /dev/null +++ b/kdejava/koala/org/kde/koala/TDECmdLineArgs.java @@ -0,0 +1,478 @@ +//Auto-generated by kalyptus. DO NOT EDIT. +package org.kde.koala; + +import org.kde.qt.Qt; +import org.kde.qt.QtSupport; +import org.kde.qt.TQDataStream; +import java.util.ArrayList; + +/** + + KCmdLineArgs provides simple access to the command-line arguments + for an application. It takes into account Qt-specific options, + KDE-specific options and application specific options. + This class is used in %main() via the static method + init(). + A typical %KDE application using %KCmdLineArgs should look like this: +
    +  int main(String[] args)
    +  {
    +     // Initialize command line args
    +     KCmdLineArgs.init(args, appName, programName, description, version);
    +     // Tell which options are supported
    +     KCmdLineArgs.addCmdLineOptions( options );
    +     // Add options from other components
    +     KUniqueApplication.addCmdLineOptions();
    +     ....
    +     // Create application object without passing 'argc' and 'argv' again.
    +     KUniqueApplication app;
    +     ....
    +     // Handle our own options/arguments
    +     // A TDEApplication will usually do this in main but this is not
    +     // necessary.
    +     // A KUniqueApplication might want to handle it in newInstance().
    +     KCmdLineArgs args = KCmdLineArgs.parsedArgs();
    +     // A binary option (on / off)
    +     if (args.isSet("some-option"))
    +        ....
    +     // An option which takes an additional argument
    +     String anotherOptionArg = args.getOption("another-option");
    +     // Arguments (e.g. files to open)
    +     for(int i = 0; i < args.count(); i++) // Counting start at 0!
    +     {
    +        // don't forget to convert to Unicode!
    +        openFile( TQFile.decodeName( args.arg(i)));
    +        // Or more convenient:
    +        // openURL( args.url(i));
    +     }
    +     args.clear(); // Free up some memory.
    +     ....
    +  }
    +  
    + The options that an application supports are configured using the + String[][] class. An example is shown below: +
    +  static String[][] options =
    +  {
    +     { "a", I18N_NOOP("A short binary option"), 0 },
    +     { "b \", I18N_NOOP("A short option which takes an argument"), 0 },
    +     { "c \", I18N_NOOP("As above but with a default value"), "9600" },
    +     { "option1", I18N_NOOP("A long binary option, off by default"), 0 },
    +     { "nooption2", I18N_NOOP("A long binary option, on by default"), 0 },
    +     { ":", I18N_NOOP("Extra options:"), 0 },
    +     { "option3 \", I18N_NOOP("A long option which takes an argument"), 0 },
    +     { "option4 \", I18N_NOOP("A long option which takes an argument, defaulting to 9600"), "9600" },
    +     { "d", 0, 0 },
    +     { "option5", I18N_NOOP("A long option which has a short option as alias"), 0 },
    +     { "e", 0, 0 },
    +     { "nooption6", I18N_NOOP("Another long option with an alias"), 0 },
    +     { "f", 0, 0 },
    +     { "option7 \", I18N_NOOP("'--option7 speed' is the same as '-f speed'"), 0 },
    +     { "!option8 \", I18N_NOOP("All options following this one will be treated as arguments"), 0 },
    +     { "+file", I18N_NOOP("A required argument 'file'"), 0 },
    +     { "+[arg1]", I18N_NOOP("An optional argument 'arg1'"), 0 },
    +     { "!+command", I18N_NOOP("A required argument 'command', that can contain multiple words, even starting with '-'"), 0 },
    +     { "", I18N_NOOP("Additional help text not associated with any particular option") 0 },
    +      // End of options.
    +  }
    +  
    + The I18N_NOOP macro is used to indicate that these strings should be + marked for translation. The actual translation is done by KCmdLineArgs. + You can't use i18n() here because we are setting up a static data + structure and can't do translations at compile time. + Note that a program should define the options before any arguments. + When a long option has a short option as an alias, a program should + only test for the long option. + With the above options a command line could look like: +
    +     myapp -a -c 4800 --display localhost:0.0 --nooption5 -d /tmp/file
    +  
    + Long binary options can be in the form 'option' and 'nooption'. + A command line may contain the same binary option multiple times, + the last option determines the outcome: +
    +     myapp --nooption4 --option4 --nooption4
    +  
    + is the same as: +
    +     myapp --nooption4
    +  
    + If an option value is provided multiple times, normally only the last + value is used: +
    +     myapp -c 1200 -c 2400 -c 4800
    +  
    + is usually the same as: +
    +     myapp -c 4800
    +  
    + However, an application can choose to use all values specified as well. + As an example of this, consider that you may wish to specify a + number of directories to use: +
    +     myapp -I /usr/include -I /opt/kde/include -I /usr/X11/include
    +  
    + When an application does this it should mention this in the description + of the option. To access these options, use getOptionList() + Tips for end-users: + +
  • + Single char options like "-a -b -c" may be combined into "-abc" +
  • + +
  • + The option "--foo bar" may also be written "--foo=bar" +
  • + +
  • + The option "-P lp1" may also be written "-P=lp1" or "-Plp1" +
  • + +
  • + The option "--foo bar" may also be written "-foo bar" +
  • + @author Waldo Bastian + + @version 0.0.4 + + @short A class for command-line argument handling. + +*/ +public class KCmdLineArgs implements QtSupport { + private long _qt; + private boolean _allocatedInJavaWorld = true; + protected KCmdLineArgs(Class dummy){} + + /** + Read out a string option. + The option must have a corresponding String[][] entry + of the form: +
    +		    { "option \", I18N_NOOP("Description"), "default" }
    +		  
    + You cannot test for the presence of an alias - you must always + test for the full option. + @param option The name of the option without '-'. + @return The value of the option. If the option was not + present on the command line the default is returned. + If the option was present more than the value of the + last occurrence is used. + + @short Read out a string option. + */ + public native String getOption(String option); + /** + Read out all occurrences of a string option. + The option must have a corresponding String[][] entry + of the form: +
    +		    { "option \", I18N_NOOP("Description"), "default" }
    +		  
    + You cannot test for the presence of an alias - you must always + test for the full option. + @param option The name of the option, without '-' or '-no'. + @return A list of all option values. If no option was present + on the command line, an empty list is returned. + + @short Read out all occurrences of a string option. + */ + public native ArrayList getOptionList(String option); + /** + Read out a booleanean option or check for the presence of string option. + @param option The name of the option without '-' or '-no'. + @return The value of the option. It will be true if the option + was specifically turned on in the command line, or if the option + is turned on by default (in the String[][] list) and was + not specifically turned off in the command line. Equivalently, + it will be false if the option was specifically turned off in + the command line, or if the option is turned off by default (in + the KCmdLineOptions list) and was not specifically turned on in + the command line. + + @short Read out a boolean option or check for the presence of string option. + */ + public native boolean isSet(String option); + /** + Read the number of arguments that aren't options (but, + for example, filenames). + @return The number of arguments that aren't options + + @short Read the number of arguments that aren't options (but, for example, filenames). + */ + public native int count(); + /** + Read out an argument. + @param n The argument to read. 0 is the first argument. + count()-1 is the last argument. + @return A const char * pointer to the n'th argument. + + @short Read out an argument. + */ + public native String arg(int n); + /** + Read out an argument representing a URL. + The argument can be + +
  • + an absolute filename +
  • + +
  • + a relative filename +
  • + +
  • + a URL +
  • + @param n The argument to read. 0 is the first argument. + count()-1 is the last argument. + @return a URL representing the n'th argument. + + @short Read out an argument representing a URL. + */ + public native KURL url(int n); + /** + Clear all options and arguments. + @short Clear all options and arguments. + */ + public native void clear(); + /** + Initialize class. + This function should be called as the very first thing in + your application. + @param _argv As passed to main(...). + @param _appname The untranslated name of your application. This should + match with argv[0]. + @param programName A program name string to be used for display + purposes. This string should be marked for + translation. Example: I18N_NOOP("KEdit") + @param _description A short description of what your application is about. + @param _version A version. + @param noKApp Set this true to not add commandline options for + TQApplication / TDEApplication + @short Initialize class. + */ + public static native void init(String[] _argv, String _appname, String programName, String _description, String _version, boolean noKApp); + public static native void init(String[] _argv, String _appname, String programName, String _description, String _version); + /** + Initialize class. + This function should be called as the very first thing in + your application. It uses KAboutData to replace some of the + arguments that would otherwise be required. + @param _argv As passed to main(...). + @param about A KAboutData object describing your program. + @param noKApp Set this true to not add commandline options for + TQApplication / TDEApplication + @short Initialize class. + */ + public static native void init(String[] _argv, KAboutData about, boolean noKApp); + public static native void init(String[] _argv, KAboutData about); + /** + Initialize Class + This function should be called as the very first thing in your + application. This method will rarely be used, since it doesn't + provide any argument parsing. It does provide access to the + KAboutData information. + This method is exactly the same as calling + init(0,0, const KAboutData about, true). + @param about the about data. + \see KAboutData + @short Initialize Class + */ + public static native void init(KAboutData about); + /** + Add options to your application. + You must make sure that all possible options have been added before + any class uses the command line arguments. + The list of options should look like this: +
    +		 static String[][] options =
    +		 {
    +		    { "option1 \", I18N_NOOP("Description 1"), "my_extra_arg" },
    +		    { "o", 0, 0 },
    +		    { "option2", I18N_NOOP("Description 2"), 0 },
    +		    { "nooption3", I18N_NOOP("Description 3"), 0 },
    +		    
    +		 }
    +		 
    + +
  • + "option1" is an option that requires an additional argument, + but if one is not provided, it uses "my_extra_arg". +
  • + +
  • + "option2" is an option that can be turned on. The default is off. +
  • + +
  • + "option3" is an option that can be turned off. The default is on. +
  • + +
  • + "o" does not have a description. It is an alias for the option + that follows. In this case "option2". +
  • + +
  • + "+file" specifies an argument. The '+' is removed. If your program + doesn't specify that it can use arguments your program will abort + when an argument is passed to it. Note that the reverse is not + true. If required, you must check yourself the number of arguments + specified by the user: +
    +			       KCmdLineArgs args = KCmdLineArgs.parsedArgs();
    +			       if (args.count() == 0) KCmdLineArgs.usage(i18n("No file specified!"));
    +			     
    +
  • + In BNF: +
    +		 cmd = myapp [options] file
    +		 options = (option)
    +		 option = --option1 \ |
    +		          (-o | --option2 | --nooption2) |
    +		          ( --option3 | --nooption3 )
    +		 
    + Instead of "--option3" one may also use "-option3" + Usage examples: + +
  • + "myapp --option1 test" +
  • + +
  • + "myapp" (same as "myapp --option1 my_extra_arg") +
  • + +
  • + "myapp --option2" +
  • + +
  • + "myapp --nooption2" (same as "myapp", since it is off by default) +
  • + +
  • + "myapp -o" (same as "myapp --option2") +
  • + +
  • + "myapp --nooption3" +
  • + +
  • + "myapp --option3 (same as "myapp", since it is on by default) +
  • + +
  • + "myapp --option2 --nooption2" (same as "myapp", because it + option2 is off by default, and the last usage applies) +
  • + +
  • + "myapp /tmp/file" +
  • + @param options A list of options that your code supplies. + @param name the name of the option, can be 0. + @param id A name with which these options can be identified, can be 0. + @param afterId The options are inserted after this set of options, can be 0. + @short Add options to your application. + */ + public static native void addCmdLineOptions(String[][] options, String name, String id, String afterId); + public static native void addCmdLineOptions(String[][] options, String name, String id); + public static native void addCmdLineOptions(String[][] options, String name); + public static native void addCmdLineOptions(String[][] options); + /** + Access parsed arguments. + This function returns all command line arguments that your code + handles. If unknown command-line arguments are encountered the program + is aborted and usage information is shown. + @param id The name of the options you are interested in, can be 0. + @short Access parsed arguments. + */ + public static native KCmdLineArgs parsedArgs(String id); + public static native KCmdLineArgs parsedArgs(); + /** + Get the CWD (Current Working Directory) associated with the + current command line arguments. + Typically this is needed in KUniqueApplication.newInstance() + since the CWD of the process may be different from the CWD + where the user started a second instance. + @return the current working directory + + @short Get the CWD (Current Working Directory) associated with the current command line arguments. + */ + public static native String cwd(); + /** + Get the appname according to argv[0]. + @return the name of the application + + @short Get the appname according to argv[0]. + */ + public static native String appName(); + /** + Print the usage help to stdout and exit. + @param id if 0, print all options. If id is set, only print the + option specified by id. The id is the value set by + addCmdLineOptions(). + @short Print the usage help to stdout and exit. + */ + public static native void usage(String id); + public static native void usage(); + /** + Enable i18n to be able to print a translated error message. + N.B.: This function leaks memory, therefore you are expected to exit + afterwards (e.g., by calling usage()). + @short Enable i18n to be able to print a translated error message. + */ + public static native void enable_i18n(); + /** + Used by url(). + Made public for apps that don't use KCmdLineArgs + @param urlArg the argument + @return the url. + + @short Used by url(). + */ + public static native KURL makeURL(String urlArg); + /** + Made public for apps that don't use KCmdLineArgs + To be done before makeURL, to set the current working + directory in case makeURL needs it. + @param cwd the new working directory + @short Made public for apps that don't use KCmdLineArgs To be done before makeURL, to set the current working directory in case makeURL needs it. + */ + public static native void setCwd(String cwd); + /** + Reset all option definitions, i.e. cancel all addCmdLineOptions calls. + Note that TDEApplication's options are removed too, you might want to + call TDEApplication.addCmdLineOptions if you want them back. + You usually don't want to call this method. + @short Reset all option definitions, i. + */ + public static native void reset(); + /** + Load arguments from a stream. + @short Load arguments from a stream. + */ + public static native void loadAppArgs(TQDataStream arg1); + /** + Add standard option --tempfile + @short Add standard option --tempfile + */ + public static native void addTempFileOption(); + /** + @return true if --tempfile was set + + @short + */ + public static native boolean isTempFileSet(); + /** + Constructor. + @short + */ + public KCmdLineArgs(String[][] _options, String _name, String _id) { + newKCmdLineArgs(_options,_name,_id); + } + private native void newKCmdLineArgs(String[][] _options, String _name, String _id); +} -- cgit v1.2.1