namespace Windows.ApplicationModel.Search
{// 表示和管理用户激活“搜索”个性分类时打开的搜索窗格。public sealed class SearchPane{// 标识当前与用户的文本输入设备关联的语言的 Internet 工程任务组 (IETF) 语言标记 (BCP 47 标准)。// 返回结果: IETF BCP 47 标准语言标记。public string Language { get; }//  当搜索框没有输入焦点且用户未输入任意字符时的搜索框中的占位符文本。// 返回结果:  在搜索框中显示的占位符文本。public string PlaceholderText { get; set; }// 搜索窗格的搜索框中的当前文本。// 返回结果:  当前查询文本。 如果未使用搜索窗格，则这是一个空字符串。public string QueryText { get; }       //  标识搜索上下文和用于存储用户搜索应用程序历史记录的字符串。// 返回结果:  搜索历史记录上下文字符串。public string SearchHistoryContext { get; set; }//  指示是否自动跟踪应用程序的前一个用户搜索以及该搜索是否用于提供建议。// 返回结果: 如果用户的搜索历史记录将被自动跟踪并用于提供建议，则为 true；否则为 false。默认值为 true。public bool SearchHistoryEnabled { get; set; }public bool ShowOnKeyboardInput { get; set; }// 指示搜索窗格是否打开。// 返回结果:  如果正在显示搜索窗格，则为 true；否则为 false。public bool Visible { get; }// 当用户在搜索框中更改文本时激发。public event TypedEventHandler<SearchPane, SearchPaneQueryChangedEventArgs> QueryChanged;// 当用户在搜索框中提交文本，且应用程序需要显示搜索结果时激发。public event TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs> QuerySubmitted;// 当用户选择由您的应用程序提供，且显示在搜索窗格中的其中一个建议结果时激发。public event TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs> ResultSuggestionChosen;// 当用户的查询文本发生更改，且应用程序需要提供新的建议以显示在搜索窗格中时激发。        public event TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs> SuggestionsRequested;//当用户打开或关闭搜索窗格时激发。public event TypedEventHandler<SearchPane, SearchPaneVisibilityChangedEventArgs> VisibilityChanged;// 检索可用于在该应用程序内进行搜索的搜索窗格实例。     // 返回结果:  搜索窗格的实例，为当前应用程序中的搜索提供一致、触控友好的搜索框和选项搜索建议。public static SearchPane GetForCurrentView();// 指定基于本地文件的建议是否自动显示在搜索窗格，并定义 Windows 使用的条件来定位和筛选这些建议。
       // settings:  本地内容建议的新设置。public void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings settings);// 显示搜索窗格。public void Show();        // 显示具有指定的初始查询字符串的搜索窗格。      // query: 初始查询字符串。public void Show(string query);public bool TrySetQueryText(string query);}
}

 async protected override void OnSearchActivated(SearchActivatedEventArgs args){await EnsureMainPageActivatedAsync(args);if (args.QueryText == ""){// navigate to landing page.
     }else{// 显示搜索结果, 下面的方法只是把搜索关键字赋值给 //MainPage 中的一个 TextBlock 对象
          MainPage.Current.ProcessQueryText(args.QueryText);}}//确保 MainPage 已经初始化完毕
