RibbonGallery Arabirim
Tanım
Ö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.
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
Özellikler penceresinde Items özelliğine tıklayın.
Üç noktaya (...) tıklayın.
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
Özellikler penceresinde Düğmeler özelliğine tıklayın.
Üç noktaya (...) tıklayın.
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. |