RibbonMenu Arabirim

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Ribbon

Bütünleştirilmiş Kod:: Microsoft.Office.Tools.Common.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Şerit sekmesinde veya Microsoft Office Menüsünde bir menüyü temsil eder.

public interface class RibbonMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")>]
type RibbonMenu = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonMenu
Implements IComponent, IDisposable, RibbonControl

Öznitelikler: GuidAttribute

Uygulamalar: RibbonComponent RibbonControl IComponent IDisposable

Örnekler

Aşağıdaki örnekte, çalışma zamanında var olan bir menüye nasıl alt menü ekleneceği ve doldurulacakları gösterilmektedir.

Çalışma zamanında denetimleri güncelleştiren ve Language-Integrated Sorguları (LINQ) kullanarak AdventureWorks örnek veritabanından veri almayı içeren daha zengin bir örnek için bkz . İzlenecek Yol: Çalışma Zamanında Şeritteki Denetimleri Güncelleştirme.

Bu kod örneğini çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:

Office projesine Şerit (Visual Tasarım Aracı) öğesi ekleyin.
Özel sekmeye bir grup ekleyin.
Gruba bir menü ekleyin.
Menünün (Ad) özelliğini olarak CustomerMenuayarlayın.
Menünün Label özelliğini Müşteriler olarak ayarlayın.
Menünün Dynamic özelliğini olarak trueayarlayın.

Bu, Şerit Office uygulamasına yüklendikten sonra çalışma zamanında menüye denetim eklemenize ve kaldırmanıza olanak tanır.

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = this.Factory.CreateRibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = this.Factory.CreateRibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

Açıklamalar

Visual Studio, Araç Kutusu'nunOffice Şerit Denetimleri sekmesinden Bir Menü denetimini Şerit Tasarım Aracı sürüklediğinizde bir RibbonMenu nesne oluşturur.

nesnesinin CreateRibbonMenu yöntemini RibbonFactory kullanarak çalışma zamanında oluşturabilirsinizRibbonMenu.

Nesneye erişmenin RibbonFactory iki yolu vardır:

Şerit sınıfının özelliğini kullanarak Factory . Şerit sınıfınızdaki koddan bu yaklaşımı kullanın.
yöntemini kullanarak Globals.Factory.GetRibbonFactory . Şerit sınıfınızın dışındaki koddan bu yaklaşımı kullanın.

Ortak Görevler

Aşağıdaki tabloda, ortak görevler için yararlı olan üyeler listelenir. Bu görevlerin tümü tasarım zamanında gerçekleştirilebilir. Bu görevlerden bazıları yalnızca Şerit Office uygulamasına yüklenmeden önce veya denetim çalışma zamanında dinamik bir menüye eklenmeden önce çalışma zamanında gerçekleştirilebilir. Daha fazla bilgi için bkz . Şerit Nesne Modeline Genel Bakış.

Görev	Üye
Menüde bir görüntü görüntüleyin.	Image veya ImageName özelliğini kullanın. Yerleşik Şerit denetimlerinde görünen görüntüleri de yeniden kullanabilirsiniz. Bunu yapmak için, menü simgesi olarak görüntülemek istediğiniz yerleşik bir Microsoft Office görüntüsünün kimliğine ayarlayın OfficeImageId .
Menünün boyutunu değiştirin.	ControlSize özelliğini istediğiniz değere ayarlayın. Örneğin, büyük bir menü için olarak `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`ayarlayın.
Menüdeki öğelerin boyutunu değiştirin.	ItemSize özelliğini istediğiniz değere ayarlayın. Örneğin, daha büyük öğeleri görüntülemek için olarak `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`ayarlayın.
Çalışma zamanında menüde değişiklikleri etkinleştirin (örneğin, denetimlerin çalışma zamanında menüye eklenmesini etkinleştirmek için).	Dynamic özelliğini olarak `true`ayarlayın.
Menüdeki denetimlere erişin, menüye denetimler ekleyin veya menüden denetimleri kaldırın.	Items özelliğini kullanın.
Microsoft Office Menüsü'ne, gruba veya menü içerebilen başka bir denetime menü ekleyin.	Microsoft Office Menüsü, grubu veya denetiminin özelliğine bir RibbonMenu`Items` ekleyin.

Not

Bu arabirim, Office için Visual Studio Araçları çalışma zamanı modülü tarafından uygulanır. Kodunuzda gerçekleştirilmesi amaçlanmamıştır. Daha fazla bilgi için bkz. Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

Kullanım

