RibbonGallery Arabirim

Tanım

Ad Alanı:

Microsoft.Office.Tools.Ribbon

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Common.dll

Nesne ve RibbonButton denetim menüsünü RibbonDropDownItem görüntüleyen bir denetimi temsil eder.

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

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Öznitelikler

GuidAttribute

Uygulamalar

RibbonComponent RibbonControl IComponent IDisposable

Açıklamalar

Arabirimde olduğu RibbonDropDown gibi, RibbonGallery nesnelerin ve RibbonButton denetimlerin RibbonDropDownItem bir menüsünü görüntüler.

Arabiriminden RibbonDropDown farklı olarak, RibbonGallery kullanıcı bir öğesine tıkladığında RibbonDropDownItemarabirim olaylar yerine SelectionChanged olaylar oluştururClick. Bu, örneğin, Click bir kullanıcı aynı RibbonDropDownItem iki kez tıkladığında olayın iki kez tetiklendiğini gösterir. (olay, SelectionChanged ilk tıklamadan önce seçimin ne olduğu bağlı olarak bir üzerinde aynı senaryo için ilk seçim yapıldığında en çok bir RibbonDropDownkez tetiklenebilir.)

özelliği, ShowItemSelection seçili RibbonDropDownItem durumdaki öğenin seçilmemiş öğelerden görsel olarak ayırt edilip edilmeyeceğini denetler. bir içinde bir kerede yalnızca bir RibbonGalleryöğe seçilebilir.

ItemImageSize özelliği, 16x16 ve 32x32 dışındaki görüntü boyutlarını belirtmek için kullanılabilir.

Tasarım zamanında RibbonDropDownItem nesneleri eklemek için

1. Özellikler penceresinde Items özelliğine tıklayın.

2. Üç noktaya (...) tıklayın.

3. DropDown Koleksiyonu Düzenleyici yeni öğeleri ekleyin, sıralayıp düzenleyin.

Öğesine tasarım zamanında denetimler RibbonGallery ekleyebilirsinizRibbonButton.

Tasarım zamanında RibbonButton denetimleri eklemek için

1. Özellikler penceresinde Düğmeler özelliğine tıklayın.

2. Üç noktaya (...) tıklayın.

3. Düğme Koleksiyonu Düzenleyici yeni düğme denetimlerini ekleyin, sıralayıp düzenleyin.

nesnesinin CreateRibbonGallery yöntemini RibbonFactory kullanarak çalışma zamanında oluşturabilirsinizRibbonGallery.

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.

Bu denetimin bazı özellikleri yalnızca Şerit Office uygulamasına yüklenmeden önce veya denetim çalışma zamanında dinamik bir menüye eklenmeden önce ayarlanabilir. Bu özellikleri ayarlama hakkında bilgi için bkz . Şerit Nesne Modeline Genel Bakış.

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

Buttons	Bu RibbonGalleryüzerindeki düğme koleksiyonunu alır.
ColumnCount	Bu RibbonGalleryiçindeki Öğe sütunlarının sayısını alır veya ayarlar.
ControlSize	Denetimin boyutunu RibbonGallery alır veya ayarlar.
Description	Bir menüde veya bölünmüş düğmede bu RibbonGallery denetimde görünen metni 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	Düğmede görüntülenen görüntüyü alır veya ayarlar.
ImageName	Olay işleyicisinde LoadImage öğesini tanımlamak RibbonGallery için kullanabileceğiniz adı alır veya ayarlar.
ItemImageSize	Bu RibbonGalleryiçindeki öğeler tarafından görüntülenen görüntülerin boyutlarını veren bir Size alır veya ayarlar.
Items	Bu RibbonGalleryiçindeki bileşenlerin koleksiyonunu RibbonDropDownItem alır.
KeyTip	Bu RibbonGalleryiçin klavye kısayolunu alır veya ayarlar.
Label	Bu RibbonGalleryüzerinde 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ü denetimde 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	Galeri Microsoft Office Menüsündeyse galerinin 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)
RowCount	Bu RibbonGallery görüntülenen bileşen satırlarını RibbonDropDownItem alır veya ayarlar.
ScreenTip	Kullanıcı işaretçiyi bu RibbonGalleryüzerine getirince görüntülenen ipucu metnini alır veya ayarlar.
SelectedItem	Seçili durumdaki öğeyi alır veya ayarlar.
SelectedItemIndex	Seçili RibbonDropDownItemdurumdaki öğesinin dizinini alır veya ayarlar.
ShowImage	ile RibbonGallery ilişkili görüntünün görünür olup olmadığını gösteren bir değer alır veya ayarlar.
ShowItemImage	Galerideki öğeler için görüntülerin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
ShowItemLabel	Bu RibbonGalleryüzerindeki öğeler için etiketlerin gösterilip gösterilmediğini belirten bir değer alır veya ayarlar.
ShowItemSelection	Seçili RibbonDropDownItem durumdaki öğenin seçilmemiş öğelerin geri kalanından görsel olarak ayırt edilip edilmediğini belirten bir değer alır veya ayarlar.
ShowLabel	Bunun RibbonGallery etiketinin görünür olup olmadığını gösteren bir değer alır veya ayarlar.
SuperTip	Kullanıcı işaretçiyi üzerinde RibbonGalleryhareket ettiğinde 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)
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

ButtonClick	Kullanıcı bu RibbonGalleryüzerindeki bir düğmeye tıkladığında gerçekleşir.
Click	Kullanıcı bu RibbonGalleryüzerindeki bir öğeye tıkladığında gerçekleşir.
ItemsLoading	Bu RibbonGallery , açıldığında gerçekleşir.