विंडोज 8. अनुबंध "खोज" विस्तार से

अनुप्रयोगों के भीतर खोजें विंडोज 8 की नई, सबसे महत्वपूर्ण और दिलचस्प विशेषताओं में से एक है। खोज डिवाइस पर न केवल फाइलों और दस्तावेजों को खोजने की क्षमता प्रदान करती है, बल्कि आपको स्थापित अनुप्रयोगों के अंदर भी खोज करने की अनुमति देती है।

यह लेख चर्चा करता है:
1. मेट्रो आवेदन में खोज का एकीकरण
2. प्रासंगिक संकेत (सुझाव)।
3. डेटा दर्ज करते ही अनुरोध को संसाधित करना।
4. खोज अनुबंध (सामान्य एकीकरण त्रुटियों) का लापरवाह उपयोग।

1. मेट्रो आवेदन में खोज का एकीकरण

डिफ़ॉल्ट रूप से, एप्लिकेशन खोज अनुबंध का समर्थन नहीं करते हैं। इस लेख में, हम देखेंगे कि आप किसी एप्लिकेशन के अंदर खोज कैसे जोड़ सकते हैं।

खोज अनुबंध के लिए समर्थन जोड़ने का सबसे आसान तरीका स्टूडियो में तैयार टेम्पलेट का उपयोग करना है:



VS2012 में एक अंतर्निहित SearchContract टेम्प्लेट है जो प्रकट में संबंधित प्रविष्टि जोड़ता है (यदि यह पहले से नहीं किया गया है), app.xaml.cs (यदि यह पहले से ही नहीं किया गया है तो OnSearchActivated विधि को ओवरराइड करते हुए) में एक प्रविष्टि जोड़ता है, और न्यूनतम प्रसंस्करण तर्क के साथ खोज क्वेरी को स्वीकार करने वाला पृष्ठ जोड़ता है। ।

हम इस टेम्प्लेट के उपयोग पर विस्तार से नहीं देखेंगे और चरण दर चरण एक खोज अनुबंध के लिए समर्थन जोड़ने पर विचार करेंगे:

सबसे पहले, एप्लिकेशन मैनिफ़ेस्ट (Package.appxmanifest फ़ाइल) में हमें यह इंगित करना होगा कि हमारा एप्लिकेशन खोज अनुबंध का समर्थन करता है। ऐसा करने के लिए, स्टूडियो में इस प्रकटन को खोलें और "अनुबंध" टैब में खोज अनुबंध जोड़ें।


इसके अलावा, एप्लिकेशन क्लास "app.xaml.cs" में, हम खोज अनुबंध के माध्यम से एप्लिकेशन सक्रियण एल्गोरिथ्म को ओवरराइड कर सकते हैं और हमें आवश्यक तर्क निर्दिष्ट कर सकते हैं। सादगी के लिए, हम यह सुनिश्चित करेंगे कि खोज अनुबंध के तहत सक्रिय होने पर हम हमेशा एक अलग पृष्ठ (SearchPage.xaml) खोलें।

protected override void OnSearchActivated(SearchActivatedEventArgs args) { var frame = Window.Current.Content as Frame; if(frame==null) { frame=new Frame(); Window.Current.Content = frame; } frame.Navigate(typeof(SearchPage), args.QueryText); Window.Current.Activate(); } 

इस पद्धति में, हम उपयोगकर्ता को सर्चपेज पेज पर पुनर्निर्देशित करते हैं, जहां खोज क्वेरी को पैरामीटर के रूप में निर्दिष्ट किया गया है।

ध्यान रखें कि यदि एप्लिकेशन लॉन्च नहीं किया गया था, तो एप्लिकेशन को OnSearchActivated विधि के माध्यम से लॉन्च किया गया है। इस संबंध में, वर्तमान फ्रेम अभी तक नहीं बनाया जा सकता है। पहली बार एप्लिकेशन लॉन्च होने पर फ्रेम को इनिशियलाइज़ करने के लिए एक नल चेक किया जाता है।

सर्चपेज पेज पर, हम अब दिए गए पैरामीटर से खोज क्वेरी प्राप्त करके खोज परिणाम प्रदर्शित कर सकते हैं:

  protected override void OnNavigatedTo(NavigationEventArgs e) { var query = (string)e.Parameter; SearchByQuery(query); } private void SearchByQuery(string queryText) { pageTitle.Text = "Search result for \"" + queryText + "\":"; //    } 

2. प्रासंगिक संकेत (सुझाव)।

खोज अनुबंध एपीआई हमें खोज वाक्यांश टाइप करते समय प्रासंगिक संकेत जोड़ने की अनुमति देता है।
एप्लिकेशन प्रासंगिक संकेत केवल तभी काम कर सकते हैं जब उपयोगकर्ता खोज के लिए एप्लिकेशन का चयन (सक्रिय) करता है।


1. 1. पाठ संकेत देता है

ऐड सपोर्ट काफी सरल है, पेज डिजाइनर में हम संदर्भ प्रॉम्प्ट अनुरोध अनुरोध घटना के लिए सदस्यता ले सकते हैं।

  public SearchPage()        {            this.InitializeComponent();            SearchPane.GetForCurrentView().SuggestionsRequested += SearchPage_SuggestionsRequested;        } 

SearchPage_SuggestionsRequested पद्धति में आगे हम आवश्यक प्रासंगिक संकेत जोड़ सकते हैं:

  void SearchPage_SuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs args)        {            var products=new[] { "apple", "cheese", "bread", "onion", "orange", "potato"}            args.Request.SearchSuggestionCollection.AppendQuerySuggestions(products);        } 

