FX::FXFileDialog Class Reference

File selection dialog. More...

#include <FXFileDialog.h>

Inheritance diagram for FX::FXFileDialog:

Public Member Functions
	FXFileDialog (FXWindow *owner, const FXString &name, FXuint opts=0, FXint x=0, FXint y=0, FXint w=500, FXint h=300)
	Construct file dialog box.
	FXFileDialog (FXApp *a, const FXString &name, FXuint opts=0, FXint x=0, FXint y=0, FXint w=500, FXint h=300)
	Construct free-floating file dialog box.
virtual void	create ()
	Create server-side resources.
virtual void	destroy ()
	Destroy server-side resources.
void	setFilename (const FXString &path)
	Change file name.
FXString	getFilename () const
	Return file name, if any.
FXString *	getFilenames () const
	Return empty-string terminated list of selected file names, or NULL if none selected.
void	setDirectory (const FXString &path)
	Change directory.
FXString	getDirectory () const
	Return directory.
void	setSelectMode (FXuint mode)
	Change file selection mode; the default is SELECTFILE_ANY.
FXuint	getSelectMode () const
	Return file selection mode.
void	setPattern (const FXString &ptrn)
	Change file pattern.
FXString	getPattern () const
	Return file pattern.
void	setMatchMode (FXuint mode)
	Change wildcard matching mode (see FXPath)
FXuint	getMatchMode () const
	Return wildcard matching mode.
void	setPatternList (const FXString &patterns)
	Change the list of file patterns shown in the file dialog. More...
FXString	getPatternList () const
	Return list of patterns.
void	setCurrentPattern (FXint patno)
	After setting the list of patterns, this call will initially select pattern patno as the active one.
FXint	getCurrentPattern () const
	Return current pattern number.
void	setPatternText (FXint patno, const FXString &text)
	Change pattern text for pattern number.
FXString	getPatternText (FXint patno) const
	Get pattern text for given pattern number.
FXint	getNumPatterns () const
	Return number of patterns.
void	allowPatternEntry (FXbool flag)
	Allow pattern entry.
FXbool	allowPatternEntry () const
	Return true if pattern entry is allowed.
void	setItemSpace (FXint s)
	Set the inter-item spacing (in pixels)
FXint	getItemSpace () const
	Return the inter-item spacing (in pixels)
FXbool	showHiddenFiles () const
	Return true if showing hidden files.
void	showHiddenFiles (FXbool flag)
	Show or hide hidden files.
FXbool	showImages () const
	Return true if image preview on.
void	showImages (FXbool flag)
	Show or hide preview images.
FXint	getImageSize () const
	Return images preview size.
void	setImageSize (FXint size)
	Change images preview size.
void	showReadOnly (FXbool flag)
	Show readonly button.
FXbool	shownReadOnly () const
	Return true if readonly is shown.
void	setReadOnly (FXbool flag)
	Set initial state of readonly button.
FXbool	getReadOnly () const
	Get readonly state.
void	setFileBoxStyle (FXuint style)
	Change File List style.
FXuint	getFileBoxStyle () const
	Return File List style.
void	allowNavigation (FXbool flag)
	Allow or disallow navigation.
FXbool	allowNavigation () const
	Is navigation allowed?
void	setDraggableFiles (FXbool flag)
	Set draggable files.
FXbool	getDraggableFiles () const
	Are files draggable?
void	setTimeFormat (const FXString &fmt)
	Set file time format.
FXString	getTimeFormat () const
	Return file time format.
void	setAssociations (FXFileAssociations *assoc, FXbool owned=false)
	Change file associations; delete old ones if owned.
FXFileAssociations *	getAssociations () const
	Return file associations.
void	setIconSource (FXIconSource *src)
	Change icon loader.
FXIconSource *	getIconSource () const
	Return icon loader.
virtual void	save (FXStream &store) const
	Save to stream.
virtual void	load (FXStream &store)
	Load from stream.
virtual	~FXFileDialog ()
	Destructor.
Public Member Functions inherited from FX::FXDialogBox
long	onCmdAccept (FXObject *, FXSelector, void *)
long	onCmdCancel (FXObject *, FXSelector, void *)
	FXDialogBox (FXApp *a, const FXString &name, FXuint opts=DECOR_TITLE|DECOR_BORDER, FXint x=0, FXint y=0, FXint w=0, FXint h=0, FXint pl=10, FXint pr=10, FXint pt=10, FXint pb=10, FXint hs=4, FXint vs=4)
	Construct free-floating dialog.
	FXDialogBox (FXWindow *owner, const FXString &name, FXuint opts=DECOR_TITLE|DECOR_BORDER, FXint x=0, FXint y=0, FXint w=0, FXint h=0, FXint pl=10, FXint pr=10, FXint pt=10, FXint pb=10, FXint hs=4, FXint vs=4)
	Construct dialog which will always float over the owner window.
