XmFileSelectionBox(3X)XmFileSelectionBox(3X)NAMEXmFileSelectionBox - The FileSelectionBox widget class
SYNOPSIS
#include <Xm/FileSB.h>
DESCRIPTION
FileSelectionBox traverses through directories, views the files and
subdirectories in them, and then selects files.
A FileSelectionBox has five main areas: A text input field for display‐
ing and editing a directory mask used to select the files to be dis‐
played A scrollable list of filenames A scrollable list of subdirecto‐
ries A text input field for displaying and editing a filename A group
of PushButtons, labeled OK, Filter, Cancel, and Help
Additional children may be added to the FileSelectionBox after cre‐
ation. FileSelectionBox inherits the layout functionality provided by
SelectionBox for any additional children. The list of filenames, the
list of subdirectories, or both can be removed from the FileSelection‐
Box after creation by unmanaging the appropriate widgets and their
labels. The list and label widgets are obtained by calling the function
XmFileSelectionBoxGetChild. To remove either the directory list or the
file list, unmanage the parent of the appropriate list widget and
unmanage the corresponding label.
The user can specify resources in a resource file for the automatically
created widgets and gadgets of FileSelectionBox. The following list
identifies the names of these widgets (or gadgets) and the associated
FileSelectionBox areas.
Filter Label--“FilterLabel”:
Filter Text--“Text”
Directory List--“DirList”
Directory List Label--“Dir”
The directory mask is a string specifying the base directory to be
examined and a search pattern. Ordinarily, the directory list displays
the subdirectories of the base directory, as well as the base directory
itself and its parent directory. The file list ordinarily displays all
files and/or subdirectories in the base directory that match the search
pattern.
A procedure specified by the XmNqualifySearchDataProc resource extracts
the base directory and search pattern from the directory mask. If the
directory specification is empty, the current working directory is
used. If the search pattern is empty, a pattern that matches all files
is used.
An application can supply its own XmNqualifySearchDataProc as well as
its own procedures to search for subdirectories and files. The default
XmNqualifySearchDataProc works as follows: The directory mask is a
pathname that can contain zero or more wildcard characters in its
directory portion, its file portion, or both.
The directory components of the directory mask up to, but not includ‐
ing, the first component with a wildcard character specify the direc‐
tory to be searched, relative to the current working directory. The
remaining components specify the search pattern. If the directory mask
is empty or if its first component contains a wildcard character, the
current working directory is searched. If no component of the directory
mask contains a wildcard character, the entire directory mask is the
directory specification, and all files in that directory are matched.
The user can select a new directory to examine by scrolling through the
list of directories and selecting the desired directory or by editing
the directory mask. Selecting a new directory from the directory list
does not change the search pattern. A user can select a new search pat‐
tern by editing the directory mask. Double clicking or pressing KActi‐
vate on a directory in the directory list initiates a search for files
and subdirectories in the new directory, using the current search pat‐
tern.
The user can select a file by scrolling through the list of filenames
and selecting the desired file or by entering the filename directly
into the text edit area. Selecting a file from the list causes that
filename to appear in the file selection text edit area.
The user may select a new file as many times as desired. The applica‐
tion is not notified until the user takes one of these actions: Selects
the OK PushButton. Presses KActivate while the selection text edit
area has the keyboard focus. Double clicks or presses KActivate on an
item in the file list
FileSelectionBox initiates a directory and file search when any of the
following occurs: The FileSelectionBox is initialized The function
XtSetValues is used to change XmNdirMask, XmNdirectory, XmNpattern, or
XmNfileTypeMask The user activates the Filter PushButton The user dou‐
ble clicks or presses KActivate on an item in the directory list The
application calls XmFileSelectionDoSearch The user presses KActivate
while the directory mask text edit area has the keyboard focus
When a file search is initiated, the FileSelectionBox takes the follow‐
ing actions: Constructs an XmFileSelectionBoxCallbackStruct structure
with values appropriate for the action that initiated the search Calls
the XmNqualifySearchDataProc with the callback structure as the data
input argument Sets XmNdirectoryValid and XmNlistUpdated to False Calls
the XmNdirSearchProc with the qualified data returned by the XmNquali‐
fySearchDataProc
If XmNdirectoryValid is True, the FileSelectionBox takes these addi‐
tional actions: Sets XmNlistUpdated to False Calls the XmNfileSearch‐
Proc with the qualified data returned by the XmNqualifySearchDataProc
(and possibly modified by the XmNdirSearchProc) If XmNlistUpdated is
True and the file list is empty, displays the XmNnoMatchString in the
file list and clears the selection text and XmNdirSpec If XmNlistUp‐
dated is True and the file list is not empty, sets the selection text
and XmNdirSpec to the qualified dir returned by the XmNqualifySearch‐
DataProc (and possibly modified by the XmNdirSearchProc) Sets the
directory mask text and XmNdirMask to the qualified mask returned by
the XmNqualifySearchDataProc (and possibly modified by the
XmNdirSearchProc) Sets XmNdirectory to the qualified dir returned by
the XmNqualifySearchDataProc (and possibly modified by the
XmNdirSearchProc) Sets XmNpattern to the qualified pattern returned by
the XmNqualifySearchDataProc (and possibly modified by the
XmNdirSearchProc)
Classes
FileSelectionBox inherits behavior and resources from Core, Composite,
Constraint, XmManager, XmBulletinBoard, and XmSelectionBox.
The class pointer is xmFileSelectionBoxWidgetClass.
The class name is XmFileSelectionBox.
New Resources
The following table defines a set of widget resources used by the pro‐
grammer to specify data. The programmer can also set the resource val‐
ues for the inherited classes to set attributes for this widget. To
reference a resource by name or by class in a .Xdefaults file, remove
the XmN or XmC prefix and use the remaining letters. To specify one of
the defined values for a resource in a .Xdefaults file, remove the Xm
prefix and use the remaining letters (in either lowercase or uppercase,
but include any underscores between words). The codes in the access
column indicate if the given resource can be set at creation time (C),
set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
not applicable (N/A).
XmFileSelectionBox Resource Set
Class: XmCDirectory
Default: dynamic
Type: XmString
Access: CSG
Class: XmCDirectoryValid
Default: dynamic
Type: Boolean
Access: SG
Class: XmCDirListItems
Default: dynamic
Type: XmStringTable
Access: SG
Class: XmCDirListItemCount
Default: dynamic
Type: int
Access: SG
Class: XmCDirListLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCDirMask
Default: dynamic
Type: XmString
Access: CSG
Class: XmCDirSearchProc
Default: default procedure
Type: XmSearchProc
Access: CSG
Class: XmCDirSpec
Default: dynamic
Type: XmString
Access: CSG
Class: XmCItems
Default: dynamic
Type: XmStringTable
Access: SG
Class: XmCItemCount
Default: dynamic
Type: int
Access: SG
Class: XmCFileListLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCFileSearchProc
Default: default procedure
Type: XmSearchProc
Access: CSG
Class: XmCFileTypeMask
Default: XmFILE_REGULAR
Type: unsigned char
Access: CSG
Class: XmCFilterLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCListUpdated
Default: dynamic
Type: Boolean
Access: SG
Class: XmCNoMatchString
Default: " [ ] "
Type: XmString
Access: CSG
Class: XmCPattern
Default: dynamic
Type: XmString
Access: CSG
Class: XmCQualifySearchDataProc
Default: default procedure
Type: XmQualifyProc
Access: CSG
Specifies the base directory used in combination with XmNpattern in
determining the files and directories to be displayed. The default
value is determined by the XmNqualifySearchDataProc and depends on the
initial values of XmNdirMask, XmNdirectory, and XmNpattern. If the
default is NULL or empty, the current working directory is used. Spec‐
ifies an attribute that is set only by the directory search procedure.
The value is set to True if the directory passed to the directory
search procedure can actually be searched. If this value is False the
file search procedure is not called, and XmNdirMask, XmNdirectory, and
XmNpattern are not changed. Specifies the items in the directory list.
XtGetValues for this resource returns the list items themselves, not a
copy of the list items. The application must not free the returned
items. Specifies the number of items in the directory list. The value
must not be negative. Specifies the label string of the directory
list. The default for this resource depends on the locale. In the C
locale the default is “Directories”. Specifies the directory mask used
in determining the files and directories to be displayed. The default
value is determined by the XmNqualifySearchDataProc and depends on the
initial values of XmNdirMask, XmNdirectory, and XmNpattern. Specifies
a directory search procedure to replace the default directory-search
procedure. FileSelectionBox's default directory-search procedure ful‐
fills the needs of most applications. Because it is impossible to cover
the requirements of all applications, you can replace the default
search procedure.
The directory search procedure is called with two arguments: the
FileSelectionBox widget and a pointer to an XmFileSelectionBox‐
CallbackStruct structure. The callback structure is generated by
the XmNqualifySearchDataProc and contains all information
required to conduct a directory search, including the directory
mask and a qualified base directory and search pattern. Once
called, it is up to the search routine to generate a new list of
directories and update the FileSelectionBox widget by using
XtSetValues.
The search procedure must set XmNdirectoryValid and XmNlistUp‐
dated. If it generates a new list of directories, it must also
set XmNdirListItems and XmNdirListItemCount.
If the search procedure cannot search the specified directory,
it must warn the user and set XmNdirectoryValid and XmNlistUp‐
dated to False, unless it prompts and subsequently obtains a
valid directory. If the directory is valid but is the same as
the current XmNdirectory, the search procedure must set XmNdi‐
rectoryValid to True, but it may elect not to generate a new
list of directories. In this case is must set XmNlistUpdated to
False.
If the search procedure generates a new list of directories, it
must set XmNdirListItems to the new list of directories and
XmNdirListItemCount to the number of items in the list. If there
are no directories, it sets XmNdirListItems to NULL and
XmNdirListItemCount to 0. In either case it must set XmNdirecto‐
ryValid and XmNlistUpdated to True.
The search procedure ordinarily should not change the callback
struct. But if the original directory is not valid, the search
procedure may obtain a new directory from the user. In this case
it should set the dir member of the callback struct to the new
directory, call the XmNqualifySearchDataProc with the callback
struct as the input argument, and copy the qualified data
returned by the XmNqualifySearchDataProc into the callback
struct. Specifies the full file path specification. This is the
XmNtextString resource in SelectionBox, renamed for FileSelec‐
tionBox. The default value is determined by the FileSelectionBox
after conducting the initial directory and file search. Speci‐
fies the items in the file list. This is the XmNlistItems
resource in SelectionBox, renamed for FileSelectionBox. XtGet‐
Values for this resource returns the list items themselves, not
a copy of the list items. The application must not free the
returned items. Specifies the number of items in the file list.
This is the XmNlistItemCount resource in SelectionBox, renamed
for FileSelectionBox. The value must not be negative. Specifies
the label string of the file list. This is the XmNlistLabel‐
String resource in SelectionBox, renamed for FileSelectionBox.
The default for this resource depends on the locale. In the C
locale the default is “Files”. Specifies a file search proce‐
dure to replace the default file-search procedure. FileSelec‐
tionBox's default file-search procedure fulfills the needs of
most applications. Because it is impossible to cover the
requirements of all applications, you can replace the default
search procedure.
The file search procedure is called with two arguments: the
FileSelectionBox widget and a pointer to an XmFileSelectionBox‐
CallbackStruct structure. The callback structure is generated by
the XmNqualifySearchDataProc (and possibly modified by the
XmNdirSearchProc). It contains all information required to con‐
duct a file search, including the directory mask and a qualified
base directory and search pattern. Once called, it is up to the
search routine to generate a new list of files and update the
FileSelectionBox widget by using XtSetValues.
The search procedure must set XmNlistUpdated. If it generates a
new list of files, it must also set XmNfileListItems and XmN‐
fileListItemCount.
The search procedure is recommended always to generate a new
list of files. If the mask member of the callback struct is the
same as the mask member of the callback struct in the preceding
call to the search procedure, the procedure may elect not to
generate a new list of files. In this case it must set XmNlis‐
tUpdated to False.
If the search procedure generates a new list of files, it must
set XmNfileListItems to the new list of files and XmNfileLis‐
tItemCount to the number of items in the list. If there are no
files, it sets XmNfileListItems to NULL and XmNfileListItemCount
to 0. In either case it must set XmNlistUpdated to True.
In constructing the list of files, the search procedure should
include only files of the types specified by the widget's XmN‐
fileTypeMask.
Setting XmNdirSpec is optional, but recommended. Set this
attribute to the full file specification of the directory
searched. The directory specification is displayed below the
directory and file lists. Specifies the type of files listed in
the file list. Following are the possible values: XmFILE_REGULAR
restricts the file list to contain only regular files.
XmFILE_DIRECTORY restricts the file list to contain only direc‐
tories. XmFILE_ANY_TYPE allows the list to contain all file
types including directories. Specifies the label string for the
text entry field for the directory mask. The default for this
resource depends on the locale. In the C locale the default is
“Filter”. Specifies an attribute that is set only by the direc‐
tory and file search procedures. Set to True if the search pro‐
cedure updated the directory or file list. Specifies a string
to be displayed in the file list if the list of files is empty.
Specifies the search pattern used in combination with XmNdirec‐
tory in determining the files and directories to be displayed.
The default value is determined by the XmNqualifySearchDataProc
and depends on the initial values of XmNdirMask, XmNdirectory,
and XmNpattern. If the default is NULL or empty, a pattern that
matches all files is used. Specifies a search data qualifica‐
tion procedure to replace the default data qualification proce‐
dure. FileSelectionBox's default data qualification procedure
fulfills the needs of most applications. Because it is impossi‐
ble to cover the requirements of all applications, you can
replace the default procedure.
The data qualification procedure is called to generate a quali‐
fied directory mask, base directory, and search pattern for use
by the directory and file search procedures. It is called with
three arguments: the FileSelectionBox widget and pointers to two
XmFileSelectionBoxCallbackStruct structures. The first callback
struct contains the input data. The second callback struct con‐
tains the output data, to be filled in by the data qualification
procedure.
If the input dir and pattern members are not NULL, the procedure
must copy them to the corresponding members of the output call‐
back struct.
If the input dir is NULL, the procedure constructs the output
dir as follows: If the input mask member is NULL, the procedure
uses the widget's XmNdirectory as the output dir; otherwise, it
extracts the output dir from the input mask. If the resulting
output dir is empty, the procedure uses the current working
directory instead.
If the input pattern is NULL, the procedure constructs the out‐
put pattern as follows: If the input mask member is NULL, the
procedure uses the widget's XmNpattern as the output pattern;
otherwise, it extracts the output pattern from the input mask.
If the resulting output pattern is empty, the procedure uses a
pattern that matches all files instead.
The data qualification procedure constructs the output mask from
the output dir and pattern. The procedure must ensure that the
output dir, pattern, and mask are fully qualified.
If the input value member is not NULL, the procedure must copy
it to the output value member; otherwise, the procedure must
copy the widget's XmNdirSpec to the output value.
The data qualification procedure must calculate the lengths of
the output value, mask, dir, and pattern members and must fill
in the corresponding length members of the output callback
struct.
The data qualification procedure must copy the input reason and
event members to the corresponding output members.
The values of the XmNdirSearchProc and XmNfileSearchProc are procedure
pointers of type XmSearchProc, defined as follows:
void (* XmSearchProc) (w, search_data)
Widget w;
XtPointer search_data;
The FileSelectionBox widget Pointer to an XmFileSelectionBoxCallback‐
Struct containing information for conducting a search
The value of the XmNqualifySearchDataProc resource is a procedure
pointer of type XmQualifyProc, defined as follows:
void (* XmQualifyProc) (w, input_data, output_data)
Widget w;
XtPointer input_data;
XtPointer output_data;
The FileSelectionBox widget Pointer to an XmFileSelectionBoxCallback‐
Struct containing input data to be qualified Pointer to an XmFileSelec‐
tionBoxCallbackStruct containing output data to be filled in by the
qualification procedure
Inherited Resources
FileSelectionBox inherits behavior and resources from the following
superclasses. For a complete description of each resource, refer to the
man page for that superclass.
XmSelectionBox Resource Set
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCApplyLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCCancelLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCChildPlacement
Default: XmPLACE_ABOVE_SELECTION
Type: unsigned char
Access: CSG
Class: XmCDialogType
Default: XmDIALOG_FILE_SELECTION
Type: unsigned char
Access: G
Class: XmCHelpLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCItemCount
Default: dynamic
Type: int
Access: CSG
Class: XmCItems
Default: dynamic
Type: XmStringTable
Access: CSG
Class: XmCListLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCVisibleItemCount
Default: dynamic
Type: int
Access: CSG
Class: XmCMinimizeButtons
Default: False
Type: Boolean
Access: CSG
Class: XmCMustMatch
Default: False
Type: Boolean
Access: CSG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCOkLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCSelectionLabelString
Default: dynamic
Type: XmString
Access: CSG
Class: XmCTextAccelerators
Default: default
Type: XtAccelerators
Access: C
Class: XmCColumns
Default: dynamic
Type: short
Access: CSG
Class: XmCTextString
Default: dynamic
Type: XmString
Access: CSG
XmBulletinBoard Resource Set
Class: XmCAllowOverlap
Default: True
Type: Boolean
Access: CSG
Class: XmCAutoUnmanage
Default: False
Type: Boolean
Access: CG
Class: XmCButtonFontList
Default: dynamic
Type: XmFontList
Access: CSG
Class: XmCWidget
Default: Cancel button
Type: Widget
Access: SG
Class: XmCWidget
Default: OK button
Type: Widget
Access: SG
Class: XmCDefaultPosition
Default: True
Type: Boolean
Access: CSG
Class: XmCDialogStyle
Default: dynamic
Type: unsigned char
Access: CSG
Class: XmCDialogTitle
Default: NULL
Type: XmString
Access: CSG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCLabelFontList
Default: dynamic
Type: XmFontList
Access: CSG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCMarginHeight
Default: 10
Type: Dimension
Access: CSG
Class: XmCMarginWidth
Default: 10
Type: Dimension
Access: CSG
Class: XmCNoResize
Default: False
Type: Boolean
Access: CSG
Class: XmCResizePolicy
Default: XmRESIZE_ANY
Type: unsigned char
Access: CSG
Class: XmCShadowType
Default: XmSHADOW_OUT
Type: unsigned char
Access: CSG
Class: XmCTextFontList
Default: dynamic
Type: XmFontList
Access: CSG
Class: XmCTranslations
Default: NULL
Type: XtTranslations
Access: C
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
XmManager Resource Set
Class: XmCBottomShadowColor
Default: dynamic
Type: Pixel
Access: CSG
Class: XmCBottomShadowPixmap
Default: XmUNSPECIFIED_PIXMAP
Type: Pixmap
Access: CSG
Class: XmCForeground
Default: dynamic
Type: Pixel
Access: CSG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCHighlightColor
Default: dynamic
Type: Pixel
Access: CSG
Class: XmCHighlightPixmap
Default: dynamic
Type: Pixmap
Access: CSG
Class: XmCInitialFocus
Default: dynamic
Type: Widget
Access: CSG
Class: XmCNavigationType
Default: XmTAB_GROUP
Type: XmNavigationType
Access: CSG
Class: XmCShadowThickness
Default: dynamic
Type: Dimension
Access: CSG
Class: XmCStringDirection
Default: dynamic
Type: XmStringDirection
Access: CG
Class: XmCTopShadowColor
Default: dynamic
Type: Pixel
Access: CSG
Class: XmCTopShadowPixmap
Default: dynamic
Type: Pixmap
Access: CSG
Class: XmCTraversalOn
Default: True
Type: Boolean
Access: CSG
Class: XmCUnitType
Default: dynamic
Type: unsigned char
Access: CSG
Class: XmCUserData
Default: NULL
Type: XtPointer
Access: CSG
Composite Resource Set
Class: XmCReadOnly
Default: NULL
Type: WidgetList
Access: G
Class: XmCInsertPosition
Default: NULL
Type: XtOrderProc
Access: CSG
Class: XmCReadOnly
Default: 0
Type: Cardinal
Access: G
Core Resource Set
Class: XmCAccelerators
Default: dynamic
Type: XtAccelerators
Access: N/A
Class: XmCSensitive
Default: dynamic
Type: Boolean
Access: G
Class: XmCBackground
Default: dynamic
Type: Pixel
Access: CSG
Class: XmCPixmap
Default: XmUNSPECIFIED_PIXMAP
Type: Pixmap
Access: CSG
Class: XmCBorderColor
Default: XtDefaultForeground
Type: Pixel
Access: CSG
Class: XmCPixmap
Default: XmUNSPECIFIED_PIXMAP
Type: Pixmap
Access: CSG
Class: XmCBorderWidth
Default: 0
Type: Dimension
Access: CSG
Class: XmCColormap
Default: dynamic
Type: Colormap
Access: CG
Class: XmCDepth
Default: dynamic
Type: int
Access: CG
Class: XmCCallback
Default: NULL
Type: XtCallbackList
Access: C
Class: XmCHeight
Default: dynamic
Type: Dimension
Access: CSG
Class: XmCInitialResourcesPersistent
Default: True
Type: Boolean
Access: C
Class: XmCMappedWhenManaged
Default: True
Type: Boolean
Access: CSG
Class: XmCScreen
Default: dynamic
Type: Screen *
Access: CG
Class: XmCSensitive
Default: True
Type: Boolean
Access: CSG
Class: XmCTranslations
Default: dynamic
Type: XtTranslations
Access: CSG
Class: XmCWidth
Default: dynamic
Type: Dimension
Access: CSG
Class: XmCPosition
Default: 0
Type: Position
Access: CSG
Class: XmCPosition
Default: 0
Type: Position
Access: CSG
Callback Information
A pointer to the following structure is passed to each callback:
typedef struct {
int reason;
XEvent * event;
XmString value;
int length;
XmString mask;
int mask_length;
XmString dir;
int dir_length;
XmString pattern;
int pattern_length; } XmFileSelectionBoxCallbackStruct;
Indicates why the callback was invoked Points to the XEvent that trig‐
gered the callback Specifies the current value of XmNdirSpec Specifies
the number of bytes in value Specifies the current value of XmNdirMask
Specifies the number of bytes in mask Specifies the current base direc‐
tory Specifies the number of bytes in dir Specifies the current search
pattern Specifies the number of bytes in pattern
Translations
XmFileSelectionBox inherits translations from XmSelectionBox.
Accelerators
The XmNtextAccelerators from XmSelectionBox are added to the selection
and directory mask (filter) Text descendants of XmFileSelectionBox.
Action Routines
The XmFileSelectionBox action routines are described below: If neither
the selection text nor the directory mask (filter) text has the focus,
this action does nothing.
If the selection text has the focus, the term list in the fol‐
lowing description refers to the file list, and the term text
refers to the selection text. If the directory mask text has the
focus, list refers to the directory list, and text refers to the
directory mask text.
When called with a 0 argument, selects the previous item in the
list and replaces the text with that item.
When called with a 1 argument, selects the next item in the list
and replaces the text with that item.
When called with a 2 argument, selects the first item in the
list and replaces the text with that item.
When called with a 3 argument, selects the last item in the list
and replaces the text with that item. If neither the selection
text nor the directory mask (filter) text has the focus, this
action does nothing.
If the selection text has the focus, replaces the selection text
with the selected item in the file list. If no item in the file
list is selected, clears the selection text.
If the directory mask text has the focus, replaces the directory
mask text with a new directory mask constructed from the XmNdi‐
rectory and XmNpattern resources.
Additional Behavior
The FileSelectionBox widget has the additional behavior described
below: Calls the activate callbacks for the cancel button if it is sen‐
sitive. If no cancel button exists and the parent of the FileSelection‐
Box is a manager, passes the event to the parent. Calls the selection
text widget's XmNactivateCallback callbacks. If XmNmustMatch is True
and the selection text does not match an item in the file list, calls
the XmNnoMatchCallback callbacks with reason XmCR_NO_MATCH. Otherwise,
calls the XmNokCallback callbacks with reason XmCR_OK. Calls the
directory mask text widget's XmNactivateCallback callbacks. Initiates a
directory and file search. Calls the XmNapplyCallback callbacks with
reason XmCR_APPLY. Calls the directory list widget's XmNdefaultAction‐
Callback callbacks. Initiates a directory and file search. Calls the
XmNapplyCallback callbacks with reason XmCR_APPLY. Calls the file list
widget's XmNdefaultActionCallback callbacks. Calls the XmNokCallback
callbacks with reason XmCR_OK. Generates a new directory mask, using
the selected list item as the directory and the pattern extracted from
the current directory mask text as the search pattern. If the search
pattern is empty, uses a pattern that matches all files in the direc‐
tory. Replaces the directory mask text with the new directory mask.
Replaces the selection text with the selected list item. Drags the
content of one or more selected list items using the drag and drop
facility. If BDrag is pressed on an unselected item, drags only that
item, excluding any other selected items.
The XmNexportTargets resource of the associated DragContext is
set to target types of COMPOUND_TEXT and FILE_NAME. The XmN‐
clientData resource is set to the index of the item in the list.
Drags the content of one or more selected list items using the
drag and drop facility. If BDrag is pressed on an unselected
item, drags only that item, excluding any other selected items.
The XmNexportTargets resource of the associated DragContext is
set to target types of COMPOUND_TEXT and FILE_NAME. The XmN‐
clientData resource is set to the index of the item in the list.
Initiates a directory and file search. Calls the XmNapplyCall‐
back callbacks with reason XmCR_APPLY. If XmNmustMatch is True
and the selection text does not match an item in the file list,
calls the XmNnoMatchCallback callbacks with reason
XmCR_NO_MATCH. Otherwise, calls the XmNokCallback callbacks with
reason XmCR_OK. Calls the XmNcancelCallback callbacks with rea‐
son XmCR_CANCEL. Calls the XmNhelpCallback callbacks with rea‐
son XmCR_HELP. If no button, list widget, or text widget has
the keyboard focus: If XmNmustMatch is True and the selection
text does not match an item in the file list, calls the XmNno‐
MatchCallback callbacks with reason XmCR_NO_MATCH. Otherwise,
calls the XmNokCallback callbacks with reason XmCR_OK.
Virtual Bindings
The bindings for virtual keys are vendor specific. For information
about bindings for virtual buttons and keys, see VirtualBindings(3X).
SEE ALSOComposite(3X), Constraint(3X), Core(3X), XmBulletinBoard(3X), XmCreate‐
FileSelectionBox(3X), XmCreateFileSelectionDialog(3X), XmFileSelection‐
BoxGetChild(3X), XmFileSelectionDoSearch(3X), XmManager(3X), XmSelec‐
tionBox(3X)XmFileSelectionBox(3X)