Aracılığıyla paylaş


RibbonGallery Arabirim

Tanım

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
Uygulamalar

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.

Şunlara uygulanır