एक्सेल शुरुआत ऐड-इन ट्यूटोरियल

हैलो% उपयोगकर्ता नाम%!

हाल ही में, मुझे एक छोटा सा एक्सेल ऐड-ऑन ड्यूटी पर लिखना पड़ा। वैसे, इससे पहले, .NET के तहत MS ऑफिस के साथ मेरा अनुभव साधारण उपयोगिताओं के लिए कम हो गया था, जो कि ऑफिस प्राइमरी इंटरॉप असेंबली का उपयोग करके एक्सेल में रिपोर्ट उत्पन्न करता था। और जब कार्यालय ने Aspose.NET के लिए लाइसेंस खरीदा, तो COM के माध्यम से कार्यालय के साथ बातचीत एक बुरे सपने की तरह भूल गई थी। इसलिए, इस विषय को समझने के लिए, मैं शुरुआती लोगों के लिए समझदार रूसी-भाषा ट्यूटोरियल की कमी से अप्रिय रूप से आश्चर्यचकित था। अब मैं इस अंतर को भरना चाहता हूं। एक उदाहरण के रूप में, हम एक ऐड-इन बनाएंगे, एक बटन के क्लिक पर, वर्तमान शीट पर चालू माह के दिनों की सूची तैयार करता है और दिनों को हाइलाइट करता है। इच्छुक कृपया एक कट के लिए पूछें!

इसके बजाय एक अग्रदूत

मैं पहले से ही एक आरक्षण करना चाहता हूं कि मैं खुद एमएस ऑफिस के लिए विकास के क्षेत्र में एक पेशेवर नहीं हूं, और ऐसे लोग भी हो सकते हैं जो स्माइटरेंस के मेरे फैसले की आलोचना करते हैं। खैर, मुझे किसी भी रचनात्मक आलोचना पर खुशी होगी। साथ ही, यह लेख एक्सेल ऐड-इन लिखने के लिए एक संपूर्ण गाइड नहीं है, एक्सेल ऐड-इन या Microsoft.Office.Core नाम स्थान की सामग्री के विस्तार से वर्णन करने के लिए सेट नहीं है। यह एक परिचयात्मक लेख है, जो मुझे आशा है, एक शुरुआत में उसके लिए एक नया विषय नेविगेट करने में मदद करेगा और आपको ऐड-इन बनाने की प्रक्रिया के माध्यम से मार्गदर्शन करेगा जो कुछ सार्थक करता है। तो चलिए शुरू करते है!

हम समाधान तैयार करते हैं

आइए स्टूडियो खोलें और एक्सेल 2010 एड-इन जैसी एक नई परियोजना बनाएं। चलो इसे नमूना कहते हैं:



यदि आपके लिए सब कुछ सही निकला (और वास्तव में यहां क्या गलत हो सकता है? ..), तो आपको निम्नलिखित संरचना के साथ एक समाधान दिखाई देगा:



हमारे लिए जनरेट किया गया एकमात्र फ़ाइल ThisAddIn.cs है:

public partial class ThisAddIn { private void ThisAddIn_Startup(object sender, System.EventArgs e) { } private void ThisAddIn_Shutdown(object sender, System.EventArgs e) { } #region VSTO generated code /// <summary> /// Required method for Designer support - do not modify /// the contents of this method with the code editor. /// </summary> private void InternalStartup() { this.Startup += new System.EventHandler(ThisAddIn_Startup); this.Shutdown += new System.EventHandler(ThisAddIn_Shutdown); } #endregion } 

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

एक इंटरफ़ेस बनाएँ

समाधान में टाइप रिबन का एक तत्व जोड़ें और इसे नमूनाब्रिबोन कहें



डिजाइनर में, वहां बटन जोड़ें:



और टैब, समूह और बटन के नाम सेट करें:



और एक बटन क्लिक हैंडलर भी बनाएं:

 public partial class SampleRibbon { private void SampleRibbon_Load(object sender, RibbonUIEventArgs e) { } private void button1_Click(object sender, RibbonControlEventArgs e) { MessageBox.Show("Hello, world!"); } } 

आइए हमारी परियोजना को चलाने का प्रयास करें। यदि आपने सब कुछ सही किया है, तो एक्सेल में एक बटन के साथ एक नया टैब होता है, जिस पर क्लिक करके एक संदेश बॉक्स प्रकट होता है।

थोड़ा गहरा खोदना

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

AddInBase क्लास से CreateRibbonExtensibilityObject तरीका, जिससे हमारा ThisAddIn वर्ग वास्तव में विरासत में मिला है, ऐड-इन में कस्टम फ़ीड बनाने के लिए जिम्मेदार है। भगवान का शुक्र है कि इस विधि को विवेकपूर्ण रूप से आभासी बना दिया गया था, इसलिए इसे ओवरलोड करना एक समस्या नहीं होगी। सबसे पहले, ThisAddIn वर्ग में कोड जोड़ें:

 protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject() { return null; } 

और प्रोजेक्ट चलाते हैं। देखा! टैब गायब हो गया है। अब सैंपब्रिबोन क्लास बदलें:

 public partial class SampleRibbon { public event Action ButtonClicked; private void SampleRibbon_Load(object sender, RibbonUIEventArgs e) { } private void button1_Click(object sender, RibbonControlEventArgs e) { if (ButtonClicked != null) ButtonClicked(); } } 

और वर्ग ThisAddIn:

 protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject() { var ribbon = new SampleRibbon(); ribbon.ButtonClicked += ribbon_ButtonClicked; return Globals.Factory.GetRibbonFactory().CreateRibbonManager(new IRibbonExtension[] { ribbon }); } private void ribbon_ButtonClicked() { MessageBox.Show("Hello, world!"); } 

प्रोजेक्ट चलाएं। यदि आपने सब कुछ सही ढंग से किया है, तो टैब फिर से दिखाई देता है, और बटन दबाकर, पहले की तरह, एक संदेश बॉक्स प्रदर्शित होता है।

हम कोशिकाओं के साथ काम करते हैं

अब समय आ गया है कि यह सब उपद्रव वास्तव में किसके लिए शुरू किया गया था - तालिका की पीढ़ी। सबसे पहले, सेल सजावट के लिए सहायक तरीकों की एक जोड़ी बनाएं:

 public static void MarkBold(dynamic border) { border.Weight = XlBorderWeight.xlMedium; } 

यह तरीका सेल बॉर्डर को बोल्ड बनाता है। वैसे, तर्क प्रकार सीमा पर ध्यान दें - डायनेमिक - .NET 4.0 से शुरू करना यह COM ऑब्जेक्ट्स के साथ काम करने का एक बहुत ही सुविधाजनक तरीका है! यदि अचानक आप जानते नहीं हैं, तो मेरा सुझाव है कि आप पढ़ें, उदाहरण के लिए, यह लेख। अपनी सुविधा के लिए, हम कुछ और तरीके बनाएँगे:

 public enum Border { Left = 1, Right = 2, Top = 3, Bottom = 4 } private void MarkCell(dynamic cell, DateTime day) { if (day.DayOfWeek == DayOfWeek.Saturday) { MarkBold(cell.Borders[Border.Left]); MarkBold(cell.Borders[Border.Top]); MarkBold(cell.Borders[Border.Bottom]); } if (day.DayOfWeek == DayOfWeek.Sunday) { MarkBold(cell.Borders[Border.Right]); MarkBold(cell.Borders[Border.Top]); MarkBold(cell.Borders[Border.Bottom]); } cell.Columns[1].ColumnWidth = 4; } 

अब हम महीने के दिनों की सूची प्राप्त करने के लिए एक कोड लिखेंगे:

 private static IEnumerable<DateTime> GetDaysOfCurrentMonth() { var today = DateTime.Today; var dayIter = new DateTime(today.Year, today.Month, 1); while (dayIter.Month == today.Month) { yield return dayIter; dayIter = dayIter.AddDays(1); } } 

और यह सब एक साथ लाओ:

 private void ribbon_ButtonClicked() { GenerateTable(Application.ActiveWorkbook.ActiveSheet, 1, 1); } private void GenerateTable(dynamic wSheet, int row, int column) { var currentMonth = GetDaysOfCurrentMonth().ToArray(); for (int i = 0; i < currentMonth.Length; i++) { wSheet.Cells[row, column + i] = currentMonth[i].Day; MarkCell(wSheet.Cells[row, column + i], currentMonth[i]); } } 

अगर आपने कहीं भी गलती नहीं की है, तो प्रोजेक्ट शुरू करें और हमारे टैब पर बटन पर क्लिक करें, आपको कुछ समान दिखाई देगा:

एक निष्कर्ष के बजाय

मुझे उम्मीद है कि इस लेख को पढ़ने के बाद, आपको .NET के लिए एक्सेल ऐड-इन्स बनाने की एक बुनियादी समझ मिल गई है। आगे पढ़ने के लिए, मैं निश्चित रूप से, एमएसडीएन और इस ब्लॉग की सिफारिश कर सकता हूं - इस विषय का अध्ययन करते समय इससे मुझे बहुत मदद मिली। सभी को शुभकामनाएँ और आपका ध्यान के लिए धन्यवाद!