virtual FXuint	execute (FXuint placement=PLACEMENT_CURSOR)
	Run modal invocation of the dialog. More...
Public Member Functions inherited from FX::FXTopWindow
long	onFocusUp (FXObject *, FXSelector, void *)
long	onFocusDown (FXObject *, FXSelector, void *)
long	onFocusLeft (FXObject *, FXSelector, void *)
long	onFocusRight (FXObject *, FXSelector, void *)
long	onSessionNotify (FXObject *, FXSelector, void *)
long	onSessionClosed (FXObject *, FXSelector, void *)
long	onRestore (FXObject *, FXSelector, void *)
long	onMaximize (FXObject *, FXSelector, void *)
long	onMinimize (FXObject *, FXSelector, void *)
long	onCmdRestore (FXObject *, FXSelector, void *)
long	onCmdMaximize (FXObject *, FXSelector, void *)
long	onCmdMinimize (FXObject *, FXSelector, void *)
long	onCmdFullScreen (FXObject *, FXSelector, void *)
long	onCmdClose (FXObject *, FXSelector, void *)
long	onCmdSetStringValue (FXObject *, FXSelector, void *)
long	onCmdGetStringValue (FXObject *, FXSelector, void *)
long	onCmdSetIconValue (FXObject *, FXSelector, void *)
long	onCmdGetIconValue (FXObject *, FXSelector, void *)
virtual void	detach ()
	Detach the server-side resources for this window.
virtual void	layout ()
	Perform layout.
virtual void	setFocus ()
	Move the focus to this window.
virtual void	killFocus ()
	Remove the focus from this window.
virtual void	show ()
	Show this window.
virtual void	hide ()
	Hide this window.
virtual void	show (FXuint placement)
	Show this window with given placement.
void	place (FXuint placement)
	Position the window based on placement.
virtual FXint	getDefaultWidth ()
	Return the default width of this window.
virtual FXint	getDefaultHeight ()
	Return the default height of this window.
FXbool	getWMBorders (FXint &left, FXint &right, FXint &top, FXint &bottom)
	Obtain border sizes added to our window by the window manager.
virtual void	raise ()
	Raise this window to the top of the stacking order.
virtual void	lower ()
	Lower this window to the bottom of the stacking order.
virtual void	move (FXint x, FXint y)
	Move this window to the specified position in the parent's coordinates.
virtual void	resize (FXint w, FXint h)
	Resize this window to the specified width and height.
virtual void	position (FXint x, FXint y, FXint w, FXint h)
	Move and resize this window in the parent's coordinates.
virtual void	flash (FXbool yes)
	Flash the window to get user's attention.
virtual FXbool	restore (FXbool notify=false)
	Restore window to normal, return true if restored.
virtual FXbool	maximize (FXbool notify=false)
	Maximize window, return true if maximized.
virtual FXbool	minimize (FXbool notify=false)
	Minimize or iconify window, return true if minimized.
virtual FXbool	fullScreen (FXbool notify=false)
	Make window full screen, return true if success.
virtual FXbool	stackingOrder (FXuint order)
	Special stacking order level.
virtual FXbool	close (FXbool notify=false)
	Close the window, return true if actually closed. More...
FXbool	isMaximized () const
	Return true if maximized.
FXbool	isMinimized () const
	Return true if minimized.
FXbool	isFullScreen () const
	Return true if full screen.
void	setTitle (const FXString &name)
	Change window title.
FXString	getTitle () const
	Return window title.
void	setPadTop (FXint pt)
	Change top padding.
FXint	getPadTop () const
	Get top interior padding.
void	setPadBottom (FXint pb)
	Change bottom padding.
FXint	getPadBottom () const
	Get bottom interior padding.
void	setPadLeft (FXint pl)
	Change left padding.
FXint	getPadLeft () const
	Get left interior padding.
void	setPadRight (FXint pr)
	Change right padding.
FXint	getPadRight () const
	Get right interior padding.
FXint	getHSpacing () const
	Return horizontal spacing between children.
FXint	getVSpacing () const
	Return vertical spacing between children.
void	setHSpacing (FXint hs)
	Change horizontal spacing between children.
void	setVSpacing (FXint vs)
	Change vertical spacing between children.
void	setPackingHints (FXuint ph)
	Change packing hints for children.
FXuint	getPackingHints () const
	Return packing hints for children.
void	setDecorations (FXuint decorations)
	Change title and border decorations.
FXuint	getDecorations () const
	Return current title and border decorations.
