İzlenecek Yol: Şerit XML Kullanarak Özel Sekme Oluşturma

Makale
06/10/2015

Bu anlatım kullanarak özel Şerit sekmesinin nasıl gösterir Şerit (xml) öğesi.

Uygulama hedefi: Bu konudaki bilgiler, şu uygulamalar için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir: Excel 2013 ve Excel 2010; InfoPath 2013 ve InfoPath 2010; Outlook 2013 ve Outlook 2010; PowerPoint 2013 ve PowerPoint 2010; Project 2013 ve Project 2010; Visio 2013 ve Visio 2010; Word 2013 ve Word 2010. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

Bu örneklerde aşağıdaki görevler gösterilir:

Düğmelere ekleme Add-Ins sekme.Add-Ins Şerit xml dosyasında tanımlanan varsayılan bir sekme sekme olur.
Microsoft Office Word'ün üzerindeki düğmeleri kullanarak otomatikleştirme Add-Ins sekme.

[!NOT]

Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arayüzü öğelerinden bazıları için farklı adlar veya konumlar gösterebilir.Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler.Daha fazla bilgi için bkz. Visual Studio'da Geliştirme Ayarlarını özelleştirme.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2013 sürümü. Daha fazla bilgi edinmek için, bkz. Office Çözümleri Geliştirmek İçin Bilgisayarı Yapılandırma.
Word 2010 veya Word 2013.

video bağlantısı İlgili video gösterimi için bkz: nasıl ı: Şerit Tasarımcısı Excel Şeritlerini özelleştirmek için kullanın?.

Projeyi Oluşturma

İlk adım Word eklenti projesi oluşturmaktır.Daha sonra özelleştireceğiniz Add-Ins bu belgenin sekmesini.

Yeni bir proje oluşturmak için

Oluşturma bir Word eklenti MyRibbonAddIn adlı proje.

Daha fazla bilgi için bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.

Visual Studioaçılır ThisAddIn.cs veya ThisAddIn.vb ekler ve kod dosyası MyRibbonAddIn için proje Çözüm Gezgini.

Add-Ins sekme oluşturma

Oluşturmak için Add-Ins sekmesinde, Ekle bir Şerit (xml) proje öğesi.İzlenecek bu yolun ilerleyen aşamalarında, bu sekme bazı düğmeler ekleyeceksiniz.

Eklentiler sekmesini oluşturmak için

Proje menüsünde, Yeni Öğe Ekle'yi tıklatın.
İçinde Add New Item iletişim kutusunda seçin Şerit (xml).
Yeni Şerit'in 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.Olarak adlandırılan bir xml dosyası MyRibbon.xml de projenize eklenir.
İçinde Çözüm Gezgini, sağ ThisAddIn.cs veya ThisAddIn.vb[NULL]'ı Görünüm kodu.

Aşağıdaki kodu ekleyip ThisAddIn sınıf.Bu kodu geçersiz kılar CreateRibbonExtensibilityObject Office uygulaması için sınıf yöntemi ve Şerit xml döndürür.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

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

İçinde Çözüm Gezgini, sağ MyRibbonAddIn proje ve ardından Yapı.Projenin hatasız oluşturulduğunu doğrulayın.

Eklentiler sekmesini düğmeleri ekleme

Bu eklenti için hedef kullanıcılar demirbaş metni ve belirli bir tablo için etkin belge ekleme olanağı vermektir.Kullanıcı arabirimi sağlamak için iki düğme eklemek Add-Ins sekmesini Şerit xml dosyasını değiştirerek.İzlenecek bu yolun ilerleyen aşamalarında, düğmeler için geri çağrı yöntemlerini tanımladığınız.Şerit xml dosyası hakkında daha fazla bilgi için bkz: Şerit XML.

Eklentiler sekmesi düğmeler eklemek için

İçinde Çözüm Gezgini, sağ MyRibbon.xml ve ardından açık.

İçeriğini değiştirmek tab ile aşağıdaki xml öğesi.Bu xml varsayılan denetim grubu etiketini değiştirir İçerik, ve iki yeni düğme etiketleri ekler Metni Ekle ve Tablo Ekle.

