• *browse_style_define Function
• a5_add_scr_to_favorites Function
• a5_b_celllock_image_menu Function
• a5_b_celllock_reg_menu Function
• a5_browse_cell_edit Function
• a5_browse_cell_lock_menu Function
• a5_browse_cell_view Function
• a5_browse_column_menu Function
• A5_BROWSE_CREATE Function
• a5_browse_row_menu Function
• a5_browse_toolbar Function
• a5_browsedefaultdefinitionxml Function
• a5_browseeditor_toolbar Function
• a5_browseonxdialog_generatexbasic Function
• a5_column_props_dialog Function
• a5_f_fldlock_reg_menu Function
• A5_LAYOUT_DESIGN Function
• a5_modal_change_command Function
• a5_open_browse Function
• A5_OPEN_DEFAULT_BROWSE Function
• A5_open_EmbeddedBrowse_CompanionForm Function
• ADHOCVIEW Function
• ALLOW_EDITING Function
• BROWSE_OBJECTS_GET Function
• CURRENT_HIGHLIGHTED_RECORDS Function
• PREVIEW_BROWSE Function
• PRINT_BROWSE Function

 

A5_OPEN_DEFAULT_BROWSE Function

Syntax

Arguments

table_set_name

The name of the table or set to display. Character

filter

Optional. Default = .T. (all records). A character filter expressionthat evaluates to a logical value. Selects records from the table.

order

Optional. Default = record order. A character order expressionthat sorts selected records.

description

The description that you assign to the query that Alpha Anywhere creates when the browse is opened.

options

Optional. Default = Record order, ascending, not unique. Controls whether Alpha Anywhere uses an index, a new query list, or an existing query list to satisfy a query. This string can contain one or more of the following codes:

Code

Description

N

Builds a query list even if an index matches the query definition.

D

The descending order option puts the records in descending alphabetical order or, for a numeric field, from highest to lowest value.

T

Temporary query. Alpha Anywhere will automatically delete this query if necessary if building a new query would cause it to run out of query slots. there are a maximum of 16 query slots.

U

The unique option includes only unique records in the query list.

M

Builds a new query list even though a) an existing query list exists, and b) an existing Index exists (both of which, Alpha Anywhere could have used rather than running a new query).

X

Use an index even if an existing query exists (which Alpha Anywhere would otherwise have used in preference to the index).

I

The I flag is obsolete. It was used by Alpha Five V1 to indicate that the index should be case-insensitive. However since V2, Alpha Anywhere automatically builds all indexes as Case-insensitive. It is documented because in some situations, the Script Recorder will show Xbasic code that includes the "I" flag.

enable_show_all

Logical. Optional. Default = .F. Specifies whether the Show All icon that appears on the toolbar is enabled. .T. = Icon enabled, .F. = Icon not enabled.

arguments

*

Description

The A5_OPEN_DEFAULT_BROWSE() function displays the default browse for the selected table or set.

If you specify an optional filter and order, you can give the query a description (which shows up when you press Control I to display the index selector). options are the standard options that apply the to .query_create() method. If you do not want the user to remove the filter/order that you specified for the default browse, you would want Show_Allicon to be disabled. otherwise the user could press the icon and remove the filter that you specified.

Example

The following displays all the entries from the Customer table where the lastnamefield starts with the letter M or greater. The entries are also ordered by lastname.

a5_open_default_browse("customer", "lastname > " + quote("M"), "lastname")

Limitations

Desktop applications only.

See Also

• Browse Functions and Methods