FXIcon *	getIcon () const
	Return window icon.
void	setIcon (FXIcon *ic)
	Change window icon.
FXIcon *	getMiniIcon () const
	Return window mini (title) icon.
void	setMiniIcon (FXIcon *ic)
	Change window mini (title) icon.
virtual	~FXTopWindow ()
	Destructor.
Public Member Functions inherited from FX::FXShell
long	onLayout (FXObject *, FXSelector, void *)
long	onConfigure (FXObject *, FXSelector, void *)
long	onKeyPress (FXObject *, FXSelector, void *)
long	onKeyRelease (FXObject *, FXSelector, void *)
long	onFocusNext (FXObject *, FXSelector, void *)
long	onFocusPrev (FXObject *, FXSelector, void *)
virtual void	recalc ()
	Mark this window's layout as dirty.
virtual	~FXShell ()
	Destroy shell.
Public Member Functions inherited from FX::FXComposite
long	onKeyPress (FXObject *, FXSelector, void *)
long	onKeyRelease (FXObject *, FXSelector, void *)
long	onFocusNext (FXObject *, FXSelector, void *)
long	onFocusPrev (FXObject *, FXSelector, void *)
long	onCmdUpdate (FXObject *, FXSelector, void *)
	FXComposite (FXComposite *p, FXuint opts=0, FXint x=0, FXint y=0, FXint w=0, FXint h=0)
	Constructor.
FXint	maxChildWidth () const
	Return the width of the widest child window.
FXint	maxChildHeight () const
	Return the height of the tallest child window.
virtual FXbool	isComposite () const
	Overrides this virtual function to return true.
virtual	~FXComposite ()
	Destructor.
Public Member Functions inherited from FX::FXWindow
long	onPaint (FXObject *, FXSelector, void *)
long	onMap (FXObject *, FXSelector, void *)
long	onUnmap (FXObject *, FXSelector, void *)
long	onConfigure (FXObject *, FXSelector, void *)
long	onUpdate (FXObject *, FXSelector, void *)
long	onMotion (FXObject *, FXSelector, void *)
long	onMouseWheel (FXObject *, FXSelector, void *)
long	onEnter (FXObject *, FXSelector, void *)
long	onLeave (FXObject *, FXSelector, void *)
long	onLeftBtnPress (FXObject *, FXSelector, void *)
long	onLeftBtnRelease (FXObject *, FXSelector, void *)
long	onMiddleBtnPress (FXObject *, FXSelector, void *)
long	onMiddleBtnRelease (FXObject *, FXSelector, void *)
long	onRightBtnPress (FXObject *, FXSelector, void *)
long	onRightBtnRelease (FXObject *, FXSelector, void *)
long	onSpaceBallMotion (FXObject *, FXSelector, void *)
long	onSpaceBallButtonPress (FXObject *, FXSelector, void *)
long	onSpaceBallButtonRelease (FXObject *, FXSelector, void *)
long	onBeginDrag (FXObject *, FXSelector, void *)
long	onEndDrag (FXObject *, FXSelector, void *)
long	onDragged (FXObject *, FXSelector, void *)
long	onKeyPress (FXObject *, FXSelector, void *)
long	onKeyRelease (FXObject *, FXSelector, void *)
long	onUngrabbed (FXObject *, FXSelector, void *)
long	onDestroy (FXObject *, FXSelector, void *)
long	onFocusSelf (FXObject *, FXSelector, void *)
long	onFocusIn (FXObject *, FXSelector, void *)
long	onFocusOut (FXObject *, FXSelector, void *)
long	onSelectionLost (FXObject *, FXSelector, void *)
long	onSelectionGained (FXObject *, FXSelector, void *)
long	onSelectionRequest (FXObject *, FXSelector, void *)
long	onClipboardLost (FXObject *, FXSelector, void *)
long	onClipboardGained (FXObject *, FXSelector, void *)
long	onClipboardRequest (FXObject *, FXSelector, void *)
long	onDNDEnter (FXObject *, FXSelector, void *)
long	onDNDLeave (FXObject *, FXSelector, void *)
long	onDNDMotion (FXObject *, FXSelector, void *)
long	onDNDDrop (FXObject *, FXSelector, void *)
long	onDNDRequest (FXObject *, FXSelector, void *)
long	onQueryHelp (FXObject *, FXSelector, void *)
long	onQueryTip (FXObject *, FXSelector, void *)
long	onCmdShow (FXObject *, FXSelector, void *)
long	onCmdHide (FXObject *, FXSelector, void *)
long	onUpdToggleShown (FXObject *, FXSelector, void *)
long	onCmdToggleShown (FXObject *, FXSelector, void *)
long	onCmdRaise (FXObject *, FXSelector, void *)
long	onCmdLower (FXObject *, FXSelector, void *)
long	onCmdEnable (FXObject *, FXSelector, void *)
long	onCmdDisable (FXObject *, FXSelector, void *)
long	onUpdToggleEnabled (FXObject *, FXSelector, void *)
long	onCmdToggleEnabled (FXObject *, FXSelector, void *)
long	onCmdUpdate (FXObject *, FXSelector, void *)
long	onUpdYes (FXObject *, FXSelector, void *)
long	onCmdDelete (FXObject *, FXSelector, void *)
	FXWindow (FXComposite *p, FXuint opts=0, FXint x=0, FXint y=0, FXint w=0, FXint h=0)
	Constructor.
