BBjFileSave::filters

Description

In BBj 25.03 and higher, this method sets one or more file filters that the user can select from.

Syntax

Return Value Method
BBjFileOpen filters(String filters)

Parameters

Variable Description
filters

One or more filters in the following format:

"text description" + $0a$ + "mask" [+$0a$ + "text description" + $0a$ + "mask" ...]

The mask specifies an extension, in the format "*.ext" or "*.*"; two or more masks are separated with semicolons. The filter, if included, indicates which files will appear in the list.

Example:

f$ = ""

f$ = f$ + "Text Files (*.txt)"+$0a$+"*.txt"+$0a$

f$ = f$ + "HTML Files (*.htm;*.html)"+$0a$+"*.htm;*.html"+$0a$

f$ = f$ + "Image Files (*.png;*.jpg;*.bmp;*.gif)"+$0a$+"*.png;*.jpg;*.bmp;*.gif"+$0a$

f$ = f$ + "All Files (*.*)"+$0a$+"*.*"+$0a$

print bbjapi().filesave().filters(f$).show()

Return Value

Returns this BBjFileSave object, enabling multiple methods to be chained.

Example

f$ = "" 
f$ = f$ + "Text Files (*.txt)"+$0a$+"*.txt"+$0a$
f$ = f$ + "HTML Files (*.htm;*.html)"+$0a$+"*.htm;*.html"+$0a$
f$ = f$ + "Image Files (*.png;*.jpg;*.bmp;*.gif)"+$0a$+"*.png;*.jpg;*.bmp;*.gif"+$0a$
f$ = f$ + "All Files (*.*)"+$0a$+"*.*"+$0a$
print bbjapi().filesave().filters(f$).show()

See Also

BBjAPI

FILESAVE() Function - Create File Save Dialog

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.