async private Task EnsureMainPageActivatedAsync(IActivatedEventArgs args)
{if (args.PreviousExecutionState == ApplicationExecutionState.Terminated){// Do an asynchronous restoreawait SuspensionManager.RestoreAsync();}if (Window.Current.Content == null){var rootFrame = new Frame();rootFrame.Navigate(typeof(MainPage));Window.Current.Content = rootFrame;}Window.Current.Activate();
}async protected override void OnLaunched(LaunchActivatedEventArgs args){   await EnsureMainPageActivatedAsync(args);}

  protected override void OnWindowCreated(WindowCreatedEventArgs args){
             //GetForCurrentView() :  检索可用于在该应用程序内进行搜索的搜索窗格实例。
             //当用户在搜索框中提交文本，且应用程序需要显示搜索结果时激发。SearchPane.GetForCurrentView().QuerySubmitted += new TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs>(OnQuerySubmitted);}

  private void OnQuerySubmitted(object sender, SearchPaneQuerySubmittedEventArgs args){if (MainPage.Current != null){MainPage.Current.ProcessQueryText(args.QueryText);}}

 private SearchPane searchPane= SearchPane.GetForCurrentView();private static readonly string[] suggestionList ={"Shanghai", "Istanbul", "Karachi", "Delhi", "Mumbai", "Moscow", "S鉶 Paulo", "Seoul", "Beijing", "Jakarta","Tokyo", "Mexico City", "Kinshasa", "New York City", "Lagos", "London", "Lima", "Bogota", "Tehran", "Ho Chi Minh City","Hong Kong", "Bangkok", "Dhaka", "Cairo", "Hanoi", "Rio de Janeiro", "Lahore", "Chonquing", "Bengaluru", "Tianjin","Baghdad", "Riyadh", "Singapore", "Santiago", "Saint Petersburg", "Surat", "Chennai", "Kolkata", "Yangon", "Guangzhou","Alexandria", "Shenyang", "Hyderabad", "Ahmedabad", "Ankara", "Johannesburg", "Wuhan", "Los Angeles", "Yokohama","Abidjan", "Busan", "Cape Town", "Durban", "Pune", "Jeddah", "Berlin", "Pyongyang", "Kanpur", "Madrid", "Jaipur","Nairobi", "Chicago", "Houston", "Philadelphia", "Phoenix", "San Antonio", "San Diego", "Dallas", "San Jose","Jacksonville", "Indianapolis", "San Francisco", "Austin", "Columbus", "Fort Worth", "Charlotte", "Detroit","El Paso", "Memphis", "Baltimore", "Boston", "Seattle Washington", "Nashville", "Denver", "Louisville", "Milwaukee","Portland", "Las Vegas", "Oklahoma City", "Albuquerque", "Tucson", "Fresno", "Sacramento", "Long Beach", "Kansas City","Mesa", "Virginia Beach", "Atlanta", "Colorado Springs", "Omaha", "Raleigh", "Miami", "Cleveland", "Tulsa", "Oakland","Minneapolis", "Wichita", "Arlington", " Bakersfield", "New Orleans", "Honolulu", "Anaheim", "Tampa", "Aurora","Santa Ana", "St. Louis", "Pittsburgh", "Corpus Christi", "Riverside", "Cincinnati", "Lexington", "Anchorage","Stockton", "Toledo", "St. Paul", "Newark", "Greensboro", "Buffalo", "Plano", "Lincoln", "Henderson", "Fort Wayne","Jersey City", "St. Petersburg", "Chula Vista", "Norfolk", "Orlando", "Chandler", "Laredo", "Madison", "Winston-Salem","Lubbock", "Baton Rouge", "Durham", "Garland", "Glendale", "Reno", "Hialeah", "Chesapeake", "Scottsdale","North Las Vegas", "Irving", "Fremont", "Irvine", "Birmingham", "Rochester", "San Bernardino", "Spokane","Toronto", "Montreal", "Vancouver", "Ottawa-Gatineau", "Calgary", "Edmonton", "Quebec City", "Winnipeg", "Hamilton"};

         //导航到时，注册
        protected override void OnNavigatedTo(NavigationEventArgs e){          //这个事件应该注册在你的应用主窗口的第一次初始化完成后，比如
          // OnLaunched,  OnSearcheActivated 事件中,
          // 例如在 App.xaml.cs  中的事件searchPane.SuggestionsRequested += new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                      OnSearchPaneSuggestionsRequested);}        //导航走时，取消注册protected override void OnNavigatedFrom(NavigationEventArgs e){searchPane.SuggestionsRequested -= new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                                  OnSearchPaneSuggestionsRequested);}

        private void OnSearchPaneSuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs e){            //当 suggestionsrequested 事件激发时应用程序应为其提供建议对在搜索框中的文本。var queryText = e.QueryText;if (!string.IsNullOrEmpty(queryText)){var request = e.Request;foreach (string suggestion in suggestionList){                  //CurrentCultureIgnoreCase :  使用区域敏感排序规则、当前区域
                  //来比较字符串，同时忽略被比较字符串的大小写。if (suggestion.StartsWith(queryText, StringComparison.CurrentCultureIgnoreCase)){// 将查询建议追加到搜索窗格的搜索建议列表中。
                           request.SearchSuggestionCollection.AppendQuerySuggestion(suggestion);// 最多向 "搜索面板" 中添加 5 条建议if (request.SearchSuggestionCollection.Size >= 5){break;}}}if (request.SearchSuggestionCollection.Size > 0){//Suggestions provided for query: " + queryText
                }else{// No suggestions provided for query: queryText
                }}}