FXWindow *	getParent () const
	Return a pointer to the parent window.
FXWindow *	getOwner () const
	Return a pointer to the owner window.
FXWindow *	getNext () const
	Return a pointer to the next (sibling) window, if any.
FXWindow *	getPrev () const
	Return a pointer to the previous (sibling) window , if any.
FXWindow *	getFirst () const
	Return a pointer to this window's first child window , if any.
FXWindow *	getLast () const
	Return a pointer to this window's last child window, if any.
FXWindow *	getFocus () const
	Return a pointer to the currently focused child window.
FXWindow *	getShell () const
	Return a pointer to the shell window.
FXWindow *	getRoot () const
	Return a pointer to the root window.
virtual WindowClass	getWindowClass () const
	Get window class.
void	setKey (FXuint k)
	Change window key.
FXuint	getKey () const
	Return window key.
FXWindow *	getChildWithKey (FXuint k) const
	Return child window with given window key.
void	setTarget (FXObject *t)
	Set the message target object for this window.
FXObject *	getTarget () const
	Get the message target object for this window, if any.
void	setSelector (FXSelector sel)
	Set the message identifier for this window.
FXSelector	getSelector () const
	Get the message identifier for this window.
FXint	getX () const
	Get this window's x-coordinate, in the parent's coordinate system.
FXint	getY () const
	Get this window's y-coordinate, in the parent's coordinate system.
virtual FXint	getWidthForHeight (FXint givenheight)
	Return width for given height.
virtual FXint	getHeightForWidth (FXint givenwidth)
	Return height for given width.
void	setX (FXint x)
	Set this window's x-coordinate, in the parent's coordinate system.
void	setY (FXint y)
	Set this window's y-coordinate, in the parent's coordinate system.
void	setWidth (FXint w)
	Set the window width; and flag the widget as being in need of layout by its parent. More...
void	setHeight (FXint h)
	Set the window height; and flag the widget as being in need of layout by its parent. More...
void	setLayoutHints (FXuint lout)
	Set layout hints for this window.
FXuint	getLayoutHints () const
	Get layout hints for this window.
FXAccelTable *	getAccelTable () const
	Return a pointer to the accelerator table.
void	setAccelTable (FXAccelTable *acceltable)
	Set the accelerator table.
void	addHotKey (FXHotKey code)
	Add a hot key.
void	remHotKey (FXHotKey code)
	Remove a hot key.
void	setHelpTag (const FXString &text)
	Change help tag for this widget.
const FXString &	getHelpTag () const
	Get the help tag for this widget.
FXbool	isShell () const
	Return true if window is a shell window.
FXbool	isOwnerOf (const FXWindow *window) const
	Return true if specified window is owned by this window.
FXbool	isChildOf (const FXWindow *window) const
	Return true if specified window is ancestor of this window.
FXbool	containsChild (const FXWindow *child) const
	Return true if this window contains child in its subtree.
FXWindow *	getChildAt (FXint x, FXint y) const
	Return the child window at specified coordinates.
FXint	numChildren () const
	Return the number of child windows for this window.
FXint	indexOfChild (const FXWindow *window) const
	Return the index (starting from zero) of the specified child window, or -1 if the window is not a child or NULL.
FXWindow *	childAtIndex (FXint index) const
	Return the child window at specified index, or NULL if the index is negative or out of range.
FXComposeContext *	getComposeContext () const
	Return compose context.
void	createComposeContext ()
	Create compose context.
void	destroyComposeContext ()
	Destroy compose context.
FXbool	cursorShown () const
	Is cursor shown.
void	showCursor (FXbool flag=true)
	Show or hide the cursor.
void	setDefaultCursor (FXCursor *cur)
	Set the default cursor for this window.
FXCursor *	getDefaultCursor () const
	Return the default cursor for this window.
void	setDragCursor (FXCursor *cur)
	Set the drag cursor for this window.
FXCursor *	getDragCursor () const
	Return the drag cursor for this window.
