MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

• App is in the snapped state and is invoked as above, in which case Search will go to the Start
screen.
• App is suspended and is invoked as above.
You should also be mindful of how you present results, taking care that the primary results are
not hidden by the Search pane, which will remain visible until the user dismisses it.
Sidebar: Synchronizing In-App Search with the Search Pane
Some types of apps will still maintain their own in-app search UI in addition to using the search
pane, or in other ways they might have some kind of search term that would be good to keep in
sync with the term shown in the search pane. To do this, the app can ask the search pane for its
queryText value and can attempt to set that value through the SearchPane.trySet-QueryText
method. This call will fail, mind you, if the app isn’t itself visible or if the search pane is already
visible or becoming visible.
Providing Query Suggestions
Using querysubmitted and the activation sequence in the previous section gives you the basic level of
search interaction, and Windows will automatically provide a history of the user’s recent searches. Still,
with just a little more work you can make the experience much richer. Because writing the code to
actually perform the search, process the results, and display them beautifully is the bulk of the work with
the Search contract anyway, adding support for query suggestions (this section) and result sugges-tions
(next section) is a relatively small investment with a huge impact on the overall user experience.
To go beyond the default search history and provide as-the-user-is-typing query suggestions, which
appear to the user as shown on the left side of Figure 12-10, you have two options. Which one you use
depends on what you want to suggest and the data that you’re searching.
First, to provide suggestions from folders on the file system, such as the music, pictures, and videos
libraries, the search pane provides a built-in implementation through its
setLocalContent-SuggestionsSettings method with results like those in Figure 12-12. As shown in
Scenario 4 of the sample, you first create a
Windows.ApplicationModel.Search.LocalContentSuggestion-Settings object, populate its
properties, and then pass that object to setLocalContent-SuggestionsSettings (js/scenario4.js):
var page = WinJS.UI.Pages.define("/html/scenario4.html", {
ready: function (element, options) {
var localSuggestionSettings = new
Windows.ApplicationModel.Search.LocalContentSuggestionSettings();
localSuggestionSettings.enabled = true;
localSuggestionSettings.locations.append(Windows.Storage.KnownFolders.musicLibrary);
localSuggestionSettings.aqsFilter = "kind:=music";
520