1XmFileSelectionBox(3)           LessTif Manuals          XmFileSelectionBox(3)
2
3
4

NAME

6       XmFileSelectionBox - Motif-compatible file-selection dialogue
7

SYNOPSIS

9       #include <Xm/FileSB.h>
10
11       XmFileSelectionBox
12
13       XmCreateFileSelectionBox
14

DESCRIPTION

16       XmFileSelectionBox
17

X RESOURCES

19       Name                       Class                      Type            Default   Access
20       ───────────────────────────────────────────────────────────────────────────────────────
21       XmNdirectory               XmCDirectory               XmString        NULL      CSG
22       XmNpattern                 XmCPattern                 XmString        NULL      CSG
23       XmNdirListLabelString      XmCDirListLabelString      XmString        NULL      CSG
24       XmNdirListItems            XmCDirListItems            XmStringTable   NULL      CSG
25       XmNdirListItemCount        XmCDirListItemCount        Int             -1        CSG
26       XmNfilterLabelString       XmCFilterLabelString       XmString        NULL      CSG
27       XmNdirMask                 XmCDirMask                 XmString        NULL      CSG
28       XmNnoMatchString           XmCNoMatchString           XmString        NULL      CSG
29       XmNqualifySearchDataProc   XmCQualifySearchDataProc   Proc            NULL      CSG
30       XmNdirSearchProc           XmCDirSearchProc           Proc            NULL      CSG
31       XmNfileSearchProc          XmCFileSearchProc          Proc            NULL      CSG
32       XmNfileTypeMask            XmCFileTypeMask            FileTypeMask    NULL      CSG
33       XmNlistUpdated             XmCListUpdated             Boolean         NULL      CSG
34       XmNdirectoryValid          XmCDirectoryValid          Boolean         NULL      CSG
35       XmNdirSpec                 XmCDirSpec                 XmString        NULL      CSG
36       XmNautoUnmanage            XmCAutoUnmanage            Boolean         NULL      CSG
37       XmNfileListLabelString     XmCFileListLabelString     XmString        NULL      CSG
38       XmNapplyLabelString        XmCApplyLabelString        XmString        NULL      CSG
39       XmNdialogType              XmCDialogType              SelectionType   NULL      CSG
40       XmNfileListItems           XmCItems                   XmStringTable   NULL      CSG
41       XmNfileListItemCount       XmCItemCount               Int             -1        CSG
42
43       XmNdirectory
44
45       XmNpattern
46
47       XmNdirListLabelString
48
49       XmNdirListItems
50
51       XmNdirListItemCount
52
53       XmNfilterLabelString
54
55       XmNdirMask
56
57       XmNnoMatchString
58
59       XmNqualifySearchDataProc
60
61       XmNdirSearchProc
62
63       XmNfileSearchProc
64
65       XmNfileTypeMask
66
67       XmNlistUpdated
68
69       XmNdirectoryValid
70
71       XmNdirSpec
72
73       XmNautoUnmanage
74
75       XmNfileListLabelString
76
77       XmNapplyLabelString
78
79       XmNdialogType
80
81       XmNfileListItems
82
83       XmNfileListItemCount
84

CLASS HIERARCHY

86       Object(3)  Rect(3)  UnNamedObj(3)  Core(3)  Composite(3)  Constraint(3)
87       XmManager(3) XmBulletinBoard(3) XmSelectionBox(3) XmFileSelectionBox(3)
88

CALLBACKS

90       XmFileSelectionBox has several callback lists, all of which are  inher‐
91       ited from the superclass XmSelectionBox : XmNokCallback, XmNcancelCall‐
92       back, XmNhelpCallback, XmNfilterCallback.   In  all  these  cases,  the
93       call_data  parameter passed is of type XmFileSelectionBoxCallbackStruct
94       :
95         typedef struct {
96           int reason;
97           XEvent *event;
98           XmString value;
99           int length;
100           XmString mask;
101           int mask_length;
102           XmString dir;
103           int dir_length;
104           XmString pattern;
105           int pattern_length;
106         } XmFileSelectionBoxCallbackStruct;
107
108       The reason field can have the values XmCR_OK, XmCR_NO_MATCH,  XmCR_CAN‐
109       CEL,  XmCR_HELP.  The event field contains a pointer to the information
110       from Xlib from the event that triggered this callback.
111
112       The other fields ...
113

SEARCH PROCEDURES

115       XmFileSelectionBox also has a number of resources which  allow  you  to
116       specify a (usually) system dependent function that helps it in travers‐
117       ing the filesystem.  These are not callback lists as implemented in the
118       Intrinsics;  they  can call one function with specific behaviour.  They
119       are : XmNqualifySearchDataProc, XmNdirSearchProc, XmNfileSearchProc.
120
121       XmNqualifySearchDataProc is called when ...
122
123       XmNdirSearchProc is called when ...
124
125       XmNfileSearchProc is called when ...
126

CONVENIENCE FUNCTIONS

SEE ALSO

129       <Xm/Xm.h>
130
131
132
133LessTif Project                   April 1998             XmFileSelectionBox(3)
Impressum