org.kde.koala
Class KRun

java.lang.Object
  extended by org.kde.qt.Qt
      extended by org.kde.qt.QObject
          extended by org.kde.koala.KRun
All Implemented Interfaces:
org.kde.qt.QtSupport
Direct Known Subclasses:
BrowserRun

public class KRun
extends org.kde.qt.QObject

To open files with their associated applications in KDE, use KRun. It can execute any desktop entry, as well as any file, using the default application or another application "bound" to the file type (or URL protocol). In that example, the mimetype of the file is not known by the application, so a KRun instance must be created. It will determine the mimetype by itself. If the mimetype is known, or if you even know the service (application) to use for this file, use one of the static methods. By default KRun uses auto deletion. It causes the KRun instance to delete itself when the it finished its task. If you allocate the KRun object on the stack you must disable auto deletion, otherwise it will crash. See KRunSignals for signals emitted by KRun


Field Summary
 
Fields inherited from class org.kde.qt.Qt
AlignAuto, AlignBottom, AlignCenter, AlignHCenter, AlignHorizontal_Mask, AlignJustify, AlignLeft, AlignRight, AlignTop, AlignVCenter, AlignVertical_Mask, AlphaDither_Mask, ALT, AltButton, AnchorHref, AnchorName, AndNotROP, AndROP, ArrowCursor, Ascending, ASCII_ACCEL, AutoColor, AutoDither, AutoText, AvoidDither, BDiagPattern, BeginsWith, BevelJoin, BitmapCursor, BlankCursor, Bottom, BottomLeft, BottomRight, BreakAnywhere, BusyCursor, CaseSensitive, ClearROP, ColorMode_Mask, ColorOnly, Contains, ControlButton, CopyROP, CrossCursor, CrossPattern, CTRL, CustomPattern, DashDotDotLine, DashDotLine, DashLine, Dense1Pattern, Dense2Pattern, Dense3Pattern, Dense4Pattern, Dense5Pattern, Dense6Pattern, Dense7Pattern, Descending, DiagCrossPattern, DiffuseAlphaDither, DiffuseDither, Dither_Mask, DitherMode_Mask, DockBottom, DockLeft, DockMinimized, DockRight, DockTop, DockTornOff, DockUnmanaged, DontClip, DontPrint, DotLine, DownArrow, EndsWith, EraseROP, ExactMatch, ExpandTabs, FDiagPattern, FixedColor, FixedPixmap, FlatCap, ForbiddenCursor, HiEnglishUnit, HiMetricUnit, Horizontal, HorPattern, IbeamCursor, Identical, IncludeTrailingSpaces, ISODate, Key_0, Key_1, Key_2, Key_3, Key_4, Key_5, Key_6, Key_7, Key_8, Key_9, Key_A, Key_aacute, Key_Aacute, Key_acircumflex, Key_Acircumflex, Key_acute, Key_adiaeresis, Key_Adiaeresis, Key_ae, Key_AE, Key_agrave, Key_Agrave, Key_Alt, Key_Ampersand, Key_Any, Key_Apostrophe, Key_aring, Key_Aring, Key_AsciiCircum, Key_AsciiTilde, Key_Asterisk, Key_At, Key_atilde, Key_Atilde, Key_B, Key_Back, Key_Backslash, Key_Backspace, Key_BackSpace, Key_Backtab, Key_BackTab, Key_Bar, Key_BassBoost, Key_BassDown, Key_BassUp, Key_BraceLeft, Key_BraceRight, Key_BracketLeft, Key_BracketRight, Key_brokenbar, Key_C, Key_CapsLock, Key_ccedilla, Key_Ccedilla, Key_cedilla, Key_cent, Key_Clear, Key_Colon, Key_Comma, Key_Control, Key_copyright, Key_currency, Key_D, Key_degree, Key_Delete, Key_diaeresis, Key_Direction_L, Key_Direction_R, Key_division, Key_Dollar, Key_Down, Key_E, Key_eacute, Key_Eacute, Key_ecircumflex, Key_Ecircumflex, Key_ediaeresis, Key_Ediaeresis, Key_egrave, Key_Egrave, Key_End, Key_Enter, Key_Equal, Key_Escape, Key_eth, Key_ETH, Key_Exclam, Key_exclamdown, Key_F, Key_F1, Key_F10, Key_F11, Key_F12, Key_F13, Key_F14, Key_F15, Key_F16, Key_F17, Key_F18, Key_F19, Key_F2, Key_F20, Key_F21, Key_F22, Key_F23, Key_F24, Key_F25, Key_F26, Key_F27, Key_F28, Key_F29, Key_F3, Key_F30, Key_F31, Key_F32, Key_F33, Key_F34, Key_F35, Key_F4, Key_F5, Key_F6, Key_F7, Key_F8, Key_F9, Key_Favorites, Key_Forward, Key_G, Key_Greater, Key_guillemotleft, Key_guillemotright, Key_H, Key_Help, Key_Home, Key_HomePage, Key_Hyper_L, Key_Hyper_R, Key_hyphen, Key_I, Key_iacute, Key_Iacute, Key_icircumflex, Key_Icircumflex, Key_idiaeresis, Key_Idiaeresis, Key_igrave, Key_Igrave, Key_Insert, Key_J, Key_K, Key_L, Key_Launch0, Key_Launch1, Key_Launch2, Key_Launch3, Key_Launch4, Key_Launch5, Key_Launch6, Key_Launch7, Key_Launch8, Key_Launch9, Key_LaunchA, Key_LaunchB, Key_LaunchC, Key_LaunchD, Key_LaunchE, Key_LaunchF, Key_LaunchMail, Key_LaunchMedia, Key_Left, Key_Less, Key_M, Key_macron, Key_masculine, Key_MediaLast, Key_MediaNext, Key_MediaPlay, Key_MediaPrev, Key_MediaRecord, Key_MediaStop, Key_Menu, Key_Meta, Key_Minus, Key_mu, Key_multiply, Key_N, Key_Next, Key_nobreakspace, Key_notsign, Key_ntilde, Key_Ntilde, Key_NumberSign, Key_NumLock, Key_O, Key_oacute, Key_Oacute, Key_ocircumflex, Key_Ocircumflex, Key_odiaeresis, Key_Odiaeresis, Key_ograve, Key_Ograve, Key_onehalf, Key_onequarter, Key_onesuperior, Key_Ooblique, Key_OpenUrl, Key_ordfeminine, Key_oslash, Key_otilde, Key_Otilde, Key_P, Key_PageDown, Key_PageUp, Key_paragraph, Key_ParenLeft, Key_ParenRight, Key_Pause, Key_Percent, Key_Period, Key_periodcentered, Key_Plus, Key_plusminus, Key_Print, Key_Prior, Key_Q, Key_Question, Key_questiondown, Key_QuoteDbl, Key_QuoteLeft, Key_R, Key_Refresh, Key_registered, Key_Return, Key_Right, Key_S, Key_ScrollLock, Key_Search, Key_section, Key_Semicolon, Key_Shift, Key_Slash, Key_Space, Key_ssharp, Key_Standby, Key_sterling, Key_Stop, Key_Super_L, Key_Super_R, Key_SysReq, Key_T, Key_Tab, Key_thorn, Key_THORN, Key_threequarters, Key_threesuperior, Key_TrebleDown, Key_TrebleUp, Key_twosuperior, Key_U, Key_uacute, Key_Uacute, Key_ucircumflex, Key_Ucircumflex, Key_udiaeresis, Key_Udiaeresis, Key_ugrave, Key_Ugrave, Key_Underscore, Key_unknown, Key_Up, Key_V, Key_VolumeDown, Key_VolumeMute, Key_VolumeUp, Key_W, Key_X, Key_Y, Key_yacute, Key_Yacute, Key_ydiaeresis, Key_yen, Key_Z, KeyButtonMask, Keypad, LastCursor, LastROP, Left, LeftArrow, LeftButton, LocalDate, LocalTime, LoEnglishUnit, LogText, LoMetricUnit, MacStyle, META, MetaButton, MidButton, Minimized, MiterJoin, MODIFIER_MASK, MonoOnly, MotifStyle, MouseButtonMask, MPenCapStyle, MPenJoinStyle, MPenStyle, MV_10_DOT_0, MV_10_DOT_1, MV_10_DOT_2, MV_10_DOT_3, MV_10_DOT_4, MV_9, MV_CHEETAH, MV_JAGUAR, MV_PANTHER, MV_PUMA, MV_TIGER, MV_Unknown, NandROP, NoAccel, NoAlpha, NoBackground, NoBrush, NoButton, NoMatch, NoPen, NopROP, NorROP, NotAndROP, NotCopyROP, NotEraseROP, NotOrROP, NotROP, NotXorROP, OpaqueMode, OrderedAlphaDither, OrderedDither, OrNotROP, OrROP, Overline, PaletteBackground, PaletteBase, PaletteBrightText, PaletteButton, PaletteButtonText, PaletteDark, PaletteForeground, PaletteHighlight, PaletteHighlightedText, PaletteLight, PaletteLink, PaletteLinkVisited, PaletteMid, PaletteMidlight, PaletteShadow, PaletteText, PartialMatch, PixelUnit, PlainText, PMStyle, PointingHandCursor, PreferDither, RichText, Right, RightArrow, RightButton, RoundCap, RoundJoin, SetROP, SHIFT, ShiftButton, ShowPrefix, SingleLine, SizeAllCursor, SizeBDiagCursor, SizeFDiagCursor, SizeHorCursor, SizeVerCursor, SolidLine, SolidPattern, SplitHCursor, SplitVCursor, SquareCap, StrikeOut, TextDate, ThresholdAlphaDither, ThresholdDither, Top, TopLeft, TopRight, TornOff, TransparentMode, TwipsUnit, UI_AnimateCombo, UI_AnimateMenu, UI_AnimateToolBox, UI_AnimateTooltip, UI_FadeMenu, UI_FadeTooltip, UI_General, Underline, UNICODE_ACCEL, Unmanaged, UpArrow, UpArrowCursor, UTC, VerPattern, Vertical, WaitCursor, WDestructiveClose, WGroupLeader, WhatsThisCursor, Win3Style, WindowActive, WindowFullScreen, WindowMaximized, WindowMinimized, WindowNoState, WindowsStyle, WMacDrawer, WMacNoSheet, WMouseNoMask, WNoAutoErase, WNoMousePropagation, WNorthWestGravity, WordBreak, WPaintClever, WPaintDesktop, WPaintUnclipped, WRepaintNoErase, WResizeNoErase, WShowModal, WState_AutoMask, WState_BlockUpdates, WState_CompressKeys, WState_ConfigPending, WState_Created, WState_CreatedHidden, WState_Disabled, WState_DND, WState_Exposed, WState_ForceDisabled, WState_ForceHide, WState_FullScreen, WState_HasMouse, WState_InPaintEvent, WState_Maximized, WState_Minimized, WState_MouseTracking, WState_OwnCursor, WState_OwnSizePolicy, WState_Polished, WState_Reparented, WState_Reserved0, WState_Resized, WState_Visible, WStaticContents, WStyle_ContextHelp, WStyle_Customize, WStyle_Dialog, WStyle_DialogBorder, WStyle_Mask, WStyle_Maximize, WStyle_Minimize, WStyle_MinMax, WStyle_NoBorder, WStyle_NoBorderEx, WStyle_NormalBorder, WStyle_Reserved, WStyle_Splash, WStyle_StaysOnTop, WStyle_SysMenu, WStyle_Title, WStyle_Tool, WSubWindow, WType_Desktop, WType_Dialog, WType_Mask, WType_Modal, WType_Popup, WType_TopLevel, WV_2000, WV_2003, WV_32s, WV_95, WV_98, WV_CE, WV_CE_based, WV_CENET, WV_DOS_based, WV_Me, WV_NT, WV_NT_based, WV_XP, WWinOwnDC, WX11BypassWM, X11ParentRelative, XorROP
 
