|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.kde.qt.Qt
org.kde.qt.QObject
org.kde.qt.QWidget
org.kde.qt.QDialog
org.kde.koala.KDialog
org.kde.koala.KDialogBase
org.kde.koala.KFileDialog
public class KFileDialog
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
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.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 |
---|
public static final int Other
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.
setOperationMode(int)
,
operationMode()
,
Constant Field Valuespublic static final int Opening
public static final int Saving
Constructor Detail |
---|
protected KFileDialog(java.lang.Class dummy)
public KFileDialog(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String name, boolean modal)
startDir
- This can either be
filter
- A shell glob or a mime-type-filter that specifies
which files to display.parent
- The parent widget of this dialogname
- The name of this objectmodal
- Whether to create a modal dialog or not
See setFilter() for details on how to use this argument.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)
startDir
- This can either be
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 dialogname
- The name of this objectmodal
- Whether to create a modal dialog or notMethod Detail |
---|
public org.kde.qt.QMetaObject metaObject()
metaObject
in class KDialogBase
public java.lang.String className()
className
in class KDialogBase
public KURL selectedURL()
public java.util.ArrayList selectedURLs()
public KURL baseURL()
public java.lang.String selectedFile()
public java.util.ArrayList selectedFiles()
public void setURL(KURL url, boolean clearforward)
url
- URL to show.clearforward
- Indicates whether the forward queue
should be cleared.public void setURL(KURL url)
public void setSelection(java.lang.String name)
name
This takes absolute URLs and relative file names.
public void setOperationMode(int arg1)
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.
operationMode()
,
KFileDialog#OperationMode
public int operationMode()
operationMode()
,
KFileDialog#OperationMode
public void setKeepLocation(boolean keep)
public boolean keepsLocation()
public void setFilter(java.lang.String filter)
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)" );
#filterChanged
,
setMimeFilter(java.lang.String[], java.lang.String)
public java.lang.String currentFilter()
setFilter(java.lang.String)
,
#filterChanged
public void setMimeFilter(java.lang.String[] types, java.lang.String defaultType)
types
- a list of mimetypes that can be used as output formatdefaultType
- 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()public void setMimeFilter(java.lang.String[] types)
public java.lang.String currentMimeFilter()
setMimeFilter(java.lang.String[], java.lang.String)
public void clearFilter()
public void setPreviewWidget(KPreviewWidgetBase w)
w
- The widget to be used for the preview.public void show()
show
in class org.kde.qt.QDialog
public void setMode(int m)
public int mode()
setMode(int)
public void setLocationLabel(java.lang.String text)
public KToolBar toolBar()
yourAction = new KAction( i18n("Your Action"), 0, this, SLOT("yourSlot()"), this, "action name" ); yourAction.plug( kfileDialog.toolBar() );
public KPushButton okButton()
public KPushButton cancelButton()
public KURLBar speedBar()
KURLBar *urlBar = fileDialog.speedBar(); if ( urlBar ) urlBar.insertDynamicItem( someURL, i18n("The URL's description") );
KURLBar
,
KURLBar.insertDynamicItem(org.kde.koala.KURL, java.lang.String, java.lang.String, int)
public KActionCollection actionCollection()
public int pathComboIndex()
public static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static java.lang.String getOpenFileName(java.lang.String startDir, java.lang.String filter)
public static java.lang.String getOpenFileName(java.lang.String startDir)
public static java.lang.String getOpenFileName()
public static java.lang.String getOpenFileNameWId(java.lang.String startDir, java.lang.String filter, long parent_id, java.lang.String caption)
public static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static java.util.ArrayList getOpenFileNames(java.lang.String startDir, java.lang.String filter)
public static java.util.ArrayList getOpenFileNames(java.lang.String startDir)
public static java.util.ArrayList getOpenFileNames()
public static KURL getOpenURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static KURL getOpenURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static KURL getOpenURL(java.lang.String startDir, java.lang.String filter)
public static KURL getOpenURL(java.lang.String startDir)
public static KURL getOpenURL()
public static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static java.util.ArrayList getOpenURLs(java.lang.String startDir, java.lang.String filter)
public static java.util.ArrayList getOpenURLs(java.lang.String startDir)
public static java.util.ArrayList getOpenURLs()
public static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static java.lang.String getSaveFileName(java.lang.String startDir, java.lang.String filter)
public static java.lang.String getSaveFileName(java.lang.String startDir)
public static java.lang.String getSaveFileName()
public static java.lang.String getSaveFileNameWId(java.lang.String dir, java.lang.String filter, long parent_id, java.lang.String caption)
public static KURL getSaveURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
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.public static KURL getSaveURL(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget parent)
public static KURL getSaveURL(java.lang.String startDir, java.lang.String filter)
public static KURL getSaveURL(java.lang.String startDir)
public static KURL getSaveURL()
public static java.lang.String getExistingDirectory(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
parent
- The widget the dialog will be centered on initially.caption
- The name of the dialog widget.public static java.lang.String getExistingDirectory(java.lang.String startDir, org.kde.qt.QWidget parent)
public static java.lang.String getExistingDirectory(java.lang.String startDir)
public static java.lang.String getExistingDirectory()
public static KURL getExistingURL(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
parent
- The widget the dialog will be centered on initially.caption
- The name of the dialog widget.public static KURL getExistingURL(java.lang.String startDir, org.kde.qt.QWidget parent)
public static KURL getExistingURL(java.lang.String startDir)
public static KURL getExistingURL()
public static KURL getImageOpenURL(java.lang.String startDir, org.kde.qt.QWidget parent, java.lang.String caption)
startDir
- This can either be
parent
- The widget the dialog will be centered on initially.caption
- The name of the dialog widget.public static KURL getImageOpenURL(java.lang.String startDir, org.kde.qt.QWidget parent)
public static KURL getImageOpenURL(java.lang.String startDir)
public static KURL getImageOpenURL()
public static KURL getStartURL(java.lang.String startDir, java.lang.StringBuffer recentDirClass)
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()
public static void setStartDir(KURL directory)
protected void keyPressEvent(org.kde.qt.QKeyEvent e)
keyPressEvent
in class KDialogBase
protected void init(java.lang.String startDir, java.lang.String filter, org.kde.qt.QWidget widget)
protected void initGUI()
protected void multiSelectionChanged()
protected void readConfig(KConfig arg1, java.lang.String group)
protected void readConfig(KConfig arg1)
protected void writeConfig(KConfig arg1, java.lang.String group)
protected void writeConfig(KConfig arg1)
protected void readRecentFiles(KConfig arg1)
protected void saveRecentFiles(KConfig arg1)
protected java.util.ArrayList tokenize(java.lang.String line)
protected KURL getCompleteURL(java.lang.String arg1)
protected java.lang.String currentFilterExtension()
protected void updateAutoSelectExtension()
protected java.util.ArrayList parseSelectedURLs()
protected void urlEntered(KURL arg1)
protected void enterURL(KURL url)
protected void enterURL(java.lang.String url)
protected void locationActivated(java.lang.String url)
protected void slotFilterChanged()
protected void fileHighlighted(KFileItem i)
protected void fileSelected(KFileItem i)
protected void slotStatResult(Job job)
protected void slotLoadingFinished()
protected void fileCompletion(java.lang.String arg1)
protected void toggleSpeedbar(boolean arg1)
protected void toggleBookmarks(boolean show)
protected void slotOk()
KDialogBase
slotOk
in class KDialogBase
protected void accept()
accept
in class org.kde.qt.QDialog
protected void slotCancel()
KDialogBase
slotCancel
in class KDialogBase
protected void slotAutoSelectExtClicked()
protected void addToRecentDocuments()
protected void initSpeedbar()
protected void finalize() throws java.lang.InternalError
finalize
in class KDialogBase
java.lang.InternalError
public void dispose()
dispose
in class KDialogBase
public boolean isDisposed()
isDisposed
in class KDialogBase
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |