org.kde.koala
Class KFileDialog

java.lang.Object
  extended by org.kde.qt.Qt
      extended by org.kde.qt.QObject
          extended by org.kde.qt.QWidget
              extended by org.kde.qt.QDialog
                  extended by org.kde.koala.KDialog
                      extended by org.kde.koala.KDialogBase
                          extended by org.kde.koala.KFileDialog
All Implemented Interfaces:
org.kde.qt.QPaintDeviceInterface, org.kde.qt.QtSupport

public class KFileDialog
extends KDialogBase

Provides a user (and developer) friendly way to select files and directories. The widget can be used as a drop in replacement for the QFileDialog widget, but has greater functionality and a nicer GUI. You will usually want to use one of the static methods getOpenFileName(), getSaveFileName(), getOpenURL() or for multiple files getOpenFileNames() or getOpenURLs(). The dialog has been designed to allow applications to customise it by subclassing. It uses geometry management to ensure that subclasses can easily add children that will be incorporated into the layout. \image html kfiledialog.png "KDE File Dialog" See KFileDialogSignals for signals emitted by KFileDialog

Author:
Richard J. Moore , Carsten Pfeiffer

Field Summary
static int Opening
           
static int Other
          Defines some default behavior of the filedialog.
static int Saving
           
 
Fields inherited from class org.kde.koala.KDialogBase
ActionStyle0, ActionStyle1, ActionStyle2, ActionStyle3, ActionStyle4, ActionStyleMAX, Apply, Cancel, Close, Default, Details, Filler, Help, IconList, No, NoDefault, Ok, Plain, Stretch, Swallow, Tabbed, TreeList, Try, User1, User2, User3, Yes
 
Fields inherited from class org.kde.qt.QDialog
Accepted, Rejected
 
Fields inherited from class org.kde.qt.QWidget
AncestorOrigin, ClickFocus, NoFocus, ParentOrigin, StrongFocus, TabFocus, WheelFocus, WidgetOrigin, WindowOrigin
 
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 KFileDialog(java.lang.Class dummy)
           
  KFileDialog(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String name, boolean modal)
          Constructs a file dialog.
  KFileDialog(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String name, boolean modal, org.kde.qt.QWidget widget)
          Constructs a file dialog.
 
Method Summary
protected  void accept()
           
 KActionCollection actionCollection()
           
protected  void addToRecentDocuments()
           
 KURL baseURL()
           
 KPushButton cancelButton()
           
 java.lang.String className()
           
 void clearFilter()
          Clears any mime- or namefilter.
 java.lang.String currentFilter()
          Returns the current filter as entered by the user or one of the predefined set via setFilter().
protected  java.lang.String currentFilterExtension()
          Returns the filename extension associated with the currentFilter().
 java.lang.String currentMimeFilter()
          The mimetype for the desired output format.
 void dispose()
          Delete the wrapped C++ instance ahead of finalize()
protected  void enterURL(KURL url)
           
protected  void enterURL(java.lang.String url)
           
protected  void fileCompletion(java.lang.String arg1)
           
protected  void fileHighlighted(KFileItem i)
           
protected  void fileSelected(KFileItem i)
           
protected  void finalize()
          Deletes the wrapped C++ instance
protected  KURL getCompleteURL(java.lang.String arg1)
          Returns the absolute version of the URL specified in locationEdit.
static java.lang.String getExistingDirectory()
           
static java.lang.String getExistingDirectory(java.lang.String startDir)
           
static java.lang.String getExistingDirectory(java.lang.String startDir, org.kde.qt.QWidget parent)
           
static java.lang.String getExistingDirectory(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected directory or an empty string if none was chosen.
static KURL getExistingURL()
           
static KURL getExistingURL(java.lang.String startDir)
           
static KURL getExistingURL(java.lang.String startDir, org.kde.qt.QWidget parent)
           
static KURL getExistingURL(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected directory or an empty string if none was chosen.
static KURL getImageOpenURL()
           
static KURL getImageOpenURL(java.lang.String startDir)
           
static KURL getImageOpenURL(java.lang.String startDir, org.kde.qt.QWidget parent)
           
static KURL getImageOpenURL(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog with an image previewer and returns the selected url or an empty string if none was chosen.
static java.lang.String getOpenFileName()
           
static java.lang.String getOpenFileName(java.lang.String startDir)
           
static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter)
           
static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and return the selected filename or an empty string if none was chosen.
static java.util.ArrayList getOpenFileNames()
           
static java.util.ArrayList getOpenFileNames(java.lang.String startDir)
           
static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter)
           
static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected filenames or an empty list if none was chosen.
static java.lang.String getOpenFileNameWId(java.lang.String startDir, java.lang.String filter, long parent_id, java.lang.String caption)
          Use this version only if you have no QWidget available as parent widget.
static KURL getOpenURL()
           
static KURL getOpenURL(java.lang.String startDir)
           
static KURL getOpenURL(java.lang.String startDir, java.lang.String filter)
           
static KURL getOpenURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static KURL getOpenURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected URL or an empty string if none was chosen.
static java.util.ArrayList getOpenURLs()
           
static java.util.ArrayList getOpenURLs(java.lang.String startDir)
           
static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter)
           