<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>

Belge düğmeleri kullanarak otomatikleştirme

Eklemeniz gerekir onAction için geri çağrı yöntemlerini Metni Ekle ve Tablo Ekle kullanıcı bunları tıklattığında eylemler gerçekleştirmek için düğmeler.Şerit denetimleri için geri arama yöntemleri hakkında daha fazla bilgi için bkz: Şerit XML.

Düğmeler için geri çağrı yöntemleri eklemenin

İçinde Çözüm Gezgini, sağ MyRibbon.cs veya MyRibbon.vb[NULL]'ı açık.
Üstüne aşağıdaki kodu ekleyin MyRibbon.cs veya MyRibbon.vb dosyası.Bu kod için bir diğer ad oluşturur Microsoft.Office.Interop.Word ad alanı.
```
Imports Word = Microsoft.Office.Interop.Word
```
```
using Word = Microsoft.Office.Interop.Word;
```

Aşağıdaki yöntemi MyRibbon sınıfına ekleyin.Bu için geri arama yöntemi, Metni Ekle düğmesi etkin belge imlecin geçerli konumundaki bir dize ekler.

Public Sub OnTextButton(ByVal control As Office.IRibbonControl)
    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    currentRange.Text = "This text was added by the Ribbon." 
End Sub

public void OnTextButton(Office.IRibbonControl control)
{
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    currentRange.Text = "This text was added by the Ribbon.";
}

Aşağıdaki yöntemi MyRibbon sınıfına ekleyin.Bu geri arama yöntemi için Tablo Ekle düğmesi etkin belge imlecin geçerli konumundaki bir tablo ekler.

Public Sub OnTableButton(ByVal control As Office.IRibbonControl)
    Dim missing As Object = System.Type.Missing

    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    Dim newTable As Word.Table = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add( _
               currentRange, 3, 4)

    ' Get all of the borders except for the diagonal borders. 
    Dim borders() As Word.Border = 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. 
    For Each border As Word.Border In borders
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle
        border.Color = Word.WdColor.wdColorBlue
    Next 
End Sub

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;
    }
}

Eklentiyi Test Etme

Project, Word açılır ve adlı sekme çalıştırdığınızda Add-Ins Şerit'inde görüntülenir.Tıklatın Metni Ekle ve Tablo Ekle üzerindeki düğmeler Add-Ins kodu test etmek için sekme.

Eklentiyi sınamak için

F5 tuşuna basarak projeyi çalıştırın.
Onaylamak Add-Ins sekmesini Şerit üzerinde görünür.
Eklentiler sekmesine tıklayın.
Onaylamak İçerik grubu Şerit üzerinde görünür.
Tıklatın Metni Ekle düğmesini İçerik grubu.

İmlecin geçerli konumundaki belgeye bir dize eklenir.
Tıklatın Tablo Ekle düğmesini İçerik grubu.

İmlecin geçerli konumundaki belgeye bir tablo eklenir.

Sonraki Adımlar

Aşağıdaki konulardan Office KA'nü nasıl özelleştireceğiniz hakkında daha fazla bilgi alabilirsiniz:

Farklı Office uygulamasının Şeridini özelleştirmek.Şerit'i özelleştirmeyi destekleyen uygulamalar hakkında daha fazla bilgi için bkz: Şerite Genel Bakış.
Şerit Tasarımcısı kullanarak bir Office uygulamasının Şeridini özelleştirmek.Daha fazla bilgi için bkz. Şerit Tasarımcısı.
Özel Eylemler bölmesi oluşturma.Daha fazla bilgi için bkz. Eylemler Bölmesine Genel Bakış.
Kullanıcı Arabirimi, Microsoft Office Outlook, Outlook Form bölgeleri kullanarak özelleştirin.Daha fazla bilgi için bkz. İzlenecek Yol: Outlook Form Bölgesi Tasarlama.

Ayrıca bkz.

Aracılığıyla paylaş