Constructor Summary
protected KRun(java.lang.Class dummy)
           
  KRun(KURL url)
           
  KRun(KURL url, long mode)
           
  KRun(KURL url, long mode, boolean isLocalFile)
           
  KRun(KURL url, long mode, boolean isLocalFile, boolean showProgressInfo)
          Create a KRun object to run the preferred application for a file/URL.
  KRun(KURL url, org.kde.qt.QWidget window)
           
  KRun(KURL url, org.kde.qt.QWidget window, long mode)
           
  KRun(KURL url, org.kde.qt.QWidget window, long mode, boolean isLocalFile)
           
  KRun(KURL url, org.kde.qt.QWidget window, long mode, boolean isLocalFile, boolean showProgressInfo)
          BIC: Combine with the above ctor for KDE 4.0.
 
Method Summary
 void abort()
          Abort this KRun.
 boolean autoDelete()
          Checks whether auto delete is activated.
static java.lang.String binaryName(java.lang.String execLine, boolean removePath)
          Given a full command line (e.g.
static boolean checkStartupNotify(java.lang.String binName, KService service, boolean[] silent_arg, java.lang.StringBuffer wmclass_arg)
           
 java.lang.String className()
           
static boolean displayOpenWithDialog(java.util.ArrayList lst)
           
static boolean displayOpenWithDialog(java.util.ArrayList lst, boolean tempFiles)
          Display the Open-With dialog for those URLs, and run the chosen application.
 void dispose()
          Delete the wrapped C++ instance ahead of finalize()
protected  void finalize()
          Deletes the wrapped C++ instance
protected  void foundMimeType(java.lang.String _type)
          Called if the mimetype has been detected.
 boolean hasError()
          Returns true if the KRun instance has an error.
 boolean hasFinished()
          Returns true if the KRun instance has finished.
protected  void init()
           
 boolean isDisposed()
          Has the wrapped C++ instance been deleted?
static boolean isExecutable(java.lang.String serviceType)
          Returns whether serviceType refers to an executable program instead of a data file.
static boolean isExecutableFile(KURL url, java.lang.String mimetype)
          Returns wether the url of mimetype is executable.
protected  void killJob()
           
 org.kde.qt.QMetaObject metaObject()
           
static java.util.ArrayList processDesktopExec(KService _service, java.util.ArrayList _urls, boolean has_shell)
           
static java.util.ArrayList processDesktopExec(KService _service, java.util.ArrayList _urls, boolean has_shell, boolean tempFiles)
          Processes a Exec= line as found in .desktop files.
static int run(KService _service, java.util.ArrayList _urls)
           
static int run(KService _service, java.util.ArrayList _urls, boolean tempFiles)
          Open a list of URLs with a certain service (application).
static int run(java.lang.String _exec, java.util.ArrayList _urls)
           
static int run(java.lang.String _exec, java.util.ArrayList _urls, java.lang.String _name)
           
static int run(java.lang.String _exec, java.util.ArrayList _urls, java.lang.String _name, java.lang.String _icon)
           
static int run(java.lang.String _exec, java.util.ArrayList _urls, java.lang.String _name, java.lang.String _icon, java.lang.String _obsolete1)
           
static int run(java.lang.String _exec, java.util.ArrayList _urls, java.lang.String _name, java.lang.String _icon, java.lang.String _obsolete1, java.lang.String _obsolete2)
          Open a list of URLs with.
static int runCommand(java.lang.String cmd)
          Run the given shell command and notifies kicker of the starting of the application.
static int runCommand(java.lang.String cmd, java.lang.String execName, java.lang.String icon)
          Same as the other runCommand(), but it also takes the name of the binary, to display an error message in case it couldn't find it.
static int runURL(KURL _url, java.lang.String _mimetype)
           
static int runURL(KURL _url, java.lang.String _mimetype, boolean tempFile)
           
static int runURL(KURL _url, java.lang.String _mimetype, boolean tempFile, boolean runExecutables)
          Open the given URL.
protected  void scanFile()
           
 void setAutoDelete(boolean b)
          Enables or disabled auto deletion.
 void setEnableExternalBrowser(boolean b)
          Sets whether the external webbrowser setting should be honoured.
 void setPreferredService(java.lang.String desktopEntryName)
          Set the preferred service for opening this URL, after its mimetype will have been found by KRun.
 void setRunExecutables(boolean b)
          Sets whether executables, .desktop files or shell scripts should be run by KRun.
static void shellQuote(java.lang.StringBuffer _str)
          Quotes a string for the shell.
protected  void slotScanFinished(Job arg1)
           
protected  void slotScanMimeType(Job arg1, java.lang.String type)
           
protected  void slotStatResult(Job arg1)
           
protected  void slotTimeout()
           
 
Methods inherited from class org.kde.qt.QObject
activate_filters, activate_signal_bool, activate_signal, activate_signal, activate_signal, activate_signal, blockSignals, checkConnectArgs, child, child, child, childEvent, children, connect, connect, connectInternal, connectNotify, customEvent, deleteLater, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnectInternal, disconnectNotify, dumpObjectInfo, dumpObjectTree, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, event, eventFilter, highPriority, i18n, inherits, insertChild, installEventFilter, isA, isWidgetType, killTimer, killTimers, name, name, normalizeSignalSlot, objectTrees, parent, property, queryList, queryList, queryList, queryList, queryList, registerUserData, removeChild, removeEventFilter, sender, setName, setProperty, signalsBlocked, startTimer, timerEvent, tr, tr
 
Methods inherited from class org.kde.qt.Qt
arrowCursor, bin, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, black, blankCursor, blue, color0, color1, copyBlt, copyBlt, copyBlt, copyBlt, copyBlt, crossCursor, cyan, darkBlue, darkCyan, darkGray, darkGreen, darkMagenta, darkRed, darkYellow, dec, dynamicCast, endl, flush, forbiddenCursor, fromUtf8, gray, green, hex, ibeamCursor, lightGray, magenta, oct, op_div, op_div, op_div, op_div, op_equals, op_equals, op_equals, op_equals, op_minus, op_minus, op_minus, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_not_equals, op_not_equals, op_not_equals, op_not_equals, op_plus, op_plus, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, pointingHandCursor, qAlpha, qApp, qAppName, qBlue, qCompress, qCompress, qDebug, qDebug, qDrawArrow, qDrawItem, qDrawItem, qDrawItem, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qFatal, qFatal, qGLVersion, qGray, qGray, qGreen, qInitNetworkProtocols, qInstallPath, qInstallPathBins, qInstallPathData, qInstallPathDocs, qInstallPathHeaders, qInstallPathLibs, qInstallPathPlugins, qInstallPathSysconf, qInstallPathTranslations, qItemRect, qItemRect, qObsolete, qObsolete, qObsolete, qRed, qRgb, qRgba, qRound, qSharedBuild, qSuppressObsoleteWarnings, qSuppressObsoleteWarnings, qSysInfo, qSystemWarning, qSystemWarning, qUncompress, qUncompress, qVersion, qWarning, qWarning, red, reset, SIGNAL, sizeAllCursor, sizeBDiagCursor, sizeFDiagCursor, sizeHorCursor, sizeVerCursor, SLOT, splitHCursor, splitVCursor, upArrowCursor, waitCursor, whatsThisCursor, white, ws, yellow
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

KRun

protected KRun(java.lang.Class dummy)

KRun

public KRun(KURL url,
            long mode,
            boolean isLocalFile,
            boolean showProgressInfo)
Create a KRun object to run the preferred application for a file/URL. KRun will first determine the type of the file, and will then run the associated application.

Parameters:
url - the URL of the file or directory to 'run'
mode - The st_mode field of struct stat. If you don't know this set it to 0.
isLocalFile - If this parameter is set to false then url is examined to find out whether it is a local URL or not. This flag is just used to improve speed, since the function KURL.isLocalFile is a bit slow.
showProgressInfo - Whether to show progress information when determining the type of the file (i.e. when using KIO.stat and KIO.mimetype) Before you set this to false to avoid a dialog box, think about a very slow FTP server... It is always better to provide progress info in such cases.

KRun

public KRun(KURL url,
            long mode,
            boolean isLocalFile)

KRun

public KRun(KURL url,
            long mode)

KRun

public KRun(KURL url)

KRun

public KRun(KURL url,
            org.kde.qt.QWidget window,
            long mode,
            boolean isLocalFile,
            boolean showProgressInfo)
BIC: Combine with the above ctor for KDE 4.0.

Parameters:
window - The top-level widget of the app that invoked this object. It is used to make sure private information like passwords are properly handled per application.
url - the URL of the file or directory to 'run'
mode - The st_mode field of struct stat. If you don't know this set it to 0.
isLocalFile - If this parameter is set to false then url is examined to find out whether it is a local URL or not. This flag is just used to improve speed, since the function KURL.isLocalFile is a bit slow.
showProgressInfo - Whether to show progress information when determining the type of the file (i.e. when using KIO.stat and KIO.mimetype) Before you set this to false to avoid a dialog box, think about a very slow FTP server... It is always better to provide progress info in such cases.

KRun

public KRun(KURL url,
            org.kde.qt.QWidget window,
            long mode,
            boolean isLocalFile)

KRun

public KRun(KURL url,
            org.kde.qt.QWidget window,
            long mode)

KRun

public KRun(KURL url,
            org.kde.qt.QWidget window)
Method Detail

metaObject

public org.kde.qt.QMetaObject metaObject()
Overrides:
metaObject in class org.kde.qt.QObject

className

public java.lang.String className()
Overrides:
className in class org.kde.qt.QObject

abort

public void abort()
Abort this KRun. This kills any jobs launched by it, and leads to deletion if auto-deletion is on. This is much safer than deleting the KRun (in case it's currently showing an error dialog box, for instance)


hasError

public boolean hasError()
Returns true if the KRun instance has an error.

Returns:
true when an error occurred
See Also:
#error

hasFinished

public boolean hasFinished()
Returns true if the KRun instance has finished.

Returns:
true if the KRun instance has finished
See Also:
#finished

autoDelete

public boolean autoDelete()
Checks whether auto delete is activated. Auto-deletion causes the KRun instance to delete itself when it finished its task. By default auto deletion is on.

Returns:
true if auto deletion is on, false otherwise

setAutoDelete

public void setAutoDelete(boolean b)
Enables or disabled auto deletion. Auto deletion causes the KRun instance to delete itself when it finished its task. If you allocate the KRun object on the stack you must disable auto deletion. By default auto deletion is on.

Parameters:
b - true to enable auto deletion, false to disable

setPreferredService

public void setPreferredService(java.lang.String desktopEntryName)
Set the preferred service for opening this URL, after its mimetype will have been found by KRun. IMPORTANT: the service is only used if its configuration says it can handle this mimetype. This is used for instance for the X-KDE-LastOpenedWith key, for the recent documents list.

Parameters:
desktopEntryName - the desktopEntryName of the service, e.g. "kate".

setRunExecutables

public void setRunExecutables(boolean b)
Sets whether executables, .desktop files or shell scripts should be run by KRun. This is enabled by default.

Parameters:
b - whether to run executable files or not.
See Also:
isExecutable(java.lang.String)

setEnableExternalBrowser

public void setEnableExternalBrowser(boolean b)
Sets whether the external webbrowser setting should be honoured. This is enabled by default. This should only be disabled in webbrowser applications.

Parameters:
b - whether to enable the external browser or not.

run

public static int run(KService _service,
                      java.util.ArrayList _urls,
                      boolean tempFiles)
Open a list of URLs with a certain service (application).

Parameters:
_service - the service to run
_urls - the list of URLs, can be empty (app launched without argument)
tempFiles - if true and _urls are local files, they will be deleted when the application exits.
Returns:
the process id, or 0 on error

run

public static int run(KService _service,
                      java.util.ArrayList _urls)

run

public static int run(java.lang.String _exec,
                      java.util.ArrayList _urls,
                      java.lang.String _name,
                      java.lang.String _icon,
                      java.lang.String _obsolete1,
                      java.lang.String _obsolete2)
Open a list of URLs with.

Parameters:
_exec - the name of the executable, for example "/usr/bin/netscape".
_urls - the list of URLs to open, can be empty (app launched without argument)
_name - the logical name of the application, for example "Netscape 4.06".
_icon - the icon which should be used by the application.
_obsolete1 - Do not use!
_obsolete2 - Do not use!
Returns:
the process id, or 0 on error

run

public static int run(java.lang.String _exec,
                      java.util.ArrayList _urls,
                      java.lang.String _name,
                      java.lang.String _icon,
                      java.lang.String _obsolete1)

run

public static int run(java.lang.String _exec,
                      java.util.ArrayList _urls,
                      java.lang.String _name,
                      java.lang.String _icon)

run

public static int run(java.lang.String _exec,
                      java.util.ArrayList _urls,
                      java.lang.String _name)

run

public static int run(java.lang.String _exec,
                      java.util.ArrayList _urls)

runURL

public static int runURL(KURL _url,
                         java.lang.String _mimetype,
                         boolean tempFile,
                         boolean runExecutables)
Open the given URL. This function is used after the mime type is found out. It will search for all services which can handle the mime type and call run() afterwards.

Parameters:
_url - the URL to open
_mimetype - the mime type of the resource
tempFile - if true and _url is a local file, it will be deleted when the launched application exits.
runExecutables - if false then local .desktop files, executables and shell scripts will not be run. See also isExecutable().
Returns:
the process id, or 0 on error

runURL

public static int runURL(KURL _url,
                         java.lang.String _mimetype,
                         boolean tempFile)

runURL

public static int runURL(KURL _url,
                         java.lang.String _mimetype)

runCommand

public static int runCommand(java.lang.String cmd)
Run the given shell command and notifies kicker of the starting of the application. If the program to be called doesn't exist, an error box will be displayed. Use only when you know the full command line. Otherwise use the other static methods, or KRun's constructor. _cmd must be a shell command. You must not append "&" to it, since the function will do that for you.

Returns:
PID of running command, 0 if it could not be started, 0 - (PID of running command) if command was unsafe for map notification.

runCommand

public static int runCommand(java.lang.String cmd,
                             java.lang.String execName,
                             java.lang.String icon)
Same as the other runCommand(), but it also takes the name of the binary, to display an error message in case it couldn't find it.

Parameters:
cmd - must be a shell command. You must not append "&" to it, since the function will do that for you.
execName - the name of the executable
icon - icon for app starting notification
Returns:
PID of running command, 0 if it could not be started, 0 - (PID of running command) if command was unsafe for map notification.

displayOpenWithDialog

public static boolean displayOpenWithDialog(java.util.ArrayList lst,
                                            boolean tempFiles)
Display the Open-With dialog for those URLs, and run the chosen application.

Parameters:
lst - the list of applications to run
tempFiles - if true and lst are local files, they will be deleted when the application exits.
Returns:
false if the dialog was canceled

displayOpenWithDialog

public static boolean displayOpenWithDialog(java.util.ArrayList lst)

shellQuote

public static void shellQuote(java.lang.StringBuffer _str)
Quotes a string for the shell.

Parameters:
_str - the string to quote. The quoted string will be written here

processDesktopExec

public static java.util.ArrayList processDesktopExec(KService _service,
                                                     java.util.ArrayList _urls,
                                                     boolean has_shell,
                                                     boolean tempFiles)
Processes a Exec= line as found in .desktop files.

Parameters:
_service - the service to extract information from.
_urls - The urls the service should open.
has_shell - If true, the arguments are going to be fed into a shell e.g by using system(). If false, the arguments are going to be fed into a exec() kind call. If the arguments are intended for an exec() kind of call and the Exec line contains shell commands then "/bin/sh -c" is added.
tempFiles - if true and _urls are local files, they will be deleted when the application exits.
Returns:
a list of arguments suitable for either system() or exec().

processDesktopExec

public static java.util.ArrayList processDesktopExec(KService _service,
                                                     java.util.ArrayList _urls,
                                                     boolean has_shell)

binaryName

public static java.lang.String binaryName(java.lang.String execLine,
                                          boolean removePath)
Given a full command line (e.g. the Exec= line from a .desktop file), extract the name of the binary being run.

Parameters:
execLine - the full command line
removePath - if true, remove a (relative or absolute) path. E.g. /usr/bin/ls becomes ls.
Returns:
the name of the binary to run

isExecutable

public static boolean isExecutable(java.lang.String serviceType)
Returns whether serviceType refers to an executable program instead of a data file.


isExecutableFile

public static boolean isExecutableFile(KURL url,
                                       java.lang.String mimetype)
Returns wether the url of mimetype is executable. To be executable the file must pass the following rules: -# Must reside on the local filesystem. -# Must be marked as executable for the user by the filesystem. -# The mime type must inherit application/x-executable or application/x-executable-script. To allow a script to run when the above rules are satisfied add the entry


checkStartupNotify

public static boolean checkStartupNotify(java.lang.String binName,
                                         KService service,
                                         boolean[] silent_arg,
                                         java.lang.StringBuffer wmclass_arg)

init

protected void init()

scanFile

protected void scanFile()

foundMimeType

protected void foundMimeType(java.lang.String _type)
Called if the mimetype has been detected. The function checks whether the document and appends the gzip protocol to the URL. Otherwise runURL is called to finish the job.


killJob

protected void killJob()

slotTimeout

protected void slotTimeout()

slotScanFinished

protected void slotScanFinished(Job arg1)

slotScanMimeType

protected void slotScanMimeType(Job arg1,
                                java.lang.String type)

slotStatResult

protected void slotStatResult(Job arg1)

finalize

protected void finalize()
                 throws java.lang.InternalError
Deletes the wrapped C++ instance

Overrides:
finalize in class org.kde.qt.QObject
Throws:
java.lang.InternalError

dispose

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

Overrides:
dispose in class org.kde.qt.QObject

isDisposed

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

Overrides:
isDisposed in class org.kde.qt.QObject