static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected URLs or an empty list if none was chosen.
static java.lang.String getSaveFileName()
           
static java.lang.String getSaveFileName(java.lang.String startDir)
           
static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter)
           
static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.
static java.lang.String getSaveFileNameWId(java.lang.String dir, java.lang.String filter, long parent_id, java.lang.String caption)
          This function accepts the window id of the parent window, instead of QWidget.
static KURL getSaveURL()
           
static KURL getSaveURL(java.lang.String startDir)
           
static KURL getSaveURL(java.lang.String startDir, java.lang.String filter)
           
static KURL getSaveURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
           
static KURL getSaveURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
          Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.
static KURL getStartURL(java.lang.String startDir, java.lang.StringBuffer recentDirClass)
          This method implements the logic to determine the user's default directory to be listed.
protected  void init(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget widget)
          Perform basic initialization tasks.
protected  void initGUI()
          rebuild geometry management.
protected  void initSpeedbar()
           
 boolean isDisposed()
          Has the wrapped C++ instance been deleted?
 boolean keepsLocation()
           
protected  void keyPressEvent(org.kde.qt.QKeyEvent e)
          Reimplemented to animate the cancel button.
protected  void locationActivated(java.lang.String url)
           
 org.kde.qt.QMetaObject metaObject()
           
 int mode()
          Returns the mode of the filedialog.
protected  void multiSelectionChanged()
          called when an item is highlighted/selected in multiselection mode.
 KPushButton okButton()
           
 int operationMode()
           
protected  java.util.ArrayList parseSelectedURLs()
           
 int pathComboIndex()
           
protected  void readConfig(KConfig arg1)
           
protected  void readConfig(KConfig arg1, java.lang.String group)
          Reads configuration and applies it (size, recent directories, ...)
protected  void readRecentFiles(KConfig arg1)
          Reads the recent used files and inserts them into the location combobox
protected  void saveRecentFiles(KConfig arg1)
          Saves the entries from the location combobox.
 java.lang.String selectedFile()
          Returns the full path of the selected file in the local filesystem.
 java.util.ArrayList selectedFiles()
          Returns a list of all selected local files.
 KURL selectedURL()
           
 java.util.ArrayList selectedURLs()
           
 void setFilter(java.lang.String filter)
          Sets the filter to be used to filter. You can set more filters for the user to select separated by '\n'.
 void setKeepLocation(boolean keep)
          Sets whether the filename/url should be kept when changing directories.
 void setLocationLabel(java.lang.String text)
          Sets the text to be displayed in front of the selection.
 void setMimeFilter(java.lang.String[] types)
           
 void setMimeFilter(java.lang.String[] types, java.lang.String defaultType)
          Sets the filter up to specify the output type.
 void setMode(int m)
          Convenient overload of the other setMode(unsigned int) method.
 void setOperationMode(int arg1)
          Sets the operational mode of the filedialog to Saving, Opening or Other. This will set some flags that are specific to loading or saving files.
 void setPreviewWidget(KPreviewWidgetBase w)
          Adds a preview widget and enters the preview mode.
 void setSelection(java.lang.String name)
          Sets the file name to preselect to name This takes absolute URLs and relative file names.
static void setStartDir(KURL directory)
          Used by KDirSelectDialog to share the dialog's start directory.
 void setURL(KURL url)
           
 void setURL(KURL url, boolean clearforward)
          Sets the directory to view.
 void show()
           
protected  void slotAutoSelectExtClicked()
           
protected  void slotCancel()
          Activated when the Cancel button has been clicked.
protected  void slotFilterChanged()
           
protected  void slotLoadingFinished()
           
protected  void slotOk()
          Activated when the Ok button has been clicked.
protected  void slotStatResult(Job job)
           
 KURLBar speedBar()
          Note that this method may return a null-pointer if the user configured to not use the speed-bar.
protected  void toggleBookmarks(boolean show)
           
protected  void toggleSpeedbar(boolean arg1)
           
protected  java.util.ArrayList tokenize(java.lang.String line)
          Parses the string "line" for files.
 KToolBar toolBar()
          Returns a pointer to the toolbar.
