İzlenecek yol: Şerit XML kullanarak özel sekme oluşturma
Bu kılavuzda, Şerit (XML) öğesini kullanarak özel şerit sekmesinin nasıl oluşturulacağı gösterilmektedir.
Şunlar için geçerlidir: Bu konudaki bilgiler, aşağıdaki uygulamalar için belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir: Excel; InfoPath 2013 ve InfoPath 2010; Outlook; Powerpoint; Proje; Visio; Kelime. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.
Bu izlenecek yol aşağıdaki görevleri gösterir:
Eklentiler sekmesine düğme ekleme. Eklentiler sekmesi, Şerit XML dosyasında tanımlanan varsayılan sekmedir.
Eklentiler sekmesindeki düğmeleri kullanarak Microsoft Office Word'i otomatikleştirme.
Not
Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için bkz . Visual Studio IDE'yi kişiselleştirme.
Önkoşullar
Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:
Microsoft Office geliştirici araçlarını içeren bir Visual Studio sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.
Microsoft Word.
Proje oluşturma
İlk adım bir Word VSTO Eklenti projesi oluşturmaktır. Daha sonra bu belgenin Eklentiler sekmesini özelleştirebilirsiniz.
Yeni proje oluşturmak için
MyRibbonAddIn adlı bir Word Eklentisi projesi oluşturun.
Daha fazla bilgi için bkz . Nasıl yapılır: Visual Studio'da Office projeleri oluşturma.
Visual Studio ThisAddIn.cs veya ThisAddIn.vb kod dosyasını açar ve MyRibbonAddIn projesini Çözüm Gezgini ekler.
VSTO Eklentileri sekmesini oluşturma
Eklentiler sekmesini oluşturmak için projenize bir Şerit (XML) öğesi ekleyin. Bu kılavuzun ilerleyen bölümlerinde bu sekmeye bazı düğmeler ekleyebilirsiniz.
Eklentiler sekmesini oluşturmak için
Proje menüsünde Yeni Öğe Ekle'ye tıklayın.
Yeni Öğe Ekle iletişim kutusunda Şerit (XML) öğesini seçin.
Yeni Şeridin adını MyRibbon olarak değiştirin ve Ekle'ye tıklayın.
MyRibbon.cs veya MyRibbon.vb dosyası tasarımcıda açılır. Projenize MyRibbon.xml adlı bir XML dosyası da eklenir.
Çözüm Gezgini'da ThisAddin.cs veya ThisAddin.vb'ye sağ tıklayın ve ardından Kodu Görüntüle'ye tıklayın.
ThisAddin sınıfına aşağıdaki kodu ekleyin. Bu kod yöntemini geçersiz kılar
CreateRibbonExtensibilityObject
ve Şerit XML sınıfını Office uygulaması'ye döndürür.Çözüm Gezgini'da MyRibbonAddIn projesine sağ tıklayın ve ardından Oluştur'a tıklayın. Projenin hatasız derlendiğini doğrulayın.
Eklentiler sekmesine düğme ekleme
Bu VSTO Eklentisinin amacı, kullanıcılara etkin belgeye ortak metin ve belirli bir tablo eklemenin bir yolunu vermektir. Kullanıcı arabirimini sağlamak için, Şerit XML dosyasını değiştirerek Eklentiler sekmesine iki düğme ekleyin. Bu kılavuzun ilerleyen bölümlerinde düğmeler için geri çağırma yöntemleri tanımlayacaksınız. Şerit XML dosyası hakkında daha fazla bilgi için bkz . Şerit XML.
Eklentiler sekmesine düğme eklemek için
Çözüm Gezgini'da MyRibbon.xml dosyasına sağ tıklayın ve ardından Aç'a tıklayın.
Sekme öğesinin içeriğini aşağıdaki XML ile değiştirin. Bu XML, varsayılan denetim grubunun etiketini İçerik olarak değiştirir ve Metin Ekle ve Tablo Ekle etiketlerini içeren iki yeni düğme ekler.
<tab idMso="TabAddIns"> <group id="ContentGroup" label="Content"> <button id="textButton" label="Insert Text" screentip="Text" onAction="OnTextButton" supertip="Inserts text at the cursor location."/> <button id="tableButton" label="Insert Table" screentip="Table" onAction="OnTableButton" supertip="Inserts a table at the cursor location."/> </group> </tab>
Düğmeleri kullanarak belgeyi otomatikleştirme
Kullanıcı tıkladığında eylem gerçekleştirmek için Metin Ekle ve Tablo Ekle düğmeleri için geri çağırma yöntemleri eklemeniz onAction
gerekir. Şerit denetimleri için geri çağırma yöntemleri hakkında daha fazla bilgi için bkz . Şerit XML'i.
Düğmeler için geri çağırma yöntemleri eklemek için
Çözüm Gezgini'de MyRibbon.cs veya MyRibbon.vb'ye sağ tıklayın ve ardından Aç'a tıklayın.
Aşağıdaki kodu MyRibbon.cs veya MyRibbon.vb dosyasının en üstüne ekleyin. Bu kod ad alanı için Microsoft.Office.Interop.Word bir diğer ad oluşturur.
Sınıfına aşağıdaki yöntemi
MyRibbon
ekleyin. Bu, imlecin geçerli konumundaki etkin belgeye bir dize ekleyen Metin Ekle düğmesinin geri çağırma yöntemidir.Sınıfına aşağıdaki yöntemi
MyRibbon
ekleyin. Bu, imlecin geçerli konumundaki etkin belgeye tablo ekleyen Tablo Ekle düğmesinin geri çağırma yöntemidir.public void OnTableButton(Office.IRibbonControl control) { object missing = System.Type.Missing; Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range; Word.Table newTable = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add( currentRange, 3, 4, ref missing, ref missing); // Get all of the borders except for the diagonal borders. Word.Border[] borders = new Word.Border[6]; borders[0] = newTable.Borders[Word.WdBorderType.wdBorderLeft]; borders[1] = newTable.Borders[Word.WdBorderType.wdBorderRight]; borders[2] = newTable.Borders[Word.WdBorderType.wdBorderTop]; borders[3] = newTable.Borders[Word.WdBorderType.wdBorderBottom]; borders[4] = newTable.Borders[Word.WdBorderType.wdBorderHorizontal]; borders[5] = newTable.Borders[Word.WdBorderType.wdBorderVertical]; // Format each of the borders. foreach (Word.Border border in borders) { border.LineStyle = Word.WdLineStyle.wdLineStyleSingle; border.Color = Word.WdColor.wdColorBlue; } }
VSTO Eklentisini Test Etme
Projeyi çalıştırdığınızda Word açılır ve şeritte Eklentiler adlı sekme görüntülenir. Kodu test etmek için Eklentiler sekmesinde Metin Ekle ve Tablo Ekle düğmelerine tıklayın.
VSTO Eklentinizi test etmek için
Projenizi çalıştırmak için F5 tuşuna basın.
Eklentiler sekmesinin şeritte görünür olduğunu onaylayın.
Eklentiler sekmesine tıklayın.
şeritte İçerik grubunun görünür olduğunu onaylayın.
İçerik grubunda Metin Ekle düğmesine tıklayın.
İmlecin geçerli konumunda belgeye bir dize eklenir.
İçerik grubunda Tablo Ekle düğmesine tıklayın.
İmlecin geçerli konumunda belgeye bir tablo eklenir.
Sonraki adımlar
Office kullanıcı arabirimini özelleştirme hakkında daha fazla bilgiyi şu konulardan öğrenebilirsiniz:
Farklı bir Office uygulaması lication şeridini özelleştirin. Şeridi özelleştirmeyi destekleyen uygulamalar hakkında daha fazla bilgi için bkz . Şeride genel bakış.
Şerit Tasarım Aracı kullanarak Office uygulaması'nin şeridini özelleştirin. Daha fazla bilgi için bkz. Şerit Tasarım Aracı.
Özel eylemler bölmesi oluşturma. Daha fazla bilgi için bkz . Eylemler bölmesine genel bakış.
Outlook Form Bölgelerini kullanarak Microsoft Office Outlook kullanıcı arabirimini özelleştirin. Daha fazla bilgi için bkz . İzlenecek yol: Outlook form bölgesi tasarlama.