Ş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 ,ThisWorkbook
veyaThisDocument
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.
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);
}
}
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 , ThisWorkbook
veya ThisDocument
sınıfında yöntemini geçersiz kıldığınızda CreateRibbonExtensibilityObject
denetimin Ribbon
ThisAddin
ö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.
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 });
}
}
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