protected  void updateAutoSelectExtension()
          Updates the currentFilterExtension and the availability of the Automatically Select Extension Checkbox (visible if operationMode() == Saving and enabled if an extension _will_ be associated with the currentFilter(), _after_ this call).
protected  void urlEntered(KURL arg1)
           
protected  void writeConfig(KConfig arg1)
           
protected  void writeConfig(KConfig arg1, java.lang.String group)
          Saves the current configuration
 
Methods inherited from class org.kde.koala.KDialogBase
actionButton, activePageIndex, addButtonBelowList, addButtonBelowList, addGridPage, addGridPage, addGridPage, addGridPage, addGridPage, addGridPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addPage, addPage, addPage, addPage, addPage, addPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addWidgetBelowList, adjustSize, backgroundTile, calculateSize, cancel, closeEvent, configDialogSize, configDialogSize, delayedDestruct, disableResize, enableButton, enableButtonApply, enableButtonCancel, enableButtonOK, enableButtonSeparator, enableLinkedHelp, haveBackgroundTile, helpClickedSlot, helpLinkText, hideEvent, incInitialSize, incInitialSize, mainWidget, makeGridMainWidget, makeHBoxMainWidget, makeMainWidget, makeVBoxMainWidget, minimumSizeHint, pageIndex, plainPage, saveDialogSize, saveDialogSize, saveDialogSize, saveDialogSize, setBackgroundTile, setButtonApply, setButtonApply, setButtonBoxOrientation, setButtonCancel, setButtonCancel, setButtonGuiItem, setButtonOK, setButtonOK, setButtonText, setButtonTip, setButtonWhatsThis, setDetails, setDetailsWidget, setEscapeButton, setFolderIcon, setHelp, setHelp, setHelpLinkText, setIconListAllVisible, setInitialSize, setInitialSize, setMainWidget, setRootIsDecorated, setShowIconsInTreeList, setTreeListAutoResize, showButton, showButtonApply, showButtonCancel, showButtonOK, showPage, showTile, sizeHint, slotApply, slotClose, slotDefault, slotDelayedDestruct, slotDetails, slotHelp, slotNo, slotTry, slotUser1, slotUser2, slotUser3, slotYes, unfoldTreeList, unfoldTreeList, updateBackground, updateGeometry
 
Methods inherited from class org.kde.koala.KDialog
avoidArea, avoidArea, centerOnScreen, centerOnScreen, marginHint, polish, resizeLayout, resizeLayout, setCaption, setPlainCaption, spacingHint
 
Methods inherited from class org.kde.qt.QDialog
adjustPosition, contextMenuEvent, done, eventFilter, exec, extension, hide, isModal, isSizeGripEnabled, move, move, orientation, reject, resize, resize, resizeEvent, result, setExtension, setGeometry, setGeometry, setModal, setOrientation, setResult, setSizeGripEnabled, showExtension, tr, tr
 
