readonly PRTime absoluteBeginTime

readonly PRTime absoluteEndTime

AUTF8String annotation

PRBool annotationIsNot

Test for existance or non-existance of a given annotation. We don't currently support >1 annotation name per query. If 'annotationIsNot' is true, we test for the non-existance of the specified annotation.

Testing for not annotation will do the same thing as a normal query and remove everything that doesn't have that annotation. Asking for things that DO have a given annotation is a little different. It also includes things that have never been visited. This allows place queries to be returned as well as anything else that may have been tagged with an annotation. This will only work for RESULTS_AS_URI since there will be no visits for these items.

PRTime beginTime

PRUint32 beginTimeReference

AUTF8String domain

This is the host or domain name (controlled by domainIsHost). When domainIsHost, domain only does exact matching on host names. Otherwise, it will return anything whose host name ends in 'domain'.

This one is a little different than most. Setting it to an empty string is a real query and will match any URI that has no host name (local files and such). Set this to NULL (in C++ use SetIsVoid) if you don't want domain matching.

PRBool domainIsHost

This controls the meaning of 'domain', and whether it is an exact match 'domainIsHost' = true, or hierarchical (= false).

PRTime endTime

PRUint32 endTimeReference

readonly PRUint32 folderCount

readonly PRBool hasAnnotation

readonly PRBool hasBeginTime

readonly PRBool hasDomain

readonly PRBool hasEndTime

readonly PRBool hasSearchTerms

readonly PRBool hasUri

PRInt32 maxVisits

PRInt32 minVisits

Set lower or upper limits for how many times an item has been visited. The default is -1, and in that case all items are matched regardless of their visit count.

PRBool onlyBookmarked

When set, returns only bookmarked items, when unset, returns anything. Setting this is equivalent to listing all bookmark folders in the 'folders' parameter.

AString searchTerms

Text search terms.

nsIURI uri

This is a URI to match, to, for example, find out every time you visited a given URI. Use uriIsPrefix to control whether this is an exact match.

PRBool uriIsPrefix

Controls the interpretation of 'uri'. When unset (default), the URI will request an exact match of the specified URI. When set, any history entry beginning in 'uri' will match. For example "http://bar.com/foo" will match "http://bar.com/foo" as well as "http://bar.com/foo/baz.gif".