FXbool	getCursorPosition (FXint &x, FXint &y, FXuint &buttons) const
	Return the cursor position and mouse button-state.
FXbool	setCursorPosition (FXint x, FXint y)
	Warp the cursor to the new position.
FXbool	isActive () const
	Return true if the window is active.
virtual FXbool	canFocus () const
	Return true if this window is a control capable of receiving the focus.
FXbool	hasFocus () const
	Return true if this window has the focus.
FXbool	inFocusChain () const
	Return true if this window is in focus chain.
FXbool	isDefault () const
	Return true if this is the default window.
virtual void	setDefault (FXuchar flag=true)
	This changes the default window which responds to the Return key in a dialog. More...
FXWindow *	findDefault () const
	Find default window among this window's children.
FXbool	isInitial () const
	Return true if this is the initial default window.
void	setInitial (FXbool flag=true)
	Make this window the initial default window.
FXWindow *	findInitial () const
	Find inital default window among this window's children.
FXbool	isEnabled () const
	Return true if this window is able to receive mouse and keyboard events.
virtual void	enable ()
	Enable the window to receive mouse and keyboard events.
virtual void	disable ()
	Disable the window from receiving mouse and keyboard events.
virtual void	attach (FXID w)
	Attach foreign window handle to this window.
virtual void	setShape (const FXRegion &region)
	Set window shape by means of region.
virtual void	setShape (FXBitmap *bitmap)
	Set window shape by means of bitmap.
virtual void	setShape (FXIcon *icon)
	Set window shape by means of icon.
virtual void	clearShape ()
	Clear window shape.
void	forceRefresh ()
	Generate a SEL_UPDATE message for the window and its children.
virtual void	reparent (FXWindow *father, FXWindow *other=nullptr)
	Reparent this window under new father before other.
void	scroll (FXint x, FXint y, FXint w, FXint h, FXint dx, FXint dy) const
	Scroll rectangle x,y,w,h by a shift of dx,dy.
void	update (FXint x, FXint y, FXint w, FXint h) const
	Mark the specified rectangle to be repainted later.
void	update () const
	Mark the entire window to be repainted later.
void	repaint (FXint x, FXint y, FXint w, FXint h) const
	Process any outstanding repaint messages immediately, for the given rectangle.
void	repaint () const
	Process any outstanding repaint messages immediately.
FXbool	grabbed () const
	Return true if the window has been grabbed.
void	grab ()
	Grab the mouse to this window; future mouse events will be reported to this window even while the cursor goes outside of this window.
void	ungrab ()
	Release the mouse grab.
FXbool	grabbedKeyboard () const
	Return true if active grab is in effect.
void	grabKeyboard ()
	Grab keyboard device.
void	ungrabKeyboard ()
	Ungrab keyboard device.
FXbool	shown () const
	Return true if the window is shown.
FXbool	underCursor () const
	Return true if the window is under the cursor.
FXbool	hasSelection () const
	Return true if this window owns the primary selection.
FXbool	acquireSelection (const FXDragType *types, FXuint numtypes)
	Try to acquire the primary selection, given a list of drag types.
FXbool	releaseSelection ()
	Release the primary selection.
FXbool	hasClipboard () const
	Return true if this window owns the clipboard.
FXbool	acquireClipboard (const FXDragType *types, FXuint numtypes)
	Try to acquire the clipboard, given a list of drag types.
FXbool	releaseClipboard ()
	Release the clipboard.
FXbool	isDropEnabled () const
	Return true if this window is able to receive drops.
virtual void	dropEnable ()
	Enable this window to receive drops.
virtual void	dropDisable ()
	Disable this window from receiving drops.
FXbool	isDragging () const
	Return true if a drag operaion has been initiated from this window.
FXbool	beginDrag (const FXDragType *types, FXuint numtypes)
	Initiate a drag operation with a list of previously registered drag types.
FXbool	handleDrag (FXint x, FXint y, FXDragAction action=DRAG_COPY)
	When dragging, inform the drop-target of the new position and the drag action.
FXDragAction	endDrag (FXbool drop=true)
	Terminate the drag operation with or without actually dropping the data Returns the action performed by the target.
FXbool	isDropTarget () const
	Return true if this window is the target of a drop.
void	setDragRectangle (FXint x, FXint y, FXint w, FXint h, FXbool wantupdates=true) const
	When being dragged over, indicate that no further SEL_DND_MOTION messages are required while the cursor is inside the given rectangle.
void	clearDragRectangle () const
	When being dragged over, indicate we want to receive SEL_DND_MOTION messages every time the cursor moves.
void	acceptDrop (FXDragAction action=DRAG_ACCEPT) const
	When being dragged over, indicate acceptance or rejection of the dragged data.