private SearchPane searchPane = SearchPane.GetForCurrentView();

  protected override void OnNavigatedTo(NavigationEventArgs e){searchPane.SuggestionsRequested += new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                                 OnSearchPaneSuggestionsRequested);}protected override void OnNavigatedFrom(NavigationEventArgs e){searchPane.SuggestionsRequested -= new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                                 OnSearchPaneSuggestionsRequested);}

        private void OnSearchPaneSuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs e){var queryText = e.QueryText;if (!string.IsNullOrEmpty(queryText)){var request = e.Request;                // 提供有关查询文本的语言信息（用户通过输入法编辑器 (IME) 输入）的对象。var linguisticDetails = e.LinguisticDetails;foreach (string alternative in linguisticDetails.QueryTextAlternatives){foreach (string suggestion in suggestionList){if (suggestion.StartsWith(alternative, StringComparison.CurrentCultureIgnoreCase)){//  将查询建议追加到搜索窗格的搜索建议列表中。
                                request.SearchSuggestionCollection.AppendQuerySuggestion(suggestion);// 最多 5 条建议if (request.SearchSuggestionCollection.Size >= 5){break;}}}if (request.SearchSuggestionCollection.Size >= MainPage.SearchPaneMaxSuggestions){break;}}if (request.SearchSuggestionCollection.Size > 0){//Suggestions provided for query:  queryText
                }else{//No suggestions provided for query: queryText
                }}}

  //导航到页面时启用本地文件建议protected override void OnNavigatedTo(NavigationEventArgs e){SetLocalContentSuggestions(true);}  // 导航走时关闭protected override void OnNavigatedFrom(NavigationEventArgs e){SetLocalContentSuggestions(false);}

  private void SetLocalContentSuggestions(bool isLocal){     //控制 Windows 提供本地文件的 建议列表
     //这段代码可以放到应用的全局区域，以使应用加载完成后就运行
     // 存储确定应用程序是否提供基于本地文件的建议的设置以及定义用于
     //定位和筛选这些建议的条件的设置。var settings = new LocalContentSuggestionSettings();      //指示基于本地文件的建议是否在搜索窗格中显示。settings.Enabled = isLocal;if (isLocal){
         // 包含用于提供建议的文件的 storageFolder 对象列表。
          settings.Locations.Add(KnownFolders.MusicLibrary);         //高级查询语法 (AQS) 字符串，限制用于提供建议的文件类型。settings.AqsFilter = "kind:Music";}     // 指定基于本地文件的建议是否自动显示在搜索窗格，并定义
     //Windows 使用的条件来定位和筛选这些建议。
      SearchPane.GetForCurrentView().SetLocalContentSuggestionSettings(settings);}

