Şerit nesne modeline genel bakış

Office çalışma zamanı için Visual Studio Araçları, çalışma zamanında Şerit denetimlerinin özelliklerini almak ve ayarlamak için kullanabileceğiniz kesin olarak belirlenmiş bir nesne modeli sunar. Örneğin, menü denetimlerini dinamik olarak doldurabilir veya denetimleri bağlamsal olarak gösterip gizleyebilirsiniz. Bir şeride sekmeler, gruplar ve denetimler de ekleyebilirsiniz, ancak yalnızca şerit Office uygulaması tarafından yüklenmeden önce. Bilgi için bkz . Salt okunur hale gelen özellikleri ayarlama.

Ş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 Şerit nesne modeli çoğunlukla Şerit sınıfı, Şerit olayları ve Şerit denetim sınıflarından oluşur.

Şerit sınıfı

Projeye yeni bir Şerit (Visual Tasarım Aracı) öğesi eklediğinizde, Visual Studio projenize bir Şerit sınıfı ekler. Şerit sınıfı sınıfından devralırRibbonBase.

Bu sınıf, Şerit kod dosyası ile Şerit Tasarım Aracı kod dosyası arasında bölünmüş kısmi bir sınıf olarak görünür.

Şerit olayları

Şerit sınıfı aşağıdaki üç olayı içerir:

Olay	Açıklama
Load	Office uygulaması lication Şerit özelleştirmesini yüklediğinde tetiklenir. Olay Load işleyicisi şerit kod dosyasına otomatik olarak eklenir. Şerit yüklendiğinde özel kod çalıştırmak için bu olay işleyicisini kullanın.
LoadImage	Şerit yüklendiğinde Şerit özelleştirmesindeki görüntüleri önbelleğe almanızı sağlar. Bu olay işleyicisinde Şerit görüntülerini önbelleğe almak için kod yazarsanız hafif bir performans kazancı elde edebilirsiniz. Daha fazla bilgi için bkz. LoadImage.
Close	Şerit örneği kapatıldığında yükseltildi.

Şerit denetimleri

Ad alanı, Microsoft.Office.Tools.Ribbon Araç Kutusu'nun Office Şerit Denetimleri grubunda gördüğünüz her denetim için bir tür içerir.

Aşağıdaki tabloda her Ribbon denetimin türü gösterilmektedir. Her denetimin açıklaması için bkz . Şeride genel bakış.

Denetim adı	Sınıf adı
Box	RibbonBox
Düğme	RibbonButton
ButtonGroup	RibbonButtonGroup
CheckBox	RibbonCheckBox
ComboBox	RibbonComboBox
DropDown	RibbonDropDown
Editbox	RibbonEditBox
Galeri	RibbonGallery
Grup	RibbonGroup
Etiket	RibbonLabel
Menü	RibbonMenu
Ayıraç	RibbonSeparator
Splitbutton	RibbonSplitButton
Sekme	RibbonTab
Togglebutton	RibbonToggleButton

Ad alanı, Microsoft.Office.Tools.Ribbon ad alanında denetim sınıflarının adlarıyla ad çakışmasını önlemek için bu türler için "Şerit" ön ekini System.Windows.Forms kullanır.

Şerit Tasarım Aracı bir denetim eklediğinizde, Şerit Tasarım Aracı bu denetimin sınıfını Şerit Tasarım Aracı kod dosyasında bir alan olarak bildirir.

Şerit denetimlerinin özelliklerini kullanan yaygın görevler

Her Ribbon denetim, bir denetime etiket atama veya denetimleri gizleme ve gösterme gibi çeşitli görevleri gerçekleştirmek için kullanabileceğiniz özellikler içerir.

Bazı durumlarda, Şerit yüklendikten veya bir denetim dinamik menüye eklendikten sonra özellikler salt okunur hale gelir. Daha fazla bilgi için bkz . Salt okunur hale gelen özellikleri ayarlama.

Aşağıdaki tabloda, denetim özelliklerini kullanarak Ribbon gerçekleştirebileceğiniz bazı görevler açıklanmaktadır.

Bu görev için:	Bunu yapın:
Denetimi gizleme veya gösterme.	Visible özelliğini kullanın.
Denetimi etkinleştirin veya devre dışı bırakın.	Enabled özelliğini kullanın.
Denetimin boyutunu ayarlayın.	ControlSize özelliğini kullanın.
Bir denetimde görüntülenen görüntüyü alın.	Image özelliğini kullanın.
Denetimin etiketini değiştirin.	Label özelliğini kullanın.
Denetime kullanıcı tanımlı veriler ekleyin.	Tag özelliğini kullanın.
, RibbonDropDown, RibbonGalleryveya içindeki RibbonBoxöğeleri alma RibbonSplitButton Denetim.	Items özelliğini kullanın.
Bir , RibbonDropDownveya RibbonGallery denetimine RibbonComboBoxöğe ekleyin.	Items özelliğini kullanın.
öğesine RibbonMenudenetimler ekleyin.	Items özelliğini kullanın. Şerit Office uygulaması'a RibbonMenu yüklendikten sonra öğesine denetim eklemek için, Şerit Office uygulaması'e yüklenmeden önce özelliğini true olarak ayarlamanız Dynamic gerekir. Bilgi için bkz . Salt okunur hale gelen özellikleri ayarlama.
öğesinin seçili öğesini RibbonComboBoxalma RibbonDropDownveya RibbonGallery.	SelectedItem özelliğini kullanın. için RibbonComboBoxözelliğini kullanın Text .
Grupları bir RibbonTabüzerinde alın.	Groups özelliğini kullanın.
içinde RibbonGallerygörünen satır ve sütun sayısını belirtin.	RowCount ve ColumnCount özelliklerini kullanın.