FXDragAction	didAccept () const
	The target accepted our drop.
void	dropFinished (FXDragAction action=DRAG_REJECT) const
	Sent by the drop target in response to SEL_DND_DROP. More...
FXbool	inquireDNDTypes (FXDNDOrigin origin, FXDragType *&types, FXuint &numtypes) const
	When being dragged over, inquire the drag types which are being offered.
FXbool	offeredDNDType (FXDNDOrigin origin, FXDragType type) const
	When being dragged over, return true if we are offered the given drag type.
FXDragAction	inquireDNDAction () const
	When being dragged over, return the drag action.
FXbool	setDNDData (FXDNDOrigin origin, FXDragType type, FXuchar *data, FXuint size) const
	Set DND data; the array must be allocated with allocElms() and ownership is transferred to the system.
FXbool	setDNDData (FXDNDOrigin origin, FXDragType type, const FXString &string) const
	Set DND data from string value.
FXbool	getDNDData (FXDNDOrigin origin, FXDragType type, FXuchar *&data, FXuint &size) const
	Get DND data; the caller becomes the owner of the array and must free it with freeElms().
FXbool	getDNDData (FXDNDOrigin origin, FXDragType type, FXString &string) const
	Get DND data into string value.
virtual FXbool	contains (FXint parentx, FXint parenty) const
	Return true if window logically contains the given point.
void	translateCoordinatesFrom (FXint &tox, FXint &toy, const FXWindow *fromwindow, FXint fromx, FXint fromy) const
	Translate coordinates from fromwindow's coordinate space to this window's coordinate space.
void	translateCoordinatesTo (FXint &tox, FXint &toy, const FXWindow *towindow, FXint fromx, FXint fromy) const
	Translate coordinates from this window's coordinate space to towindow's coordinate space.
virtual void	setBackColor (FXColor clr)
	Set window background color.
FXColor	getBackColor () const
	Get background color.
virtual FXbool	doesSaveUnder () const
	Does save-unders.
virtual const FXchar *	tr (const FXchar *text, const FXchar *hint=nullptr, FXint count=-1) const FX_FORMAT(2)
	Translate message for localization; using the current FXTranslator, an attempt is made to translate the given message into the current language. More...
virtual	~FXWindow ()
	Destroy window.
Public Member Functions inherited from FX::FXDrawable
FXVisual *	getVisual () const
	Get the visual.
FXint	getWidth () const
	Width of drawable.
FXint	getHeight () const
	Height of drawable.
void	setVisual (FXVisual *vis)
	Change visual.
virtual	~FXDrawable ()
	Cleanup.
Public Member Functions inherited from FX::FXId
FXApp *	getApp () const
	Get application.
FXID	id () const
	Get XID handle.
void	setUserData (FXptr ptr)
	Set user data pointer.
FXptr	getUserData () const
	Get user data pointer.
virtual	~FXId ()
	Destructor.
Public Member Functions inherited from FX::FXObject
const FXchar *	getClassName () const
	Get class name of some object.
FXbool	isMemberOf (const FXMetaClass *metaclass) const
	Check if object is member of metaclass.
virtual long	tryHandle (FXObject *sender, FXSelector sel, void *ptr)
	Try handle message safely, catching certain exceptions.
virtual long	onDefault (FXObject *, FXSelector, void *)
	Called for unhandled messages.
virtual	~FXObject ()
	Virtual destructor.

Static Public Member Functions
static FXString	getOpenFilename (FXWindow *owner, const FXString &caption, const FXString &path, const FXString &patterns="*", FXint initial=0)
	Open existing filename. More...
static FXString *	getOpenFilenames (FXWindow *owner, const FXString &caption, const FXString &path, const FXString &patterns="*", FXint initial=0)
	Open multiple existing files. More...
static FXString	getSaveFilename (FXWindow *owner, const FXString &caption, const FXString &path, const FXString &patterns="*", FXint initial=0)
	Save to filename. More...
static FXString	getOpenDirectory (FXWindow *owner, const FXString &caption, const FXString &path)
	Open directory name. More...
Static Public Member Functions inherited from FX::FXWindow
static FXWindow *	commonAncestor (FXWindow *a, FXWindow *b)
	Return the common ancestor of window a and window b.
static FXbool	before (const FXWindow *a, const FXWindow *b)
	Return true if sibling a <= sibling b in list.
static FXbool	after (const FXWindow *a, const FXWindow *b)
	Return true if sibling a >= sibling b in list.

