update_when_queried

Declaration

update_when_queried: BOOLEAN

Description

If true, the current query is updated whenever the column search string values are changed. If False, the current query is out-of-date until update_when_queried is set to True or update_query is called.

If you leave update_when_queried as False all the time, then you have to make sure to call update_query to make sure the query is up-to-date before displaying it. If you don't, the query will not reflect your changes.

See Also

update_query
database functions
Database

Example

script build_query is
  -- turn off 'update_when_queried' so that query
  -- doesn't waste time updating the partial search
  -- arguments
  update_when_queried := False
  reset_column_search_strings
  set_column_search_string ('type', 'question')
  set_column_search_string ('section', '1')
  update_when_queried := True
end