Methods inherited from class org.kde.qt.QWidget
acceptDrops, autoMask, backgroundBrush, backgroundColor, backgroundMode, backgroundOffset, backgroundOrigin, backgroundPixmap, baseSize, caption, childAt, childAt, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, clearWFlags, clearWState, clipRegion, close, close, colorGroup, constPolish, create, create, create, create, cursor, customWhatsThis, destroy, destroy, destroy, devType, dragEnterEvent, dragLeaveEvent, dragMoveEvent, drawText, drawText, dropEvent, enabledChange, enterEvent, erase, erase, erase, erase, eraseColor, erasePixmap, event, find, focusData, focusInEvent, focusNextPrevChild, focusOutEvent, focusPolicy, focusProxy, focusWidget, font, fontChange, fontInf, fontInfo, fontMet, fontMet, fontMet, fontMetrics, foregroundColor, frameGeometry, frameSize, geometry, getWFlags, getWState, grabKeyboard, grabMouse, grabMouse, hasFocus, hasMouse, hasMouseTracking, height, heightForWidth, icon, iconify, iconText, imComposeEvent, imEndEvent, imStartEvent, isActiveWindow, isDesktop, isDialog, isEnabled, isEnabledTo, isEnabledToTLW, isExtDev, isFocusEnabled, isFullScreen, isHidden, isInputMethodEnabled, isMaximized, isMinimized, isPopup, isShown, isTopLevel, isUpdatesEnabled, isVisible, isVisibleTo, isVisibleToTLW, keyboardGrabber, keyReleaseEvent, layout, leaveEvent, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, maximumHeight, maximumSize, maximumWidth, metric, microFocusHint, minimumHeight, minimumSize, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, moveEvent, ownCursor, ownFont, ownPalette, paintDevice, paintEvent, paintingActive, palette, paletteBackgroundColor, paletteBackgroundPixmap, paletteChange, paletteForegroundColor, parentWidget, parentWidget, pos, raise, recreate, recreate, rect, releaseKeyboard, releaseMouse, repaint, repaint, repaint, repaint, repaint, repaint, repaint, repaint, reparent, reparent, reparent, reparent, resetInputContext, resolution, scroll, scroll, setAcceptDrops, setActiveWindow, setAutoMask, setBackgroundColor, setBackgroundMode, setBackgroundMode, setBackgroundOrigin, setBackgroundPixmap, setBaseSize, setBaseSize, setCursor, setDisabled, setEnabled, setEraseColor, setErasePixmap, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, setFocusPolicy, setFocusProxy, setFont, setFont, setHidden, setIcon, setIconText, setInputMethodEnabled, setKeyCompression, setMask, setMask, setMaximumHeight, setMaximumSize, setMaximumSize, setMaximumWidth, setMicroFocusHint, setMicroFocusHint, setMicroFocusHint, setMinimumHeight, setMinimumSize, setMinimumSize, setMinimumWidth, setMouseTracking, setName, setPalette, setPalette, setPaletteBackgroundColor, setPaletteBackgroundPixmap, setPaletteForegroundColor, setResolution, setShown, setSizeIncrement, setSizeIncrement, setSizePolicy, setSizePolicy, setSizePolicy, setStyle, setStyle, setTabOrder, setUpdatesEnabled, setWFlags, setWindowOpacity, setWindowState, setWState, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeIncrement, sizePolicy, stackUnder, style, styleChange, tabletEvent, testWFlags, testWState, topLevelWidget, unsetCursor, unsetFont, unsetPalette, update, update, update, updateMask, visibleRect, wheelEvent, width, windowActivationChange, windowOpacity, windowState, winId, x, y
 
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, highPriority, i18n, inherits, insertChild, installEventFilter, isA, isWidgetType, killTimer, killTimers, name, name, normalizeSignalSlot, objectTrees, parent, property, queryList, queryList, queryList, queryList, queryList, registerUserData, removeChild, removeEventFilter, sender, setProperty, signalsBlocked, startTimer, timerEvent
 
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
 

Field Detail

Other

public static final int Other
Defines some default behavior of the filedialog. E.g. in mode Opening and Saving, the selected files/urls will be added to the "recent documents" list. The Saving mode also implies setKeepLocation() being set. Other means that no default actions are performed.

See Also:
setOperationMode(int), operationMode(), Constant Field Values

Opening

public static final int Opening
See Also:
Constant Field Values

Saving

public static final int Saving
See Also:
Constant Field Values
Constructor Detail

KFileDialog

protected KFileDialog(java.lang.Class dummy)

KFileDialog

public KFileDialog(java.lang.String startDir,
                   java.lang.String filter,
                   org.kde.qt.QWidget parent,
                   java.lang.String name,
                   boolean modal)
Constructs a file dialog.