Protected Member Functions
void	readRegistry ()
void	writeRegistry ()
Protected Member Functions inherited from FX::FXTopWindow
void	settitle ()
void	seticons ()
void	setdecorations ()
	FXTopWindow (FXApp *ap, const FXString &name, FXIcon *ic, FXIcon *mi, FXuint opts, FXint x, FXint y, FXint w, FXint h, FXint pl, FXint pr, FXint pt, FXint pb, FXint hs, FXint vs)
	FXTopWindow (FXWindow *ow, const FXString &name, FXIcon *ic, FXIcon *mi, FXuint opts, FXint x, FXint y, FXint w, FXint h, FXint pl, FXint pr, FXint pt, FXint pb, FXint hs, FXint vs)
Protected Member Functions inherited from FX::FXShell
	FXShell (FXApp *a, FXuint opts, FXint x, FXint y, FXint w, FXint h)
	FXShell (FXWindow *own, FXuint opts, FXint x, FXint y, FXint w, FXint h)
Protected Member Functions inherited from FX::FXComposite
	FXComposite (FXApp *a, FXVisual *vis)
	FXComposite (FXApp *a, FXWindow *own, FXuint opts, FXint x, FXint y, FXint w, FXint h)
Protected Member Functions inherited from FX::FXWindow
virtual FXbool	doesOverrideRedirect () const
void	addColormapWindows ()
void	remColormapWindows ()
	FXWindow (FXApp *a, FXVisual *vis)
	FXWindow (FXApp *a, FXWindow *own, FXuint opts, FXint x, FXint y, FXint w, FXint h)
Protected Member Functions inherited from FX::FXDrawable
	FXDrawable (FXApp *a, FXint w, FXint h)
Protected Member Functions inherited from FX::FXId
	FXId (FXApp *a)

Protected Attributes
FXFileSelector *	filebox
Protected Attributes inherited from FX::FXTopWindow
FXString	title
FXIcon *	icon
FXIcon *	miniIcon
FXint	padtop
FXint	padbottom
FXint	padleft
FXint	padright
FXint	hspacing
FXint	vspacing
Protected Attributes inherited from FX::FXWindow
FXComposeContext *	composeContext
FXCursor *	defaultCursor
FXCursor *	dragCursor
FXAccelTable *	accelTable
FXObject *	target
FXSelector	message
FXint	xpos
FXint	ypos
FXColor	backColor
FXString	tag
FXuint	flags
FXuint	options
Protected Attributes inherited from FX::FXDrawable
FXVisual *	visual
FXint	width
FXint	height
Protected Attributes inherited from FX::FXId
FXID	xid

Static Protected Attributes
static const FXchar	sectionName []

Additional Inherited Members
Public Types inherited from FX::FXDialogBox
enum	{ ID_CANCEL =FXTopWindow::ID_LAST, ID_ACCEPT, ID_LAST }
Public Types inherited from FX::FXTopWindow
enum	{   ID_RESTORE =FXShell::ID_LAST, ID_MAXIMIZE, ID_MINIMIZE, ID_FULLSCREEN,   ID_CLOSE, ID_QUERY_DOCK, ID_LAST }
Public Types inherited from FX::FXShell
enum	{ ID_LAYOUT =FXComposite::ID_LAST, ID_LAST }
Public Types inherited from FX::FXWindow
enum	WindowClass {   ClassNormal, ClassGraphic, ClassSpecial, ClassRoot,   ClassShell, ClassPopup, ClassToolTip, ClassMain,   ClassDialog, ClassToolBar, ClassSplash, ClassNotify,   ClassPanel, ClassDesktop }
	Window classes. More...
