From 124b67b1da0ba1d498c33f835d91b531d5d1143e Mon Sep 17 00:00:00 2001 From: "benjamin%smedbergs.us" Date: Tue, 18 Jul 2006 17:48:39 +0000 Subject: [PATCH] Bug 317829, r=beng. Support annotation-based queries. Original committer: brettw%gmail.com Original revision: 1.29 Original date: 2006/01/25 01:36:40 --- .../places/public/nsINavHistoryService.idl | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/toolkit/components/places/public/nsINavHistoryService.idl b/toolkit/components/places/public/nsINavHistoryService.idl index 9747a776623..1784aeea6f0 100644 --- a/toolkit/components/places/public/nsINavHistoryService.idl +++ b/toolkit/components/places/public/nsINavHistoryService.idl @@ -595,6 +595,24 @@ interface nsINavHistoryQuery : nsISupports attribute nsIURI uri; readonly attribute boolean hasUri; + /** + * 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 (which might include bookmark folders -- use the bookmark + * service's GetFolderURI) 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. + */ + attribute boolean annotationIsNot; + attribute AUTF8String annotation; + readonly attribute boolean hasAnnotation; + /** * Limit results to items that are in all of the given folders. */ @@ -735,6 +753,10 @@ interface nsINavHistoryQueryOptions : nsISupports * with the container's contents filled in from the stored query. * If not set, these will appear as normal items. Doesn't do anything if * excludeQueries is set. Defaults to false. + * + * Note that this has no effect on folder links, which are place: URIs + * returned by nsINavBookmarkService.GetFolderURI. These are always expanded + * and will appear as bookmark folders. */ attribute boolean expandQueries;