Parameters:
startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - A shell glob or a mime-type-filter that specifies which files to display.
    parent - The parent widget of this dialog
    name - The name of this object
    modal - Whether to create a modal dialog or not See setFilter() for details on how to use this argument.

    KFileDialog

    public KFileDialog(java.lang.String startDir,
                       java.lang.String filter,
                       org.kde.qt.QWidget parent,
                       java.lang.String name,
                       boolean modal,
                       org.kde.qt.QWidget widget)
    Constructs a file dialog. The parameters here are identical to the first constructor except for the addition of a QWidget parameter. Historical note: The original version of KFileDialog did not have this extra parameter. It was added later, and, in order to maintain binary compatibility, it was placed in a new constructor instead of added to the original one.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - A shell glob or a mime-type-filter that specifies which files to display. See setFilter() for details on how to use this argument.
    widget - A widget, or a widget of widgets, for displaying custom data in the dialog. This can be used, for example, to display a check box with the caption "Open as read-only". When creating this widget, you don't need to specify a parent, since the widget's parent will be set automatically by KFileDialog.
    parent - The parent widget of this dialog
    name - The name of this object
    modal - Whether to create a modal dialog or not
    Method Detail

    metaObject

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

    className

    public java.lang.String className()
    Overrides:
    className in class KDialogBase

    selectedURL

    public KURL selectedURL()
    Returns:
    The selected fully qualified filename.

    selectedURLs

    public java.util.ArrayList selectedURLs()
    Returns:
    The list of selected URLs.

    baseURL

    public KURL baseURL()
    Returns:
    the currently shown directory.

    selectedFile

    public java.lang.String selectedFile()
    Returns the full path of the selected file in the local filesystem. (Local files only)


    selectedFiles

    public java.util.ArrayList selectedFiles()
    Returns a list of all selected local files.


    setURL

    public void setURL(KURL url,
                       boolean clearforward)
    Sets the directory to view.

    Parameters:
    url - URL to show.
    clearforward - Indicates whether the forward queue should be cleared.

    setURL

    public void setURL(KURL url)

    setSelection

    public void setSelection(java.lang.String name)
    Sets the file name to preselect to name This takes absolute URLs and relative file names.


    setOperationMode

    public void setOperationMode(int arg1)
    Sets the operational mode of the filedialog to Saving, Opening or Other. This will set some flags that are specific to loading or saving files. E.g. setKeepLocation() makes mostly sense for a save-as dialog. So setOperationMode( KFileDialog.Saving ); sets setKeepLocation for example. The mode Saving, together with a default filter set via setMimeFilter() will make the filter combobox read-only. The default mode is Opening. Call this method right after instantiating KFileDialog.

    See Also:
    operationMode(), KFileDialog#OperationMode

    operationMode

    public int operationMode()
    Returns:
    the current operation mode, Opening, Saving or Other. Default is Other.
    See Also:
    operationMode(), KFileDialog#OperationMode

    setKeepLocation

    public void setKeepLocation(boolean keep)
    Sets whether the filename/url should be kept when changing directories. This is for example useful when having a predefined filename where the full path for that file is searched. This is implicitly set when operationMode() is KFileDialog.Saving getSaveFileName() and getSaveURL() set this to true by default, so that you can type in the filename and change the directory without having to type the name again.


    keepsLocation

    public boolean keepsLocation()
    Returns:
    whether the contents of the location edit are kept when changing directories.

    setFilter

    public void setFilter(java.lang.String filter)
    Sets the filter to be used to filter. You can set more filters for the user to select separated by '\n'. Every filter entry is defined through namefilter|text to diplay. If no | is found in the expression, just the namefilter is shown. Examples:
                     kfile.setFilter("*.cpp|C++ Source Files\n.h|Header files");
                     kfile.setFilter("*.cpp");
                     kfile.setFilter("*.cpp|Sources (.cpp)");
                     kfile.setFilter("*.cpp|" + i18n("Sources (.cpp)"));
                     kfile.setFilter("*.cpp .cc .C|C++ Source Files\n.h .H|Header files");
                     
    Note: The text to display is not parsed in any way. So, if you want to show the suffix to select by a specific filter, you must repeat it. If the filter contains an unescaped '/', a mimetype-filter is assumed. If you would like a '/' visible in your filter it can be escaped with a '\'. You can specify multiple mimetypes like this (separated with space):
                     kfile.setFilter( "image/png text/html text/plain" );
                     kfile.setFilter( "*.cue|CUE\\/BIN Files (.cue)" );
                     

    See Also:
    #filterChanged, setMimeFilter(java.lang.String[], java.lang.String)

    currentFilter

    public java.lang.String currentFilter()
    Returns the current filter as entered by the user or one of the predefined set via setFilter().

    See Also:
    setFilter(java.lang.String), #filterChanged

    setMimeFilter

    public void setMimeFilter(java.lang.String[] types,
                              java.lang.String defaultType)
    Sets the filter up to specify the output type.

    Parameters:
    types - a list of mimetypes that can be used as output format
    defaultType - the default mimetype to use as output format, if any. If defaultType is set, it will be set as the current item. Otherwise, a first item showing all the mimetypes will be created. Typically, defaultType should be empty for loading and set for saving. Do not use in conjunction with setFilter()

    setMimeFilter

    public void setMimeFilter(java.lang.String[] types)

    currentMimeFilter

    public java.lang.String currentMimeFilter()
    The mimetype for the desired output format. This is only valid if setMimeFilter() has been called previously.

    See Also:
    setMimeFilter(java.lang.String[], java.lang.String)

    clearFilter

    public void clearFilter()
    Clears any mime- or namefilter. Does not reload the directory.


    setPreviewWidget

    public void setPreviewWidget(KPreviewWidgetBase w)
    Adds a preview widget and enters the preview mode. In this mode the dialog is split and the right part contains your preview widget. Ownership is transferred to KFileDialog. You need to create the preview-widget with "new", i.e. on the heap.

    Parameters:
    w - The widget to be used for the preview.

    show

    public void show()
    Overrides:
    show in class org.kde.qt.QDialog

    setMode

    public void setMode(int m)
    Convenient overload of the other setMode(unsigned int) method.


    mode

    public int mode()
    Returns the mode of the filedialog.

    See Also:
    setMode(int)

    setLocationLabel

    public void setLocationLabel(java.lang.String text)
    Sets the text to be displayed in front of the selection. The default is "Location". Most useful if you want to make clear what the location is used for.


    toolBar

    public KToolBar toolBar()
    Returns a pointer to the toolbar. You can use this to insert custom items into it, e.g.:
                          yourAction = new KAction( i18n("Your Action"), 0,
                                                    this, SLOT("yourSlot()"),
                                                    this, "action name" );
                          yourAction.plug( kfileDialog.toolBar() );
                     


    okButton

    public KPushButton okButton()
    Returns:
    a pointer to the OK-Button in the filedialog. You may use it e.g. to set a custom text to it.

    cancelButton

    public KPushButton cancelButton()
    Returns:
    a pointer to the Cancel-Button in the filedialog. You may use it e.g. to set a custom text to it.

    speedBar

    public KURLBar speedBar()
    Note that this method may return a null-pointer if the user configured to not use the speed-bar.

    Returns:
    the KURLBar object used as the "speed bar". You can add custom entries to it like that:
     KURLBar *urlBar = fileDialog.speedBar();
     if ( urlBar )
         urlBar.insertDynamicItem( someURL, i18n("The URL's description") );
     
    See Also:
    KURLBar, KURLBar.insertDynamicItem(org.kde.koala.KURL, java.lang.String, java.lang.String, int)

    actionCollection

    public KActionCollection actionCollection()
    Returns:
    a pointer to the action collection, holding all the used KActions.

    pathComboIndex

    public int pathComboIndex()
    Returns:
    the index of the path combobox so when inserting widgets into the dialog (e.g. subclasses) they can do so without hardcoding in an index

    getOpenFileName

    public static java.lang.String getOpenFileName(java.lang.String startDir,
                                                   java.lang.String filter,
                                                   org.kde.qt.QWidget parent,
                                                   java.lang.String caption)
    Creates a modal file dialog and return the selected filename or an empty string if none was chosen. Note that with this method the user must select an existing filename.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getOpenFileName

    public static java.lang.String getOpenFileName(java.lang.String startDir,
                                                   java.lang.String filter,
                                                   org.kde.qt.QWidget parent)

    getOpenFileName

    public static java.lang.String getOpenFileName(java.lang.String startDir,
                                                   java.lang.String filter)

    getOpenFileName

    public static java.lang.String getOpenFileName(java.lang.String startDir)

    getOpenFileName

    public static java.lang.String getOpenFileName()

    getOpenFileNameWId

    public static java.lang.String getOpenFileNameWId(java.lang.String startDir,
                                                      java.lang.String filter,
                                                      long parent_id,
                                                      java.lang.String caption)
    Use this version only if you have no QWidget available as parent widget. This can be the case if the parent widget is a widget in another process or if the parent widget is a non-Qt widget. For example, in a GTK program.


    getOpenFileNames

    public static java.util.ArrayList getOpenFileNames(java.lang.String startDir,
                                                       java.lang.String filter,
                                                       org.kde.qt.QWidget parent,
                                                       java.lang.String caption)
    Creates a modal file dialog and returns the selected filenames or an empty list if none was chosen. Note that with this method the user must select an existing filename.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getOpenFileNames

    public static java.util.ArrayList getOpenFileNames(java.lang.String startDir,
                                                       java.lang.String filter,
                                                       org.kde.qt.QWidget parent)

    getOpenFileNames

    public static java.util.ArrayList getOpenFileNames(java.lang.String startDir,
                                                       java.lang.String filter)

    getOpenFileNames

    public static java.util.ArrayList getOpenFileNames(java.lang.String startDir)

    getOpenFileNames

    public static java.util.ArrayList getOpenFileNames()

    getOpenURL

    public static KURL getOpenURL(java.lang.String startDir,
                                  java.lang.String filter,
                                  org.kde.qt.QWidget parent,
                                  java.lang.String caption)
    Creates a modal file dialog and returns the selected URL or an empty string if none was chosen. Note that with this method the user must select an existing URL.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getOpenURL

    public static KURL getOpenURL(java.lang.String startDir,
                                  java.lang.String filter,
                                  org.kde.qt.QWidget parent)

    getOpenURL

    public static KURL getOpenURL(java.lang.String startDir,
                                  java.lang.String filter)

    getOpenURL

    public static KURL getOpenURL(java.lang.String startDir)

    getOpenURL

    public static KURL getOpenURL()

    getOpenURLs

    public static java.util.ArrayList getOpenURLs(java.lang.String startDir,
                                                  java.lang.String filter,
                                                  org.kde.qt.QWidget parent,
                                                  java.lang.String caption)
    Creates a modal file dialog and returns the selected URLs or an empty list if none was chosen. Note that with this method the user must select an existing filename.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getOpenURLs

    public static java.util.ArrayList getOpenURLs(java.lang.String startDir,
                                                  java.lang.String filter,
                                                  org.kde.qt.QWidget parent)

    getOpenURLs

    public static java.util.ArrayList getOpenURLs(java.lang.String startDir,
                                                  java.lang.String filter)

    getOpenURLs

    public static java.util.ArrayList getOpenURLs(java.lang.String startDir)

    getOpenURLs

    public static java.util.ArrayList getOpenURLs()

    getSaveFileName

    public static java.lang.String getSaveFileName(java.lang.String startDir,
                                                   java.lang.String filter,
                                                   org.kde.qt.QWidget parent,
                                                   java.lang.String caption)
    Creates a modal file dialog and returns the selected filename or an empty string if none was chosen. Note that with this method the user need not select an existing filename.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • a relative path or a filename determining the directory to start in and the file to be selected.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getSaveFileName

    public static java.lang.String getSaveFileName(java.lang.String startDir,
                                                   java.lang.String filter,
                                                   org.kde.qt.QWidget parent)

    getSaveFileName

    public static java.lang.String getSaveFileName(java.lang.String startDir,
                                                   java.lang.String filter)

    getSaveFileName

    public static java.lang.String getSaveFileName(java.lang.String startDir)

    getSaveFileName

    public static java.lang.String getSaveFileName()

    getSaveFileNameWId

    public static java.lang.String getSaveFileNameWId(java.lang.String dir,
                                                      java.lang.String filter,
                                                      long parent_id,
                                                      java.lang.String caption)
    This function accepts the window id of the parent window, instead of QWidget. It should be used only when necessary.


    getSaveURL

    public static KURL getSaveURL(java.lang.String startDir,
                                  java.lang.String filter,
                                  org.kde.qt.QWidget parent,
                                  java.lang.String caption)
    Creates a modal file dialog and returns the selected filename or an empty string if none was chosen. Note that with this method the user need not select an existing filename.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • a relative path or a filename determining the directory to start in and the file to be selected.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • filter - This is a space separated list of shell globs. You can set the text to be displayed for the glob, and provide multiple globs. See setFilter() for details on how to do this...
    parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getSaveURL

    public static KURL getSaveURL(java.lang.String startDir,
                                  java.lang.String filter,
                                  org.kde.qt.QWidget parent)

    getSaveURL

    public static KURL getSaveURL(java.lang.String startDir,
                                  java.lang.String filter)

    getSaveURL

    public static KURL getSaveURL(java.lang.String startDir)

    getSaveURL

    public static KURL getSaveURL()

    getExistingDirectory

    public static java.lang.String getExistingDirectory(java.lang.String startDir,
                                                        org.kde.qt.QWidget parent,
                                                        java.lang.String caption)
    Creates a modal file dialog and returns the selected directory or an empty string if none was chosen.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getExistingDirectory

    public static java.lang.String getExistingDirectory(java.lang.String startDir,
                                                        org.kde.qt.QWidget parent)

    getExistingDirectory

    public static java.lang.String getExistingDirectory(java.lang.String startDir)

    getExistingDirectory

    public static java.lang.String getExistingDirectory()

    getExistingURL

    public static KURL getExistingURL(java.lang.String startDir,
                                      org.kde.qt.QWidget parent,
                                      java.lang.String caption)
    Creates a modal file dialog and returns the selected directory or an empty string if none was chosen. Contrary to getExistingDirectory(), this method allows the selection of a remote directory.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getExistingURL

    public static KURL getExistingURL(java.lang.String startDir,
                                      org.kde.qt.QWidget parent)

    getExistingURL

    public static KURL getExistingURL(java.lang.String startDir)

    getExistingURL

    public static KURL getExistingURL()

    getImageOpenURL

    public static KURL getImageOpenURL(java.lang.String startDir,
                                       org.kde.qt.QWidget parent,
                                       java.lang.String caption)
    Creates a modal file dialog with an image previewer and returns the selected url or an empty string if none was chosen.

    Parameters:
    startDir - This can either be
  • The URL of the directory to start in.
  • null to start in the current working directory, or the last directory where a file has been selected.
  • ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
  • '.<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
  • parent - The widget the dialog will be centered on initially.
    caption - The name of the dialog widget.

    getImageOpenURL

    public static KURL getImageOpenURL(java.lang.String startDir,
                                       org.kde.qt.QWidget parent)

    getImageOpenURL

    public static KURL getImageOpenURL(java.lang.String startDir)

    getImageOpenURL

    public static KURL getImageOpenURL()

    getStartURL

    public static KURL getStartURL(java.lang.String startDir,
                                   java.lang.StringBuffer recentDirClass)
    This method implements the logic to determine the user's default directory to be listed. E.g. the documents direcory, home directory or a recently used directory.

    Parameters:
    startDir - A url/directory, to be used. May use the ':' and '.' syntax as documented in the KFileDialog() constructor.
    recentDirClass - If the ':' or '.' syntax is used, recentDirClass will contain the string to be used later for KRecentDir.dir()
    Returns:
    The URL that should be listed by default (e.g. by KFileDialog or KDirSelectDialog).

    setStartDir

    public static void setStartDir(KURL directory)
    Used by KDirSelectDialog to share the dialog's start directory.


    keyPressEvent

    protected void keyPressEvent(org.kde.qt.QKeyEvent e)
    Reimplemented to animate the cancel button.

    Overrides:
    keyPressEvent in class KDialogBase

    init

    protected void init(java.lang.String startDir,
                        java.lang.String filter,
                        org.kde.qt.QWidget widget)
    Perform basic initialization tasks. Called by constructors.


    initGUI

    protected void initGUI()
    rebuild geometry management.


    multiSelectionChanged

    protected void multiSelectionChanged()
    called when an item is highlighted/selected in multiselection mode. handles setting the locationEdit.


    readConfig

    protected void readConfig(KConfig arg1,
                              java.lang.String group)
    Reads configuration and applies it (size, recent directories, ...)


    readConfig

    protected void readConfig(KConfig arg1)

    writeConfig

    protected void writeConfig(KConfig arg1,
                               java.lang.String group)
    Saves the current configuration


    writeConfig

    protected void writeConfig(KConfig arg1)

    readRecentFiles

    protected void readRecentFiles(KConfig arg1)
    Reads the recent used files and inserts them into the location combobox


    saveRecentFiles

    protected void saveRecentFiles(KConfig arg1)
    Saves the entries from the location combobox.


    tokenize

    protected java.util.ArrayList tokenize(java.lang.String line)
    Parses the string "line" for files. If line doesn't contain any ", the whole line will be interpreted as one file. If the number of " is odd, an empty list will be returned. Otherwise, all items enclosed in " " will be returned as correct urls.


    getCompleteURL

    protected KURL getCompleteURL(java.lang.String arg1)
    Returns the absolute version of the URL specified in locationEdit.


    currentFilterExtension

    protected java.lang.String currentFilterExtension()
    Returns the filename extension associated with the currentFilter(). null is returned if an extension is not available or if operationMode() != Saving.


    updateAutoSelectExtension

    protected void updateAutoSelectExtension()
    Updates the currentFilterExtension and the availability of the Automatically Select Extension Checkbox (visible if operationMode() == Saving and enabled if an extension _will_ be associated with the currentFilter(), _after_ this call). You should call this after filterWidget.setCurrentItem().


    parseSelectedURLs

    protected java.util.ArrayList parseSelectedURLs()

    urlEntered

    protected void urlEntered(KURL arg1)

    enterURL

    protected void enterURL(KURL url)

    enterURL

    protected void enterURL(java.lang.String url)

    locationActivated

    protected void locationActivated(java.lang.String url)

    slotFilterChanged

    protected void slotFilterChanged()

    fileHighlighted

    protected void fileHighlighted(KFileItem i)

    fileSelected

    protected void fileSelected(KFileItem i)

    slotStatResult

    protected void slotStatResult(Job job)

    slotLoadingFinished

    protected void slotLoadingFinished()

    fileCompletion

    protected void fileCompletion(java.lang.String arg1)

    toggleSpeedbar

    protected void toggleSpeedbar(boolean arg1)

    toggleBookmarks

    protected void toggleBookmarks(boolean show)

    slotOk

    protected void slotOk()
    Description copied from class: KDialogBase
    Activated when the Ok button has been clicked. The QDialog.accept() is activated.

    Overrides:
    slotOk in class KDialogBase

    accept

    protected void accept()
    Overrides:
    accept in class org.kde.qt.QDialog

    slotCancel

    protected void slotCancel()
    Description copied from class: KDialogBase
    Activated when the Cancel button has been clicked. The QDialog.reject() is activated in regular mode and QDialog.done( Cancel ) when in message box mode.

    Overrides:
    slotCancel in class KDialogBase

    slotAutoSelectExtClicked

    protected void slotAutoSelectExtClicked()

    addToRecentDocuments

    protected void addToRecentDocuments()

    initSpeedbar

    protected void initSpeedbar()

    finalize

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

    Overrides:
    finalize in class KDialogBase
    Throws:
    java.lang.InternalError

    dispose

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

    Overrides:
    dispose in class KDialogBase

    isDisposed

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

    Overrides:
    isDisposed in class KDialogBase