Name

DwtFileSelectionDoSearch − Initiates a search with a directory mask option.  Otherwise, the current directory mask is used. 

Syntax

void DwtFileSelectionDoSearch(widget, dirmask)
     FileSelectionWidget widget;
     DwtCompString dirmask;

Arguments

widgetSpecifies the pointer to the file selection widget data structure. 

dirmaskSpecifies the directory mask used in determining the files displayed in the file selection list box.  This is an optional attribute.  If you do not specify a directory mask, the default directory mask is used.  This argument sets the DwtNdirMask attribute associated with DwtFileSelectionCreate. 

Description

The file selection widget initiates file searches when any of the following occur:

•The file selection widget becomes visible (managed). 

•You use XtSetValues to change the directory mask. 

•The user clicks on the Apply push button. 

•The application calls DwtFileSelectionDoSearch, which is another way for applications to initiate a directory search.  This may be useful, for example, when the application creates a new file and wants to reflect this change in a mapped file search widget. 

See Also

DwtFileSelection (3Dwt)
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding

Subroutines