<!--输入返回搜索建议的服务器的 URI-->
<TextBox x:Name="UrlTextBox/>

        protected override void OnNavigatedTo(NavigationEventArgs e){           //可以再 App.xaml.cs 的 OnLaunched 或者 OnSearchActivated 事件中初始化searchPane.SuggestionsRequested += new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                          OnSearchPaneSuggestionsRequested);}protected override void OnNavigatedFrom(NavigationEventArgs e){searchPane.SuggestionsRequested -= new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                         OnSearchPaneSuggestionsRequested);}

 private SearchPane searchPane = SearchPane.GetForCurrentView();private HttpClient httpClient = new HttpClient();private Task<string> currentHttpTask = null;

 ~Scenario5(){Dispose();}public void Dispose(){if (httpClient != null){httpClient.Dispose();httpClient = null;}}

        private async void OnSearchPaneSuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs e){var queryText = e.QueryText;if (!string.IsNullOrEmpty(queryText) && !string.IsNullOrEmpty(UrlTextBox.Text){// 存储有关请求的建议和信息的对象。var request = e.Request;              // 检索允许应用程序异步响应建议请求的对象。var deferral = request.GetDeferral();try{                    //调用下面的方法// 使用支持 OpenSearch Suggestions 格式的 URL
                    //来显示从 Web Service 返回的搜索建议// 查看 OpenSearch Suggestions  格式的描述 : http://www.opensearch.org/Specifications/OpenSearch/Extensions/Suggestions/1.0//使用查询语句替换 URL 中的 "{searchTerms}" Task task = GetSuggestionsAsync(Regex.Replace(UrlTextBox.Text, "{searchTerms}", Uri.EscapeDataString(queryText)),                                                           request.SearchSuggestionCollection);await task;                  // 如果已成功完成执行的任务。if (task.Status == TaskStatus.RanToCompletion){if (request.SearchSuggestionCollection.Size > 0){// Suggestions provided for query:  queryText
                        }else{// No suggestions provided for query: queryText
                        }}}catch (TaskCanceledException){// 我们已经取消 task.
                }catch (FormatException){//  Suggestions could not be retrieved, please verify that the URL points to a valid service                    //(for example http://contoso.com?q={searchTerms}"
                }catch (Exception){// Suggestions could not be displayed, please verify that the service provides valid OpenSearch suggestions
                }finally{                   //在处理 suggestionsrequested 事件时应用程序已完成填充
                   //searchSuggestionCollection 对象的信号。
                      deferral.Complete();}}}

 private async Task GetSuggestionsAsync(string str, SearchSuggestionCollection suggestions){// Cancel the previous suggestion request if it is not finished.
     //如果没有完成就取消前面的 搜索建议的请求if (currentHttpTask != null){//  返回表示返回结果的开始任务的 Windows 运行时异步操作。
         //   source:  已启动的任务。//   TResult:  返回结果的类型。// 返回结果:  表示开始的任务的 Windows.Foundation.IAsyncOperation<TResult> 实例。//  public static IAsyncOperation<TResult> AsAsyncOperation<TResult>(this Task<TResult> source);currentHttpTask.AsAsyncOperation<string>().Cancel();}// 从一个打开的搜索服务获取建议。
     //将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。currentHttpTask = httpClient.GetStringAsync(str);string response = await currentHttpTask;    // 分析表示 JsonArray 的指定 JSON 字符串。JsonArray parsedResponse = JsonArray.Parse(response);if (parsedResponse.Count > 1){foreach (JsonValue value in parsedResponse[1].GetArray()){suggestions.AppendQuerySuggestion(value.GetString());if (suggestions.Size >= 5){break;}}}}

  <TextBox x:Name="UrlTextBox" />

private SearchPane searchPane = SearchPane.GetForCurrentView();
private IAsyncOperation<XmlDocument> currentXmlRequestOp = null;

        protected override void OnNavigatedTo(NavigationEventArgs e){searchPane.SuggestionsRequested += new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                                  OnSearchPaneSuggestionsRequested);           //  当用户选择由您的应用程序提供，且显示在搜索窗格中的其中一个建议结果时激发。searchPane.ResultSuggestionChosen += new TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs>(                                  OnResultSuggestionChosen);}protected override void OnNavigatedFrom(NavigationEventArgs e){searchPane.SuggestionsRequested -= new TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs>(                                                 OnSearchPaneSuggestionsRequested);searchPane.ResultSuggestionChosen -= new TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs>(                                                 OnResultSuggestionChosen);}

        private async void OnSearchPaneSuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs e){var queryText = e.QueryText;if (!string.IsNullOrEmpty(queryText) && ! string.IsNullOrEmpty(UrlTextBox.Text)){var request = e.Request;var deferral = request.GetDeferral();try{// 关于 XML 的建议格式描述： http://msdn.microsoft.com/en-us/library/cc848863(v=vs.85).aspx Task task = GetSuggestionsAsync(Regex.Replace(UrlTextBox.Text, "{searchTerms}", Uri.EscapeDataString(queryText)),                                              request.SearchSuggestionCollection);await task;if (task.Status == TaskStatus.RanToCompletion){if (request.SearchSuggestionCollection.Size > 0){// Suggestions provided for query:  queryText
                        }else{// No suggestions provided for query:  queryText
                        }}}catch (TaskCanceledException){}catch (FormatException){// Suggestions could not be retrieved, please verify that the URL points to a valid service                     //(for example http://contoso.com?q={searchTerms})
                }catch (Exception){// Suggestions could not be displayed, please verify that the service provides valid XML Search Suggestions
                }finally{deferral.Complete();}}}

         private async Task GetSuggestionsAsync(string str, SearchSuggestionCollection suggestions){// 如果没有完成，就取消之前向服务器发起的请求if (currentXmlRequestOp != null){currentXmlRequestOp.Cancel();}// 从 web service 获取数据.currentXmlRequestOp = XmlDocument.LoadFromUriAsync(new Uri(str));XmlDocument doc = await currentXmlRequestOp;currentXmlRequestOp = null;            //返回包含指定名称的元素集合。XmlNodeList nodes = doc.GetElementsByTagName("Section");if (nodes.Count > 0){IXmlNode section = nodes[0];foreach (IXmlNode node in section.ChildNodes){                  //节点的类型不为 XmlElement 类型。if (node.NodeType != NodeType.ElementNode){continue;}if (node.NodeName.Equals("Separator", StringComparison.CurrentCultureIgnoreCase)){string title = null;IXmlNode titleAttr = node.Attributes.GetNamedItem("title");if (titleAttr != null){title = titleAttr.NodeValue.ToString();}suggestions.AppendSearchSeparator(string.IsNullOrWhiteSpace(title) ? "Suggestions" : title);}else{AddSuggestionFromNode(node, suggestions);}}}}

        private void AddSuggestionFromNode(IXmlNode node, SearchSuggestionCollection suggestions){string text = "";string description = "";string url = "";string imageUrl = "";string imageAlt = "";foreach (IXmlNode subNode in node.ChildNodes){if (subNode.NodeType != NodeType.ElementNode){continue;}if (subNode.NodeName.Equals("Text", StringComparison.CurrentCultureIgnoreCase)){text = subNode.InnerText;}else if (subNode.NodeName.Equals("Description", StringComparison.CurrentCultureIgnoreCase)){description = subNode.InnerText;}else if (subNode.NodeName.Equals("Url", StringComparison.CurrentCultureIgnoreCase)){url = subNode.InnerText;}else if (subNode.NodeName.Equals("Image", StringComparison.CurrentCultureIgnoreCase)){if (subNode.Attributes.GetNamedItem("source") != null){imageUrl = subNode.Attributes.GetNamedItem("source").InnerText;}if (subNode.Attributes.GetNamedItem("alt") != null){imageAlt = subNode.Attributes.GetNamedItem("alt").InnerText;}}}if (string.IsNullOrWhiteSpace(text)){// No proper suggestion item exists
            }else if (string.IsNullOrWhiteSpace(url)){suggestions.AppendQuerySuggestion(text);}else{// The following image should not be used in your application for Result Suggestions.                  //Replace the image with one that is tailored to your contentUri uri = string.IsNullOrWhiteSpace(imageUrl) ? new Uri("ms-appx:///Assets/SDK_ResultSuggestionImage.png") : new Uri(imageUrl);RandomAccessStreamReference imageSource = RandomAccessStreamReference.CreateFromUri(uri);suggestions.AppendResultSuggestion(text, description, url, imageSource, imageAlt);}}

        private void OnResultSuggestionChosen(SearchPane sender, SearchPaneResultSuggestionChosenEventArgs e){// Handle the selection of a result suggestion since the XML Suggestion Format can return these.//  Result suggestion selected with tag:  e.Tag}

  protected override void OnNavigatedTo(NavigationEventArgs e){// 打开 “输入即显示搜索面板”SearchPane.GetForCurrentView().ShowOnKeyboardInput = true;}protected override void OnNavigatedFrom(NavigationEventArgs e){// 关闭 “输入即显示搜索面板”SearchPane.GetForCurrentView().ShowOnKeyboardInput = false;}