<HTML>
<HEAD><TITLE>Manpage of XmFileSelectionBox</TITLE>
</HEAD><BODY>
<H1>XmFileSelectionBox</H1>
Section: LessTif Manuals (3)<BR>Updated: April 1998<BR><A HREF="#index">Index</A>
<BR><A HREF="http://localhost/cgi-bin/man2html">Return to Main Contents</A>
<HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
XmFileSelectionBox - Motif-compatible file-selection dialogue
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>#include <<A HREF="file:/usr/include/Xm/FileSB.h">Xm/FileSB.h</A>></B>
<P>
<B>XmFileSelectionBox</B>
<P>
<B>XmCreateFileSelectionBox</B>
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
XmFileSelectionBox
<A NAME="lbAE"> </A>
<H2>X RESOURCES</H2>
<TABLE>
<TR VALIGN=top><TD>Name</TD><TD>Class</TD><TD>Type</TD><TD>Default</TD><TD>Access<BR></TD></TR>
<TR VALIGN=top><TD COLSPAN=5><HR></TD></TR>
<TR VALIGN=top><TD>XmNdirectory</TD><TD>XmCDirectory</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNpattern</TD><TD>XmCPattern</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirListLabelString</TD><TD>XmCDirListLabelString</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirListItems</TD><TD>XmCDirListItems</TD><TD>XmStringTable</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirListItemCount</TD><TD>XmCDirListItemCount</TD><TD>Int</TD><TD>-1</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfilterLabelString</TD><TD>XmCFilterLabelString</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirMask</TD><TD>XmCDirMask</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNnoMatchString</TD><TD>XmCNoMatchString</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNqualifySearchDataProc</TD><TD>XmCQualifySearchDataProc</TD><TD>Proc</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirSearchProc</TD><TD>XmCDirSearchProc</TD><TD>Proc</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfileSearchProc</TD><TD>XmCFileSearchProc</TD><TD>Proc</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfileTypeMask</TD><TD>XmCFileTypeMask</TD><TD>FileTypeMask</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNlistUpdated</TD><TD>XmCListUpdated</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirectoryValid</TD><TD>XmCDirectoryValid</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdirSpec</TD><TD>XmCDirSpec</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNautoUnmanage</TD><TD>XmCAutoUnmanage</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfileListLabelString</TD><TD>XmCFileListLabelString</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNapplyLabelString</TD><TD>XmCApplyLabelString</TD><TD>XmString</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNdialogType</TD><TD>XmCDialogType</TD><TD>SelectionType</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfileListItems</TD><TD>XmCItems</TD><TD>XmStringTable</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfileListItemCount</TD><TD>XmCItemCount</TD><TD>Int</TD><TD>-1</TD><TD>CSG<BR></TD></TR>
</TABLE>
<P>
<B>XmNdirectory</B>
<P>
<B>XmNpattern</B>
<P>
<B>XmNdirListLabelString</B>
<P>
<B>XmNdirListItems</B>
<P>
<B>XmNdirListItemCount</B>
<P>
<B>XmNfilterLabelString</B>
<P>
<B>XmNdirMask</B>
<P>
<B>XmNnoMatchString</B>
<P>
<B>XmNqualifySearchDataProc</B>
<P>
<B>XmNdirSearchProc</B>
<P>
<B>XmNfileSearchProc</B>
<P>
<B>XmNfileTypeMask</B>
<P>
<B>XmNlistUpdated</B>
<P>
<B>XmNdirectoryValid</B>
<P>
<B>XmNdirSpec</B>
<P>
<B>XmNautoUnmanage</B>
<P>
<B>XmNfileListLabelString</B>
<P>
<B>XmNapplyLabelString</B>
<P>
<B>XmNdialogType</B>
<P>
<B>XmNfileListItems</B>
<P>
<B>XmNfileListItemCount</B>
<P>
<A NAME="lbAF"> </A>
<H2>CLASS HIERARCHY</H2>
<B><A HREF="Object.html">Object</A></B>(3)
<B><A HREF="Rect.html">Rect</A></B>(3)
<B><A HREF="UnNamedObj.html">UnNamedObj</A></B>(3)
<B><A HREF="Core.html">Core</A></B>(3)
<B><A HREF="Composite.html">Composite</A></B>(3)
<B><A HREF="Constraint.html">Constraint</A></B>(3)
<B><A HREF="XmManager.html">XmManager</A></B>(3)
<B><A HREF="XmBulletinBoard.html">XmBulletinBoard</A></B>(3)
<B><A HREF="XmSelectionBox.html">XmSelectionBox</A></B>(3)
<B><A HREF="XmFileSelectionBox.html">XmFileSelectionBox</A></B>(3)
<A NAME="lbAG"> </A>
<H2>CALLBACKS</H2>
<B>XmFileSelectionBox</B>
has several callback lists,
all of which are inherited from the superclass XmSelectionBox :
<B>XmNokCallback</B>,
<B>XmNcancelCallback</B>,
<B>XmNhelpCallback</B>,
<B>XmNfilterCallback</B>.
In all these cases, the call_data parameter passed is of type
XmFileSelectionBoxCallbackStruct :
<BR>
<FONT SIZE=-1><BR> typedef struct {</FONT>
<BR> int reason;
<BR> XEvent *event;
<BR> XmString value;
<BR> int length;
<BR> XmString mask;
<BR> int mask_length;
<BR> XmString dir;
<BR> int dir_length;
<BR> XmString pattern;
<BR> int pattern_length;
<BR> } XmFileSelectionBoxCallbackStruct;
<FONT SIZE=-1><P>
</FONT>
The reason field can have the values
XmCR_OK, XmCR_NO_MATCH, XmCR_CANCEL, XmCR_HELP.
The event field contains a pointer to the information from Xlib from the
event that triggered this callback.
<P>
The other fields ...
<A NAME="lbAH"> </A>
<H2>SEARCH PROCEDURES</H2>
XmFileSelectionBox also has a number of resources which allow you to specify
a (usually) system dependent function that helps it in traversing the
filesystem.
These are not callback lists as implemented in the Intrinsics;
they can call one function with specific behaviour.
They are : XmNqualifySearchDataProc, XmNdirSearchProc, XmNfileSearchProc.
<P>
XmNqualifySearchDataProc is called when ...
<P>
XmNdirSearchProc is called when ...
<P>
XmNfileSearchProc is called when ...
<A NAME="lbAI"> </A>
<H2>CONVENIENCE FUNCTIONS</H2>
<A NAME="lbAJ"> </A>
<H2>SEE ALSO</H2>
<<A HREF="file:/usr/include/Xm/Xm.h">Xm/Xm.h</A>>
<P>
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">X RESOURCES</A><DD>
<DT><A HREF="#lbAF">CLASS HIERARCHY</A><DD>
<DT><A HREF="#lbAG">CALLBACKS</A><DD>
<DT><A HREF="#lbAH">SEARCH PROCEDURES</A><DD>
<DT><A HREF="#lbAI">CONVENIENCE FUNCTIONS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by <EM>man2html</EM>,
using the manual pages.<BR>
</BODY>
</HTML>