Bu belgede bu türün .NET Framework 4 veya sonraki sürümlerini hedefleyen Office projelerinde kullanılan sürümü açıklanmaktadır. .NET Framework 3.5'i hedefleyen projelerde, bu türün üyeleri farklı olabilir ve bu tür için sağlanan kod örnekleri çalışmayabilir. .NET Framework 3.5'i hedefleyen projelerde bu türle ilgili belgeler için Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: http://go.microsoft.com/fwlink/?LinkId=160658.

Özellikler

ControlSize	Menünün boyutunu alır veya ayarlar.
Description	Geçerli menüde görünen metni alır veya ayarlar.
Dynamic	Menünün çalışma zamanında değiştirilip değiştirilemeyeceğini belirten bir değer alır veya ayarlar.
Enabled	Bunun RibbonControl etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: RibbonControl)
Id	Microsoft Office'in bu RibbonControl nesneyi tanımlamak için kullandığı bir dize alır. (Devralındığı yer: RibbonControl)
Image	Menüde görüntülenen görüntüyü alır veya ayarlar.
ImageName	Menü için bir görüntüyü tanımlamak üzere olay işleyicisinde LoadImage kullanabileceğiniz adı alır veya ayarlar.
Items	Menüde bulunan denetim koleksiyonunu alır.
ItemSize	Menüdeki denetimlerin boyutunu alır veya ayarlar.
KeyTip	Menünün klavye erişim tuşunu alır veya ayarlar.
Label	Menü tarafından görüntülenen metni alır veya ayarlar.
Name	Bu RibbonComponentöğesinin adını alır veya ayarlar. (Devralındığı yer: RibbonComponent)
OfficeImageId	Yerleşik bir Microsoft Office simgesi kullanmak istiyorsanız, görüntüyü menüde görüntülenecek şekilde alır veya ayarlar.
Parent	Bu RibbonComponentöğesinin üst öğesini temsil eden bir RibbonComponent alır. (Devralındığı yer: RibbonComponent)
Position	Menü Microsoft Office Menüsündeyse menünün konumunu alır veya ayarlar.
Ribbon	Denetim hiyerarşisini içeren en üst düzey Ribbon nesneyi alır. (Devralındığı yer: RibbonComponent)
RibbonUI	Microsoft Office uygulaması tarafından Şerit genişletilebilirlik koduna sağlanan IRibbonUI örneğini alır. (Devralındığı yer: RibbonComponent)
ScreenTip	Kullanıcı işaretçiyi menünün üzerine aldığında görünen ipucu metnini alır veya ayarlar.
ShowImage	Menüyle ilişkili görüntünün görünür olup olmadığını gösteren bir değer alır veya ayarlar.
ShowLabel	Menünün etiketinin görünür olup olmadığını belirten bir değer alır veya ayarlar.
SuperTip	Kullanıcı işaretçiyi menünün üzerine getirince görüntülenen çok satırlı ipucu metnini alır veya ayarlar.
Tag	Bu RibbonComponentile ilişkili uygulamaya özgü verileri alır veya ayarlar. (Devralındığı yer: RibbonComponent)
Title	Kullanıcı Microsoft Office Menüsü'ne eklenen bir menüyü genişlettiğinde görüntülenen başlığı alır veya ayarlar.
Visible	Bunun RibbonControl görünür olup olmadığını gösteren bir değer alır veya ayarlar. (Devralındığı yer: RibbonControl)

Yöntemler

PerformDynamicLayout()	öğesinin dinamik menü gibi dinamik bir üst öğesi varsa ve düzen askıya alınmamışsa üst denetimin RibbonComponent Microsoft.Office.Core.IRibbonUI.InvalidateControl yöntemini çağırır. (Devralındığı yer: RibbonComponent)
PerformLayout()	Üst öğeye sahipse ve düzeni askıya alınmamışsa RibbonComponent Microsoft.Office.Core.IRibbonUI.InvalidateControl'u çağırır. (Devralındığı yer: RibbonComponent)
ResumeLayout()	yönteminin etkisini SuspendLayout() tersine çevirir. (Devralındığı yer: RibbonComponent)
ResumeLayout(Boolean)	yönteminin etkisini SuspendLayout() tersine çevirir. (Devralındığı yer: RibbonComponent)
SuspendLayout()	Microsoft Office uygulamasının Şeritteki denetimlerin durumunu yenilemesini engeller. (Devralındığı yer: RibbonComponent)

Ekinlikler

ItemsLoading

Denetimler veya iç içe menüler çalışma zamanında geçerli menüye yüklendiğinde gerçekleşir.

Şunlara uygulanır

Aracılığıyla paylaş