WinRT में अनुबंध सेटिंग्स (विंडोज 8)

विंडोज 8 आकर्षण में उपलब्ध मुख्य अनुबंधों में से एक सेटिंग्स अनुबंध है।
सेटिंग पैनल पैनल चमत्कार में "सेटिंग" बटन द्वारा सक्रिय किया गया है:


एप्लिकेशन सेटिंग्स को नियंत्रित करने के लिए उपयोगकर्ता हमेशा इस पैनल में जा सकता है। (उदाहरण के लिए, स्थान निर्धारित करने की क्षमता को अक्षम करें)।
यह काफी तर्कसंगत होगा कि उपयोगकर्ता यह न सोचें कि आवेदन की सेटिंग्स को खुद कहां देखना है और उसी पैनल में अपनी एप्लिकेशन सेटिंग को कहां रखें।

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


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

आइए विचार करें कि अनुबंध समर्थन को यथासंभव सरल कैसे लागू किया जाए।
OnNavigateTo और OnNavigateFrom विधियों में पृष्ठ पर, हम सेटिंग अनुरोध ईवेंट की सदस्यता लेते हैं और पृष्ठ छोड़ते समय ईवेंट से सदस्यता समाप्त करते हैं:

protected override void OnNavigatedTo(NavigationEventArgs e) { SettingsPane.GetForCurrentView().CommandsRequested += Settings_CommandsRequested; } protected override void OnNavigatedFrom(NavigationEventArgs e) { SettingsPane.GetForCurrentView().CommandsRequested -= Settings_CommandsRequested; } 

SettingsPane Windows.UI.ApplicationSettings नामस्थान में स्थित है; तदनुसार, पृष्ठ शीर्ष लेख में संबंधित नामस्थान घोषणा शामिल होनी चाहिए:

 using Windows.UI.ApplicationSettings; 

जब उपयोगकर्ता चमत्कार पैनल में सेटिंग पैनल को सक्रिय करता है, तो CommandsRequested घटना को निकाल दिया जाता है। हमें उन आदेशों की सूची वापस करनी होगी जो हम उपयोगकर्ता को प्रदान करना चाहते हैं। उदाहरण के लिए, हम दो कमांड्स के बारे में और हेलो कहते हैं! .. पहला पेज के बारे में रीडायरेक्ट करेगा और दूसरा कमांड एक डायलॉग बॉक्स प्रदर्शित करेगा।

 void Settings_CommandsRequested(SettingsPane sender, SettingsPaneCommandsRequestedEventArgs args) { var viewAboutPage = new SettingsCommand("", "About", cmd => { (Window.Current.Content as Frame).Navigate(typeof (AboutPage)); }); args.Request.ApplicationCommands.Add(viewAboutPage); var sayHelloCommand = new SettingsCommand("", "Say Hello!", cmd => { new MessageDialog("Hello! World!").ShowAsync(); }); args.Request.ApplicationCommands.Add(sayHelloCommand); } 

यदि हमने सब कुछ ठीक किया है, तो हमें अपने कमांड के साथ निम्नलिखित पैनल देखना चाहिए:



इस स्थिति में, अनुमतियाँ आइटम हमेशा उपलब्ध रहता है और उपयोगकर्ता हमेशा वहां जा सकता है और सुरक्षा सेटिंग्स प्रबंधित कर सकता है।

अपनी खुद की सेटिंग्स पैनल जोड़ना

अक्सर हमें एक से अधिक बटन की आवश्यकता होती है।

शायद हमारे पैनल में हम टॉगलस्विच, स्लाइडर, कॉम्बोक्स या अन्य नियंत्रणों का उपयोग करेंगे।

सरलतम संस्करण में, आप संक्रमण को कुछ अलग पेज पर व्यवस्थित कर सकते हैं, जहाँ एप्लिकेशन सेटिंग्स समाहित हैं। लेकिन शायद यह उपयोगकर्ता के लिए इस पृष्ठ पर बने रहने के लिए अधिक सुविधाजनक होगा और बस साइड कस्टम पैनल में उपयुक्त सेटिंग्स सेट करें।

इस तरह के पैनल का एक उदाहरण "अनुमतियाँ" कमांड द्वारा लगभग हर एप्लिकेशन में देखा जा सकता है:



WinRT एपीआई एक तैयार पैनल प्रदान नहीं करता है, लेकिन अपने स्वयं के पैनल का कार्यान्वयन काफी सरल है और कई समाधान मिल सकते हैं।

विशेष रूप से, मैंने यहां वर्णित समाधान का लाभ उठाया। इस तथ्य के बावजूद कि कार्यान्वयन अलग है, समाधान का मुख्य विचार वहां से लिया गया है।

सबसे पहले, हमें एक UserControl (UC) जोड़ने की आवश्यकता है जिसमें सभी आवश्यक सेटिंग्स होंगी, आइए इसे AppSettingsPanel कहें

UC में, हम निम्नलिखित कोड लागू करते हैं:

 <UserControl .... Width="350"> <Grid Background="DarkGreen" Margin="0"> <Grid Margin="0" Height="78" VerticalAlignment="Top" Background="Green"> <Button HorizontalAlignment="Left" Margin="10,10,0,0" VerticalAlignment="Top" Style="{StaticResource PreviousAppBarButtonStyle}" Click="ButtonGoBack_Click"/> </Grid> <ToggleSwitch Header="Enable details view" Margin="10,83,0,0" VerticalAlignment="Top" /> </Grid> </UserControl> 

350 का मान सेटिंग पैनल की चौड़ाई के बराबर चुना गया था, यदि वांछित है, तो आप वांछित मान निर्दिष्ट कर सकते हैं।

हैंडलर में, बैक बटन के लिए निम्नलिखित कोड लिखें:

 private void ButtonGoBack_Click(object sender, RoutedEventArgs e) { if (this.Parent is Popup) { (this.Parent as Popup).IsOpen = false; } SettingsPane.Show(); } 

अब जब उपयोगकर्ता "बैक" दबाएगा तो वर्तमान पैनल छिपाया जाएगा और सेटिंग्स पैनल फिर से खुल जाएगा

आगे, हम अपनी परियोजना में एक छोटा सहायक वर्ग जोड़ेंगे:

  public class CustomPanelCommand { private readonly SettingsCommand command; public CustomPanelCommand(UserControl parentPage, string label, Type typeOfPanel) { command = new SettingsCommand("", label, (cmd) => { customSettingsPopup = new Popup() { IsLightDismissEnabled = true, Height = parentPage.ActualHeight }; customSettingsPopup.Closed += customSettingsPopup_Closed; Window.Current.Activated += Current_Activated; var panel = Activator.CreateInstance(typeOfPanel) as UserControl; panel.UpdateLayout(); customSettingsPopup.Width = panel.Width; customSettingsPopup.Height = panel.Height = parentPage.ActualHeight; customSettingsPopup.Child = panel; customSettingsPopup.SetValue(Canvas.LeftProperty, parentPage.ActualWidth - customSettingsPopup.Width); customSettingsPopup.IsOpen = true; }); } public SettingsCommand GetCommand() { return command; } private Popup customSettingsPopup; void customSettingsPopup_Closed(object sender, object e) { Window.Current.Activated -= Current_Activated; } void Current_Activated(object sender, Windows.UI.Core.WindowActivatedEventArgs e) { if (e.WindowActivationState == Windows.UI.Core.CoreWindowActivationState.Deactivated) { customSettingsPopup.IsOpen = false; } } } 

अब, इस सहायक वर्ग की मदद से, हम कस्टम पैनल या प्रत्येक पृष्ठ के लिए अलग सेटिंग्स पैनल के साथ कई बटन जोड़ सकते हैं।

इस सहायक वर्ग का उपयोग करते हुए, हम "मेरे कस्टम सेटिंग" बटन का उपयोग करके अपने पैनल को प्रदर्शित करने के लिए अपने पेज पर एक कोड जोड़ेंगे

 void Settings_CommandsRequested(SettingsPane sender, SettingsPaneCommandsRequestedEventArgs args) { var customCommand =new CustomPanelCommand(this, "My custom settings", typeof (AppSettingsPanel)).GetCommand(); args.Request.ApplicationCommands.Add(customCommand); } 

अब, यदि हम सेटिंग्स को सक्रिय करते हैं और "मेरी कस्टम सेटिंग्स" आइटम का चयन करते हैं, तो हमें निम्नलिखित पैनल देखना चाहिए:



लेख के लिए स्रोत कोड यहां डाउनलोड किया जा सकता है।