# XmFileSelectionBox

Section: LessTif Manuals (3)
Updated: April 1998
Index
Return to Main Contents

## NAME

XmFileSelectionBox - Motif-compatible file-selection dialogue

## SYNOPSIS

#include <Xm/FileSB.h>

XmFileSelectionBox

XmCreateFileSelectionBox

## DESCRIPTION

XmFileSelectionBox

## X RESOURCES

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

XmNdirectory

XmNpattern

XmNdirListLabelString

XmNdirListItems

XmNdirListItemCount

XmNfilterLabelString

XmNdirMask

XmNnoMatchString

XmNqualifySearchDataProc

XmNdirSearchProc

XmNfileSearchProc

XmNfileTypeMask

XmNlistUpdated

XmNdirectoryValid

XmNdirSpec

XmNautoUnmanage

XmNfileListLabelString

XmNapplyLabelString

XmNdialogType

XmNfileListItems

XmNfileListItemCount

## CLASS HIERARCHY

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

## CALLBACKS

XmFileSelectionBox has several callback lists, all of which are inherited from the superclass XmSelectionBox : XmNokCallback, XmNcancelCallback, XmNhelpCallback, XmNfilterCallback. In all these cases, the call_data parameter passed is of type XmFileSelectionBoxCallbackStruct :
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;

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.

The other fields ...

## 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.

XmNqualifySearchDataProc is called when ...

XmNdirSearchProc is called when ...

XmNfileSearchProc is called when ...

## CONVENIENCE FUNCTIONS

## SEE ALSO

<Xm/Xm.h>

## Index

NAME
SYNOPSIS
DESCRIPTION
X RESOURCES
CLASS HIERARCHY
CALLBACKS
SEARCH PROCEDURES
CONVENIENCE FUNCTIONS
SEE ALSO

This document was created by man2html, using the manual pages.