right_edge is the position being used as the rightmost point for regular item
max_height is the maximum amount of space that the extension rect can
occupy given the current size of the Frame.
It is recommended that the client set the
PANEL_PAINT attribute to the value of
PANEL_NONE for each xv_set call made on a Panel Item within this callback.
Tells the File Chooser to reserve this much vertical space for the added controls. Positioning controls
outside this area is not supported by the XView File Chooser.
Procs: get, set
Function called to validate the file names before they will be displayed to the user. The files for which
this callback is invoked are chosen using
Argument: int (*filter_func)()
Procs: create, get, set
filter_func( fc, path, stats, matched, glyph,
client_data, mask_glyph )
char * path;
struct stat * stats;
Server_image * glyph;
Xv_opaque * client_data;
Server_image * mask_glyph;
fc is the File Chooser instance for which the callback was invoked.
path is the path name of the file being decided on.
statbuf is the address of a stat structure (see the stat(2) man page for details).
matched is one of the values
FILE_CHOOSER_MATCHED or FILE_CHOOSER_
NOT_MATCHED, depending on if the file name was found to match the regular expres-
sion given using the
glyph and client_data are returnable values. If the filter function returns a
Server_image in the glyph field, the glyph returned will be displayed in the list
along with the file name. The Server_image returned is expected to be 16×16 pix-
els, regardless of the scale or font size of the File Chooser.
mask_glyph is the clip mask to be used with the glyph field. The Server_image
returned must be of depth 1. In most cases, if the glyph is of depth 1, the
mask_glyph is the same Server_image as the glyph.
If a value is returned in the client_data field, this same value will be returned, unin-
terpreted, to the callback installed from the
The expected return value from the filter-func is one of the ops
or FILE_CHOOSER_IGNORE. If the return value is FILE_CHOOSER_IGNORE, this file will
48 XView Reference Manual