This sample shows how to provide search suggestions by using the in-app search control.

The sample demonstrates these tasks:

  1. Provide search suggestions for app content

    Uses the AppendQuerySuggestion method to provide suggestions from a local list and display them in the SearchBox control.

  2. Use linquistic alternatives to query terms for East Asia search

    Uses the AppendQuerySuggestion method to provide suggestions from a static list of Japanese text and display them in the SearchBox control.

    Important  A Japanese Input Method Editor (IME) IME must be enabled on the system for this feature to work.

  3. Use suggestions provided by the system for content in libraries and folders

    Uses the SetLocalContentSuggestionSettings method to configure the SearchBox to include search suggestions from the Music library.

  4. Provide search suggestions from a web server in the OpenSearch format

    Uses the HttpClient class and the AppendQuerySuggestion method to provide suggestions from a web server that returns suggestions in the OpenSearch format.

  5. Provide search suggestions from a web server in XML format

    Uses the XmlDocument class and the AppendQuerySuggestion method to provide suggestions from a web server that returns suggestions as XML Search Suggestions.

  6. Set focus to the search box when the user starts typing

    Uses the FocusOnKeyboardInput property to set focus on the SearchBox control when the user starts typing.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

Related topics

SearchBox
CreateFileQueryWithOptions
AppendQuerySuggestion

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2

Build the sample

  1. Start Visual Studio 2013 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Visual Studio 2013 Solution (.sln) file.
  3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.