अब, यदि हम कंस्ट्रक्टर में क्वेरी चयन घटना की सदस्यता लेते हैं:

SearchPane.GetForCurrentView ()। QueryChanged + = SearchPage_QueryChanged;

हम संकेतों से उपयोगकर्ता के चयन को संसाधित करने में सक्षम होंगे।

  void SearchPage_QueryChanged(SearchPane sender, SearchPaneQueryChangedEventArgs args)        {            SearchByQuery(args.QueryText);        } 

2.2। चुनौतीपूर्ण सुझाव

SearchContract API हमें अधिक जटिल प्रकार के प्रासंगिक संकेतों को लागू करने की अनुमति देता है:




मान लीजिए कि हमारे पास तर्क (लॉजिकलेयर) की एक निश्चित परत है जो हमें खेतों के साथ एक उत्पाद लौटाती है:

  public class Product    {        public string Name { get; set; }        public string Image { get; set; }        public string Description { get; set; }        public string Id { get; set; }    } 

अब SearchPage_SuggestionsRequested पद्धति में, हमें अधिक जटिल संकेत जोड़ने के लिए args.Request.SearchSuggestionCollection.AppendResultSuggestion विधि का उपयोग करना चाहिए।

  void SearchPage_SuggestionsRequested(SearchPane sender, SearchPaneSuggestionsRequestedEventArgs args)        {            foreach (var product in LogicLayer.SearchProduct(args.QueryText))            {                var image = RandomAccessStreamReference.CreateFromUri(newUri(product.Image));                args.Request.SearchSuggestionCollection.AppendResultSuggestion(product.Name, product.Description, product.Id, image, String.Empty);            }        } 

यहां हम उत्पाद आईडी को टैग के रूप में पास करते हैं। जब कोई उपयोगकर्ता जटिल संकेतों का चयन करता है, तो QueryChanged इवेंट फायर नहीं करता है। जटिल संकेतों के प्रसंस्करण के लिए एक विशेष है
ResultSuggestionChosen घटना।

हम इस घटना के प्रसंस्करण को कंस्ट्रक्टर में जोड़ सकते हैं।

SearchPane.GetForCurrentView (); ResultSuggestionChosen + = SearchPage_ResultSuggestionChosen;

अब हम उत्पाद पहचानकर्ता के लिए एक लिंक प्राप्त कर सकते हैं और इसे संसाधित कर सकते हैं:

  void SearchPage_ResultSuggestionChosen(SearchPane sender, SearchPaneResultSuggestionChosenEventArgs args)        {            var id = args.Tag;            SearchById(query);        } 

2.3। सभी पृष्ठों पर प्रासंगिक मदद।

छोटे अनुप्रयोगों में, प्रासंगिक रूप से प्रत्येक पृष्ठ के लिए अलग-अलग संकेत नहीं करना आसान होगा, लेकिन पूरे आवेदन के लिए एक संकेत।

हम एप्लिकेशन इंस्टेंस में खोज ईवेंट की सदस्यता ले सकते हैं। उसी समय, चूंकि एप्लिकेशन को कई बार सक्रिय किया जा सकता है, हमें यह सुनिश्चित करना चाहिए कि हम केवल एक बार सदस्यता लेंगे।

App.xaml.cs के लिए SubscribeToSearchEvents विधि जोड़ें

  private bool isSubscribed; public void SubscribeToSearchEvents() { if (!isSubscribed) { isSubscribed = true; SearchPane.GetForCurrentView().SuggestionsRequested += SearchPage_SuggestionsRequested; SearchPane.GetForCurrentView().ResultSuggestionChosen += SearchPage_ResultSuggestionChosen; SearchPane.GetForCurrentView().QueryChanged += SearchPage_QueryChanged; } } 

अब बस इसे OnLaunched और OnSearchActivated तरीकों से कॉल करें

  protected override void OnLaunched(LaunchActivatedEventArgs args) { SubscribeToSearchEvents(); ... } 

  protected override void OnSearchActivated(SearchActivatedEventArgs args) { SubscribeToSearchEvents(); } 

3. डेटा दर्ज करते ही अनुरोध को संसाधित करना।