Salt okunur hale gelen özellikleri ayarlama

Bazı özellikler yalnızca şerit yüklenmeden önce ayarlanabilir. Bu özellikleri ayarlamak için üç yer vardır:

• Visual Studio Özellikleri penceresinde.

• Şerit sınıfının oluşturucusunda.

• CreateRibbonExtensibilityObject Projenizin , ThisWorkbookveya ThisDocument sınıfının yöntemindeThisAddin.

  Dinamik menüler bazı özel durumlar sağlar. Menüyü içeren şerit yüklendikten sonra bile yeni denetimler oluşturabilir, özelliklerini ayarlayabilir ve çalışma zamanında dinamik bir menüye ekleyebilirsiniz.

  Dinamik menüye eklediğiniz denetimlerin özellikleri istediğiniz zaman ayarlanabilir.

  Daha fazla bilgi için bkz . Salt okunur hale gelen özellikler.

Şeridin oluşturucusunda özellikleri ayarlama

Şerit sınıfının oluşturucusunda bir Ribbon denetimin özelliklerini ayarlayabilirsiniz. Bu kod, yöntemine yapılan çağrıdan InitializeComponent sonra görünmelidir. Aşağıdaki örnek, geçerli saat 17:00 Pasifik Saati (UTC-8) veya üzeriyse gruba yeni bir düğme ekler.

Aşağıdaki kodu ekleyin.

C#

public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
    if (System.DateTime.Now.Hour > 16)
    {
        Microsoft.Office.Tools.Ribbon.RibbonButton button =
            this.Factory.CreateRibbonButton();
        button.Label = "New Button";
        group1.Items.Add(button);
    }
}

VB

<System.Diagnostics.DebuggerNonUserCode()> _
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())

    'This call is required by the Component Designer.
    InitializeComponent()
    Dim MyButton As Microsoft.Office.Tools.Ribbon.RibbonButton = _
        Me.Factory.CreateRibbonButton()
    MyButton.Label = "New Button"
    If System.DateTime.Now.Hour > 16 Then
        Group1.Items.Add(MyButton)
    End If

End Sub

Visual Studio 2008'den yükseltilen Visual C# projelerinde oluşturucu Şerit kod dosyasında görünür.

Visual Basic projelerinde veya Visual Studio 2013'te oluşturduğunuz Visual C# projelerinde oluşturucu Şerit Tasarım Aracı kod dosyasında görünür. Bu dosya YourRibbonItem.Tasarım Aracı olarak adlandırılır. cs veya YourRibbonItem.Tasarım Aracı. vb. Bu dosyayı Visual Basic projelerinde görmek için önce Çözüm Gezgini'de Tüm Dosyaları Göster düğmesine tıklamanız gerekir.

CreateRibbonExtensibilityObject yönteminde özellikleri ayarlama

Projenizin , ThisWorkbookveya ThisDocument sınıfında yöntemini geçersiz kıldığınızda CreateRibbonExtensibilityObject denetimin RibbonThisAddinözelliklerini ayarlayabilirsiniz. Yöntemi hakkında CreateRibbonExtensibilityObject daha fazla bilgi için bkz . Şeride Genel Bakış.

Aşağıdaki örnek, Bir Excel çalışma kitabı projesi sınıfının CreateRibbonExtensibilityObject yönteminde ThisWorkbook Şerit özelliklerini ayarlar.

Aşağıdaki kodu ekleyin.

C#

protected override Microsoft.Office.Core.IRibbonExtensibility
    CreateRibbonExtensibilityObject()
{
    bool myCondition = false;
    if (myCondition == true)
    {
        Ribbon1 tempRibbon = new Ribbon1();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabHome";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager( 
            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
             { tempRibbon });
    }
    else
    {
        Ribbon2 tempRibbon = new Ribbon2();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabInsert";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { tempRibbon });
    }
}

VB

Protected Overrides Function CreateRibbonExtensibilityObject() _
    As Microsoft.Office.Core.IRibbonExtensibility
    Dim myCondition As Boolean = True
    If myCondition = True Then
        Dim tempRibbon As New Ribbon1()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabHome"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    Else
        Dim tempRibbon As New Ribbon2()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabInsert"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    End If
End Function

Salt okunur hale gelen özellikler