enum	{   ID_NONE, ID_HIDE, ID_SHOW, ID_TOGGLESHOWN,   ID_LOWER, ID_RAISE, ID_DELETE, ID_DISABLE,   ID_ENABLE, ID_TOGGLEENABLED, ID_UNCHECK, ID_CHECK,   ID_UNKNOWN, ID_UPDATE, ID_TIPTIMER, ID_SETVALUE,   ID_SETINTVALUE, ID_SETLONGVALUE, ID_SETREALVALUE, ID_SETSTRINGVALUE,   ID_SETICONVALUE, ID_SETINTRANGE, ID_SETREALRANGE, ID_GETINTVALUE,   ID_GETLONGVALUE, ID_GETREALVALUE, ID_GETSTRINGVALUE, ID_GETICONVALUE,   ID_GETINTRANGE, ID_GETREALRANGE, ID_SETHELPSTRING, ID_GETHELPSTRING,   ID_SETTIPSTRING, ID_GETTIPSTRING, ID_QUERY_MENU, ID_HOTKEY,   ID_ACCEL, ID_UNPOST, ID_POST, ID_MDI_TILEHORIZONTAL,   ID_MDI_TILEVERTICAL, ID_MDI_CASCADE, ID_MDI_MAXIMIZE, ID_MDI_MINIMIZE,   ID_MDI_RESTORE, ID_MDI_CLOSE, ID_MDI_WINDOW, ID_MDI_MENUWINDOW,   ID_MDI_MENUMINIMIZE, ID_MDI_MENURESTORE, ID_MDI_MENUCLOSE, ID_MDI_NEXT,   ID_MDI_PREV, ID_LAST }
Static Public Attributes inherited from FX::FXWindow
static FXDragType	octetType
static FXDragType	deleteType
static FXDragType	textType
static FXDragType	colorType
static FXDragType	urilistType
static FXDragType	utf8Type
static FXDragType	utf16Type
static FXDragType	actionType
static const FXDragType	stringType
static const FXDragType	imageType
static const FXchar	octetTypeName []
static const FXchar	deleteTypeName []
static const FXchar	textTypeName []
static const FXchar	colorTypeName []
static const FXchar	urilistTypeName []
static const FXchar	utf8TypeName []
static const FXchar	utf16TypeName []
static const FXchar	actionTypeName []
Protected Types inherited from FX::FXWindow
enum	{   FLAG_SHOWN = 0x00000001, FLAG_ENABLED = 0x00000002, FLAG_UPDATE = 0x00000004, FLAG_DROPTARGET = 0x00000008,   FLAG_FOCUSED = 0x00000010, FLAG_DIRTY = 0x00000020, FLAG_RECALC = 0x00000040, FLAG_TIP = 0x00000080,   FLAG_HELP = 0x00000100, FLAG_DEFAULT = 0x00000200, FLAG_INITIAL = 0x00000400, FLAG_SHELL = 0x00000800,   FLAG_ACTIVE = 0x00001000, FLAG_PRESSED = 0x00002000, FLAG_KEY = 0x00004000, FLAG_CARET = 0x00008000,   FLAG_CHANGED = 0x00010000, FLAG_LASSO = 0x00020000, FLAG_TRYDRAG = 0x00040000, FLAG_DODRAG = 0x00080000,   FLAG_SCROLLINSIDE = 0x00100000, FLAG_SCROLLING = 0x00200000, FLAG_OWNED = 0x00400000, FLAG_CURSOR = 0x00800000 }

Detailed Description

File selection dialog.

Member Function Documentation

getOpenDirectory()

static FXString FX::FXFileDialog::getOpenDirectory ( FXWindow *  owner, const FXString &  caption, const FXString &  path  )

static

Open directory name.

The new dialog will have the given caption and select the indicated path. Files will be filtered by the pattern or patterns. If there is more than one pattern, the initial pattern will be selected in the drop-down box of the file dialog.

getOpenFilename()

static FXString FX::FXFileDialog::getOpenFilename ( FXWindow *  owner, const FXString &  caption, const FXString &  path, const FXString &  patterns = "*", FXint  initial = 0  )

static

Open existing filename.

The new dialog will have the given caption and select the indicated path. Files will be filtered by the pattern or patterns. If there is more than one pattern, the initial pattern will be selected in the drop-down box of the file dialog.

getOpenFilenames()

static FXString* FX::FXFileDialog::getOpenFilenames ( FXWindow *  owner, const FXString &  caption, const FXString &  path, const FXString &  patterns = "*", FXint  initial = 0  )

static

Open multiple existing files.

The new dialog will have the given caption and select the indicated path. Files will be filtered by the pattern or patterns. If there is more than one pattern, the initial pattern will be selected in the drop-down box of the file dialog. The return value of this function is an array of strings; the last item in the array is an empty string.

getSaveFilename()

static FXString FX::FXFileDialog::getSaveFilename ( FXWindow *  owner, const FXString &  caption, const FXString &  path, const FXString &  patterns = "*", FXint  initial = 0  )

static

Save to filename.

The new dialog will have the given caption and select the indicated path. Files will be filtered by the pattern or patterns. If there is more than one pattern, the initial pattern will be selected in the drop-down box of the file dialog.

setPatternList()

void FX::FXFileDialog::setPatternList

(

const FXString &

patterns

)

Change the list of file patterns shown in the file dialog.

Each pattern comprises an optional name, followed by a pattern in parentheses. The patterns are separated by newlines. For example,

"*\n*.cpp,*.cc\n*.hpp,*.hh,*.h"

and

"All Files (*)\nC++ Sources (*.cpp,*.cc)\nC++ Headers (*.hpp,*.hh,*.h)"

will set the same three patterns, but the former shows no pattern names.

---

The documentation for this class was generated from the following file:

• /home/jeroen/FOX/fox/fox-1.7.86/include/FXFileDialog.h