'\" t .\" $Header: /cvsroot/lesstif/lesstif/doc/lessdox/widgets/XmFileSelectionBox.3,v 1.7 2009/04/29 12:23:30 paulgevers Exp $ .\" .\" Copyright (C) 1997-1998 Free Software Foundation, Inc. .\" .\" This file is part of the GNU LessTif Library. .\" This library is free software; you can redistribute it and/or .\" modify it under the terms of the GNU Library General Public .\" License as published by the Free Software Foundation; either .\" version 2 of the License, or (at your option) any later version. .\" .\" This library is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU .\" Library General Public License for more details. .\" .\" You should have received a copy of the GNU Library General Public .\" License along with this library; if not, write to the Free .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. .\" .TH XmFileSelectionBox 3 "April 1998" "LessTif Project" "LessTif Manuals" .SH NAME XmFileSelectionBox \- Motif-compatible file-selection dialogue .SH SYNOPSIS .B #include .PP .B XmFileSelectionBox .PP .B XmCreateFileSelectionBox .SH DESCRIPTION XmFileSelectionBox .SH X RESOURCES .TS tab(;); l l l l l. Name;Class;Type;Default;Access _ XmNdirectory;XmCDirectory;XmString;NULL;CSG XmNpattern;XmCPattern;XmString;NULL;CSG XmNdirListLabelString;XmCDirListLabelString;XmString;NULL;CSG XmNdirListItems;XmCDirListItems;XmStringTable;NULL;CSG XmNdirListItemCount;XmCDirListItemCount;Int;-1;CSG XmNfilterLabelString;XmCFilterLabelString;XmString;NULL;CSG XmNdirMask;XmCDirMask;XmString;NULL;CSG XmNnoMatchString;XmCNoMatchString;XmString;NULL;CSG XmNqualifySearchDataProc;XmCQualifySearchDataProc;Proc;NULL;CSG XmNdirSearchProc;XmCDirSearchProc;Proc;NULL;CSG XmNfileSearchProc;XmCFileSearchProc;Proc;NULL;CSG XmNfileTypeMask;XmCFileTypeMask;FileTypeMask;NULL;CSG XmNlistUpdated;XmCListUpdated;Boolean;NULL;CSG XmNdirectoryValid;XmCDirectoryValid;Boolean;NULL;CSG XmNdirSpec;XmCDirSpec;XmString;NULL;CSG XmNautoUnmanage;XmCAutoUnmanage;Boolean;NULL;CSG XmNfileListLabelString;XmCFileListLabelString;XmString;NULL;CSG XmNapplyLabelString;XmCApplyLabelString;XmString;NULL;CSG XmNdialogType;XmCDialogType;SelectionType;NULL;CSG XmNfileListItems;XmCItems;XmStringTable;NULL;CSG XmNfileListItemCount;XmCItemCount;Int;-1;CSG .TE .PP .BR XmNdirectory .PP .BR XmNpattern .PP .BR XmNdirListLabelString .PP .BR XmNdirListItems .PP .BR XmNdirListItemCount .PP .BR XmNfilterLabelString .PP .BR XmNdirMask .PP .BR XmNnoMatchString .PP .BR XmNqualifySearchDataProc .PP .BR XmNdirSearchProc .PP .BR XmNfileSearchProc .PP .BR XmNfileTypeMask .PP .BR XmNlistUpdated .PP .BR XmNdirectoryValid .PP .BR XmNdirSpec .PP .BR XmNautoUnmanage .PP .BR XmNfileListLabelString .PP .BR XmNapplyLabelString .PP .BR XmNdialogType .PP .BR XmNfileListItems .PP .BR XmNfileListItemCount .PP .SH CLASS HIERARCHY .BR Object (3) .BR Rect (3) .BR UnNamedObj (3) .BR Core (3) .BR Composite (3) .BR Constraint (3) .BR XmManager (3) .BR XmBulletinBoard (3) .BR XmSelectionBox (3) .BR XmFileSelectionBox (3) .SH CALLBACKS .BR XmFileSelectionBox has several callback lists, all of which are inherited from the superclass XmSelectionBox : .BR XmNokCallback , .BR XmNcancelCallback , .BR XmNhelpCallback , .BR XmNfilterCallback . In all these cases, the call_data parameter passed is of type XmFileSelectionBoxCallbackStruct : .br .SM 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; .SM .PP 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. .PP The other fields ... .SH SEARCH PROCEDURES 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. .PP XmNqualifySearchDataProc is called when ... .PP XmNdirSearchProc is called when ... .PP XmNfileSearchProc is called when ... .SH CONVENIENCE FUNCTIONS .SH SEE ALSO