İzlenecek yol: Şerit XML kullanarak özel sekme oluşturma

  • Makale

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

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

  1. Proje menüsünde Yeni Öğe Ekle'ye tıklayın.

  2. Yeni Öğe Ekle iletişim kutusunda Şerit (XML) öğesini seçin.

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

  4. Çö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.

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

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

  6. Çö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

  1. Çözüm Gezgini'da MyRibbon.xml dosyasına sağ tıklayın ve ardından Aç'a tıklayın.

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

  1. Çözüm Gezgini'de MyRibbon.cs veya MyRibbon.vb'ye sağ tıklayın ve ardından Aç'a tıklayın.

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

    using Word = Microsoft.Office.Interop.Word;

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

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

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

  1. Projenizi çalıştırmak için F5 tuşuna basın.

  2. Eklentiler sekmesinin şeritte görünür olduğunu onaylayın.

  3. Eklentiler sekmesine tıklayın.

  4. şeritte İçerik grubunun görünür olduğunu onaylayın.

  5. İçerik grubunda Metin Ekle düğmesine tıklayın.

    İmlecin geçerli konumunda belgeye bir dize eklenir.

  6. İç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:

İlgili içerik