Aşağıdaki tabloda, yalnızca şerit yüklenmeden önce ayarlanabilen özellikler gösterilmektedir.

Not

Dinamik menülerdeki denetimlerin özelliklerini istediğiniz zaman ayarlayabilirsiniz. Bu tablo bu durumda geçerli değildir.

Özellik	Şerit denetim sınıfı
BoxStyle	RibbonBox
Buttontype	RibbonSplitButton
Columncount	RibbonGallery
Controlıd	RibbonTab
DialogLauncher	RibbonGroup
Dinamik	RibbonMenu
Küresel	OfficeRibbon
Gruplar	RibbonTab
Imagename	RibbonButton RibbonComboBox RibbonDialogLauncher RibbonDropDown RibbonEditBox RibbonGallery RibbonMenu RibbonSplitButton RibbonToggleButton
Öğe Boyutu	RibbonMenu RibbonSplitButton
Maxlength	RibbonComboBox RibbonEditBox
Ad	RibbonComponent
Bölme	RibbonButton RibbonCheckBox RibbonGallery RibbonGroup RibbonMenu RibbonSeparator RibbonSplitButton RibbonTab RibbonToggleButton
Şerit Türü	OfficeRibbon
Rowcount	RibbonGallery
ShowItemImage	RibbonComboBox RibbonDropDown RibbonGallery
ShowItemLabel	RibbonDropDown RibbonGallery
ShowItemSelection	RibbonGallery
SizeString	RibbonComboBox RibbonDropDown RibbonEditBox
StartFromScratch	OfficeRibbon
Sekmeler	OfficeRibbon
Başlık	RibbonSeparator

Outlook denetçilerinde görünen şeritlerin özelliklerini ayarlama

Bir kullanıcı, şeridin görüntülendiği bir Denetçiyi her açtığında şeridin yeni bir örneği oluşturulur. Ancak, yukarıdaki tabloda listelenen özellikleri yalnızca şeridin ilk örneği oluşturulmadan önce ayarlayabilirsiniz. İlk örnek oluşturulduktan sonra, ilk örnek Outlook'un şeridi yüklemek için kullandığı XML dosyasını tanımladığından bu özellikler salt okunur hale gelir.

Şeridin diğer örnekleri oluşturulduğunda bu özelliklerden herhangi birini farklı bir değere ayarlayan koşullu mantığınız varsa, bu kodun hiçbir etkisi olmaz.

Not

Outlook Şeridi'ne eklediğiniz her denetim için Name özelliğinin ayarlandığından emin olun. Outlook Şeridi'ne çalışma zamanında denetim eklerseniz, kodunuzda bu özelliği ayarlamanız gerekir. Tasarım zamanında Outlook Şeridi'ne denetim eklerseniz, Name özelliği otomatik olarak ayarlanır.

Şerit denetimi olayları

Her denetim sınıfı bir veya daha fazla olay içerir. Aşağıdaki tabloda bu olaylar açıklanmaktadır.

Olay	Açıklama
İleri'ye	Bir denetime tıklandığında gerçekleşir.
TextChanged	Düzenleme kutusunun veya birleşik giriş kutusunun metni değiştirildiğinde gerçekleşir.
Öğeler Yükleniyor	Denetimin Items koleksiyonu Office tarafından istendiğinde gerçekleşir. Kodunuz denetimin özelliklerini değiştirene veya yöntemini çağırana kadar Office Items koleksiyonunu önbelleğe InvalidateControl alır.
Buttonclick	veya RibbonDropDown içindeki RibbonGallery bir düğmeye tıklandığında gerçekleşir.
Selectionchanged	veya RibbonGallery içindeki seçim değiştiğinde RibbonDropDown gerçekleşir.
DialogLauncherClick	Bir grubun sağ alt köşesindeki iletişim kutusu başlatıcı simgesine tıklandığında gerçekleşir.

Bu olayların olay işleyicileri aşağıdaki iki parametreye sahiptir.

Parametre	Açıklama
Gönderen	Object Olayı tetikleyen denetimi temsil eden.
E	içeren RibbonControlEventArgs bir IRibbonControl. Office çalışma zamanı için Visual Studio Araçları tarafından sağlanan Şerit nesne modelinde bulunmayan herhangi bir özelliğe erişmek için bu denetimi kullanın.

İlgili içerik

• Çalışma zamanında şeride erişme
• Şeride genel bakış
• Nasıl yapılır: Şeridi özelleştirmeye başlama
• Şerit Tasarımcısı
• İzlenecek yol: Şerit Tasarım Aracı kullanarak özel sekme oluşturma
• İzlenecek yol: Çalışma zamanında şeritteki denetimleri güncelleştirme
• Outlook için şeridi özelleştirme
• Nasıl yapılır: Yerleşik sekmeyi özelleştirme
• Nasıl yapılır: Backstage görünümüne denetim ekleme
• Nasıl yapılır: Şerit Tasarım Aracı Şerit XML'sine şerit dışarı aktarma
• Nasıl yapılır: Eklenti kullanıcı arabirimi hatalarını gösterme