RibbonMenu Arabirim
Bir şerit sekmesi veya Microsoft Office menüsünde bir menü gösterir.
Ad alanı: Microsoft.Office.Tools.Ribbon
Derleme: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)
Sözdizimi
'Bildirim
<GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")> _
Public Interface RibbonMenu _
Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : RibbonControl,
RibbonComponent, IComponent, IDisposable
RibbonMenu türü aşağıdaki üyeleri ortaya koyar.
Özellikler
| Ad | Açıklama | |
|---|---|---|
.gif "Genel özellik") |
ControlSize | Alır veya menünün boyutunu ayarlar. |
|
Description | Alır veya geçerli menüde görünen metni ayarlar. |
|
Dynamic | Alır veya menü zamanında değiştirilebilir olup olmadığını gösteren bir değeri ayarlar. |
|
Enabled | Gösteren bir değeri alır veya ayarlar olup olmadığını bu RibbonControl etkindir. (RibbonControl kaynağından devralındı.) |
|
Id | Microsoft Office bu tanımlamak için kullandığı bir dize alır RibbonControl nesne. (RibbonControl kaynağından devralındı.) |
|
Image | Alır veya ayarlar menüsünde görüntülenen resim. |
|
ImageName | Alır veya ayarlar kullanabileceğiniz ad LoadImage olay işleyicisi tanımlamak görüntü menüsü. |
|
Items | Menüsünde denetimleri topluluğu alır. |
|
ItemSize | Alır veya menü denetimleri boyutunu ayarlar. |
|
KeyTip | Alır veya ayarlar menüsünün klavye erişim tuşu. |
|
Label | Alır veya ayarlar menü tarafından görüntülenen metin. |
|
Name | Alır veya ayarlar bu adı RibbonComponent. (RibbonComponent kaynağından devralındı.) |
|
OfficeImageId | Alır veya yerleşik bir Microsoft Office simge kullanmak istiyorsanız, görüntü menüsünde görüntülemek için ayarlar. |
|
Parent | Alır bir RibbonComponent temsil eden bu ana RibbonComponent. (RibbonComponent kaynağından devralındı.) |
|
Position | Alır veya Microsoft Office menüsünde menü çubuğundaysa, menü konumu ayarlar. |
|
Ribbon | Üst düzey alır Ribbon nesne içeren denetim hiyerarşisi. (RibbonComponent kaynağından devralındı.) |
|
RibbonUI | Altyapı. Alır IRibbonUI şerit genişletilebilirliği kod. Microsoft Office uygulaması tarafından sağlanan örnek (RibbonComponent kaynağından devralındı.) |
|
ScreenTip | Alır veya kullanıcı menünün üzerine fare işaretçisini getirdiğinde görüntülenen İpucu metni ayarlar. |
|
ShowImage | Alır veya menüsüyle ilişkili resim görünür olup olmadığını gösteren bir değeri ayarlar. |
|
ShowLabel | Alır veya etiket menüsü görünür olup olmadığını gösteren bir değeri ayarlar. |
|
Site | Alır veya ayarlar ISite ile ilgili IComponent. (IComponent kaynağından devralındı.) |
|
SuperTip | Alır veya kullanıcı menünün üzerine fare işaretçisini getirdiğinde görüntülenen çok satırlı İpucu metni ayarlar. |
|
Tag | Alır veya ayarlar bu ile ilişkili olan uygulamaya özgü veri RibbonComponent. (RibbonComponent kaynağından devralındı.) |
|
Title | Alır veya kullanıcı Microsoft Office menüsüne eklenen bir menü genişlediğinde, görüntülenen başlığını ayarlar. |
|
Visible | Gösteren bir değeri alır veya ayarlar olup olmadığını bu RibbonControl görülebilir. (RibbonControl kaynağından devralındı.) |
Üst
Yöntemler
| Ad | Açıklama | |
|---|---|---|
.gif "Genel yöntem") |
Dispose | Boşaltma, serbest bırakma veya yönetilmeyen kaynakları sıfırlama ile ilişkilendirilmiş uygulama tanımlı görevleri gerçekleştirir. (IDisposable kaynağından devralındı.) |
|
PerformDynamicLayout | Aramalar Microsoft.Office.Core.IRibbonUI.InvalidateControl ana yöntem varsa kontrol RibbonComponent dinamik bir menü gibi dinamik bir ana vardır ve düzeni askıya değil. (RibbonComponent kaynağından devralındı.) |
|
PerformLayout | Aramalar Microsoft.Office.Core.IRibbonUI.InvalidateControl , RibbonComponent bir ana vardır ve düzeni askıya değil. (RibbonComponent kaynağından devralındı.) |
|
ResumeLayout() | Etkisini tersine çevirir SuspendLayout yöntemi. (RibbonComponent kaynağından devralındı.) |
|
ResumeLayout(Boolean) | Etkisini tersine çevirir SuspendLayout yöntemi. (RibbonComponent kaynağından devralındı.) |
|
SuspendLayout | Şerit üzerindeki denetimlerin durumu yenileme Microsoft Office uygulamasının engeller. (RibbonComponent kaynağından devralındı.) |
Üst
Olaylar
| Ad | Açıklama | |
|---|---|---|
.gif "Genel olay") |
Disposed | İşleme yöntemini gösteren Disposed olayı için bir bileşen. (IComponent kaynağından devralındı.) |
|
ItemsLoading | Denetimleri veya iç içe menüler geçerli menüye zamanında yüklendiğinde oluşur. |
Üst
Açıklamalar
Visual Studio oluşturur bir RibbonMenu sürüklediğinizde, nesne bir menü dan kontrol Office Kurdele denetimleri sekmesinde araç şerit Tasarımcısı üzerine.
Oluşturabileceğiniz bir RibbonMenu kullanarak çalışma zamanında CreateRibbonMenu yöntemi, RibbonFactory nesne.
RibbonFactory nesnesine erişmek için iki yol vardır:
Ribbon (Şerit) sınıfının Factory özelliği kullanılarak. Ribbon sınıfınızdaki kodda bu yaklaşımı kullanın.
Globals.Factory.GetRibbonFactory yöntemi kullanılarak. Ribbon sınıfınızın dışındaki kodda bu yaklaşımı kullanın.
Ortak Görevler
Aşağıdaki tabloda, ortak görevler için yararlı olan üyeleri listeler. Bu görevlerin tümü, tasarım zamanında gerçekleştirilebilir. Bu görevlerden bazılarını şerit Office uygulama veya Denetim çalışma zamanında dinamik menüye eklenmeden önce yalnızca yüklenmeden önce çalışma zamanında gerçekleştirilebilir. Daha fazla bilgi için bkz. Şerit Nesne Modeline Genel Bakış.
Görev |
Üye |
|---|---|
Görüntü menüsünde görüntüleme. |
Use Image veya ImageName özelliği. Ayrıca, yerleşik şerit denetimlerde görüntülenen görüntüleri yeniden kullanabilirsiniz. Bunu yapmak için OfficeImageId bir görüntünün yerleşik Microsoft Office menü. simge olarak görüntülemek istediğiniz kimliği |
Menünün boyutunu değiştirin. |
Set ControlSize özellik değeri için istediğiniz. Örneğin, büyük bir menü için ayarlayın Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge. |
Menüdeki öğelerin boyutunu değiştirin. |
Set ItemSize özellik değeri için istediğiniz. Örneğin, daha büyük öğeleri görüntülemek için onu ayarlamak Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge. |
Menüde yapılan değişiklikleri zamanında (örneğin, çalışma zamanında menüsüne eklenecek denetimlerini etkinleştirmek için) etkinleştirin. |
Dynamic özelliğini true'e ayarlayın. |
Menü denetimleri erişmek, denetimlerini menüsüne eklemek veya Denetim menüsü'nden kaldır. |
Items özelliğini kullanın. |
Microsoft Office menü, bir grup veya menüleri içeren başka bir denetime bir menü ekleme. |
Ekleme bir RibbonMenu için Items özelliği Microsoft Office menüsünde, Grup veya denetim. |
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 belgelerde, .NET Framework 4'ü hedefleyen projelerde kullanılan bu türün sürümü açıklanı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ür hakkındaki belgeler için, Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: https://go.microsoft.com/fwlink/?LinkId=160658.
Örnekler
Aşağıdaki örnek, eklemek ve varolan bir menü bir menünün zamanında doldurmak gösterilmiştir.
Denetimleri çalışma zamanında güncelleştirir ve Language-Integrated sorgu (LINQ) kullanarak AdventureWorks örnek veritabanından veri alma ile ilgilidir daha zengin bir örneğin bakın İzlenecek Yol: Şerit Denetimlerini Çalışma Zamanında Güncelleme.
Bu kod örneği çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:
Ekleme bir şerit (Visual Designer) Office project madde.
Bir grup için özel sekme ekleyin.
Bir menü grubuna ekleyin.
Set (Name) özellik menü CustomerMenu.
Set Etiket özellik menü müşterilere.
Set dinamik özellik menü true.
Bu, Şerit Office uygulamasına yüklendikten sonra çalışma zamanında menüye denetim eklemenizi veya menüden denetim çıkarmanızı sağlar.
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
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);
}
Ayrıca bkz.
Başvuru
Microsoft.Office.Tools.Ribbon Ad Alanı