अगर हमें और भी जटिल संकेत लिपियों को लागू करने की आवश्यकता है, या यदि हम क्वेरी को तुरंत संसाधित कर सकते हैं और इनपुट पूरा होने से पहले खोज क्वेरी का परिणाम तुरंत दिखा सकते हैं, तो हम खोज क्वेरी (क्वेरीचेंज्ड) की घटनाओं की सदस्यता ले सकते हैं।

ऐसा करने के लिए, हम निम्न विधि को कंस्ट्रक्टर में जोड़ सकते हैं:

SearchPane.GetForCurrentView ()। QueryChanged + = SearchPage_QueryChanged;

अन्य घटनाओं के समान, हम खोज अनुरोध को संसाधित कर सकते हैं:

  void SearchPage_QueryChanged(SearchPane sender, SearchPaneQueryChangedEventArgs args) { SearchByQuery(args.QueryText); } 

4. हम विशिष्ट खोज एकीकरण त्रुटियों को ठीक करते हैं:

यहां वर्णित सिफारिशें विंडोज 8 आरपी के संस्करण पर लागू होती हैं और निश्चित रूप से रिलीज में तय की जाएंगी। हालाँकि, अब लगभग सभी अनुप्रयोगों में निहित कई "लक्षण" हैं (अंतर्निहित सिस्टम अनुप्रयोग जैसे कि पीपल भी शामिल है)।

4.1। मुख्य पृष्ठ पर जाने के अवसर का नुकसान।

यदि आवेदन पहले लॉन्च नहीं किया गया था, तो पहली बार खोज अनुबंध के तहत आवेदन लॉन्च किया गया है, खोज पृष्ठ खुलता है। अब, यदि उपयोगकर्ता मुख्य मेनू पर जाता है और एप्लिकेशन को फिर से शुरू करता है, तो वह खोज पृष्ठ को फिर से देखेगा और वह मुख्य मेनू पर नहीं जा सकेगा, क्योंकि खोज पृष्ठ पर बैक बटन केवल तभी दिखाई देगा जब खोज से पहले एप्लिकेशन लॉन्च किया गया था। मुख्य पृष्ठ पर पहुंचने का एकमात्र तरीका केवल आवेदन को बंद करना और इसे पुनरारंभ करना है।

इस समस्या को ठीक करने के लिए काफी सरल है। फ़्रेम को प्रारंभ करते समय खोज एप्लिकेशन (OnSearchActivated) को सक्रिय करने की विधि में, हम मुख्य पृष्ठ पर एक अतिरिक्त संक्रमण भी जोड़ देंगे।

  protected override void OnSearchActivated(SearchActivatedEventArgs args)        {            var frame = Window.Current.Content as Frame;            if(frame==null)            {                frame=new Frame();                Window.Current.Content = frame; 

  //                  frame.Navigate(typeof(MainPage));            }                       frame.Navigate(typeof(SearchPage), args.QueryText);            Window.Current.Activate();        } 

4.2। एकाधिक खोज पृष्ठ उदाहरण

यदि आप एक पंक्ति में कई खोज वाक्यांश दर्ज करते हैं, तो प्रत्येक बार पृष्ठ की एक और प्रतिलिपि बनाई जाती है, और बैक बटन का उपयोग करके मुख्य पृष्ठ पर पहुंचने का प्रयास इस तथ्य की ओर जाता है कि हम पिछले खोज पृष्ठ पर पहुंचते हैं। शायद यह बग नहीं है, लेकिन एक विशेषता है, इस मामले में यह ध्यान में रखा जाना चाहिए कि खोज की घटना प्रत्येक बनाए गए उदाहरण में चालू हो जाती है और कई उदाहरणों से प्रसंस्करण अनुरोधों से गंभीर प्रदर्शन समस्याएं हो सकती हैं।
व्यक्तिगत रूप से, मेरी राय एक बग है, क्योंकि काफी बार मैं मुख्य पृष्ठ पर वापस लौटने के लिए कई बार बैक बटन दबाने की आवश्यकता से नाराज था।

एक समाधान काफी सरल है। खोज एप्लिकेशन को सक्रिय करते समय, जांचें कि क्या वर्तमान पृष्ठ एक खोज पृष्ठ है और इस मामले में वापस जाएं:

  protected override void OnSearchActivated(SearchActivatedEventArgs args)        {           RemoveSearchPage();            var frame = Window.Current.Content as Frame;            if(frame==null)            {                frame=new Frame();                Window.Current.Content = frame;                frame.Navigate(typeof(MainPage));            }                        frame.Navigate(typeof(SearchPage), args.QueryText);            Window.Current.Activate();        } 

तदनुसार, RemoveSearchPage पद्धति का कार्यान्वयन:

  private void RemoveSearchPage() { var frame = Window.Current.Content as Frame; if (frame== null) { return; } var page=frame.Content as Page; if (page == null) { return; } if (page.GetType()==typeof(SearchPage)) { frame.GoBack(); } } 

स्रोत कोड (288.51 केबी)

पुनश्च लेख तैयार करते समय बहुमूल्य टिप्पणियों के लिए हब्बर स्टास पावलोव का धन्यवाद।