RibbonButton Arabirim

Makale
10/29/2012

Özel bir şerit üzerindeki bir düğmeyi temsil eder.

Ad alanı: Microsoft.Office.Tools.Ribbon
Derleme: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)

Sözdizimi

'Bildirim
<GuidAttribute("b57e6217-33f2-46bf-9625-c313526de60c")> _
Public Interface RibbonButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("b57e6217-33f2-46bf-9625-c313526de60c")]
public interface RibbonButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonButton türü aşağıdaki üyeleri ortaya koyar.

Özellikler

	Ad	Açıklama
	ControlSize	Alır veya düğme boyutunu ayarlar.
	Description	Alır veya bu düğme menüsünde görünen metni ayarlar, ItemSize menünün özelliği ayarlanmış Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
	Enabled	Gösteren değeri alır veya ayarlar olup olmadığını bu RibbonControl etkindir. (RibbonControl kaynağından devralındı.)
	Id	Microsoft Office'in bu tanımlamak için kullandığı bir dize alır RibbonControl nesnesi. (RibbonControl kaynağından devralındı.)
	Image	Alır veya ayarlar düğmesinde görüntülenen resim.
	ImageName	Alır veya ayarlar düğmesini tanımlamak için kullanabilecekleri adı LoadImage olay işleyicisi.
	KeyTip	Alır veya ayarlar düğmesinin klavye kısayolu.
	Label	Alır veya ayarlar düğmesinde görüntülenecek 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ü düğmesini 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 düğmeyse düğmesinin konumunu ayarlar.
	Ribbon	Üst düzey alır Ribbon denetim hiyerarşisi içeren nesne. (RibbonComponent kaynağından devralındı.)
	RibbonUI	Altyapı. Alır IRibbonUI şerit genişletilebilirliği kodu için Microsoft Office uygulaması tarafından sağlanan örnek. (RibbonComponent kaynağından devralındı.)
	ScreenTip	Alır veya ayarlar kullanıcı işaretçiyi düğmenin üzerine getirdiğinde beliren araç ipucu metni.
	ShowImage	Alır veya düğmeyle ilişkilendirilmiş görüntü görünür olup olmadığını gösteren bir değeri ayarlar.
	ShowLabel	Alır veya düğmesi için etiket 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ı işaretçiyi düğmenin üzerine getirdiğinde beliren çok satırlı İpucu metni ayarlar.
	Tag	Alır veya ayarlar bu ile ilişkili uygulamaya özgü verileri RibbonComponent. (RibbonComponent kaynağından devralındı.)
	Visible	Gösteren 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
	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	Çağrı Microsoft.Office.Core.IRibbonUI.InvalidateControl yöntem üst denetim, RibbonComponent dinamik menü gibi dinamik bir ana vardır ve düzeni askıya değil. (RibbonComponent kaynağından devralındı.)
	PerformLayout	Çağrı Microsoft.Office.Core.IRibbonUI.InvalidateControl , RibbonComponent bir üst sahiptir 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	Microsoft Office uygulamasının yenileme denetimleri şeridinde durumunu engeller. (RibbonComponent kaynağından devralındı.)

Üst

Olaylar

	Ad	Açıklama
	Click	Kullanıcı düğmeyi tıklattığında gerçekleşir.
	Disposed	İşleme yöntemini gösteren Disposed bir bileşenin olay. (IComponent kaynağından devralındı.)

Üst

Notlar

Visual Studio uygulayan bir sınıfın örneğini oluşturur RibbonButton sürükleyip bırakırken arabirim bir düğmesini karşı kontrol Office Kurdele denetimleri sekmesinde araç şerit Tasarımcısı üzerine.

Ayrıca, çalışma zamanında bu denetimi örneğini oluşturma ve dinamik menüsüne ekleyebilirsiniz.Bir menü ayarlarsanız dinamiktir, Dynamic özelliğine true.

Şerit Office uygulama veya denetim çalışma zamanında dinamik menüye eklenmeden önce yalnızca yüklenmeden önce bu denetimin bazı özelliklerini ayarlayabilirsiniz.Bu özellikleri ayarlama hakkında daha fazla bilgi için bkz: Şerit Nesne Modeline Genel Bakış.

Oluşturabileceğiniz bir RibbonButton kullanarak çalışma zamanında CreateRibbonButton 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.

Görev	Üye
Çalışma zamanında bir düğme içeren menü ekleme, Dynamic özelliği true olarak ayarlanmış.	Uygulayan bir sınıfın örneğini oluşturmak RibbonButton arabirimini kullanarakCreateRibbonButton yöntemi, RibbonFactory sınıfı.Daha fazla bilgi için bkz. Office Projeleri Nesnelerine Genel Erişim. Menünün için örnek ekleme Items koleksiyonu.
Düğme boyutunu değiştirin.	Set ControlSize için istediğiniz değeri.Örneğin, büyük bir düğme için ayarlayın Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Görüntü düğmesini görüntüler.	Resim görüntülemek için üç yolu vardır: Image özelliğini kullanın.Bu özellik, en fazla kontrolü verir. Set OfficeImageId düğmesi için simge olarak görüntülemek istediğiniz yerleşik bir Microsoft Office görüntünün kimliği. Use ImageName özelliği ile birlikte LoadImage olay.Bu özellik, bazı performans avantajları sunar.
Düğmeleri gizlemek veya devre dışı.	Bir düğme devre dışı bırakmak için set Enabled için false. Bir düğmeyi gizlemek için Visible için false.
Bir kullanıcı düğmeyi tıklattığında kod çalıştırabilir.	Koda ekleyin Click olay işleyicisi.

[!NOT]

Bu arabirim Office için Visual Studio Araçları çalışma zamanı 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 yeni bir düğme oluşturur, düğmenin çeşitli özelliklerini ayarlar ve sonra bir menü düğmesi ekler.Bu kod örneği çalıştırmak için aşağıdaki adımları gerçekleştirmelisiniz:

Ekleme bir şerit (Visual Designer) Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan bir proje için madde.
Bir grup için özel sekme ekleyin.
Bir menü grubuna ekleyin.
Set dinamik menüsüne özelliðinin true.
Set ItemSize menüsüne özelliðinin RibbonControlSizeLarge.

Private Sub AddButtonsToMenu()
    Dim tempButton = Me.Factory.CreateRibbonButton()
    tempButton.Label = "Button 1"
    tempButton.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    tempButton.Description = "My Ribbon Button"
    tempButton.ShowImage = True
    tempButton.ShowImage = True
    tempButton.Image = My.Resources.Image1
    tempButton.Image = My.Resources.Image2
    tempButton.KeyTip = "A1"
    menu1.Items.Add(tempButton)
End Sub

private void AddButtonsToMenu()
{
    RibbonButton tempButton = this.Factory.CreateRibbonButton();
    tempButton.Label = "Button 1";
    tempButton.ControlSize =
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    tempButton.Description = "My Ribbon Button";
    tempButton.ShowImage = true;
    tempButton.ShowImage = true;
    tempButton.Image = Properties.Resources.Image1;
    tempButton.Image = Properties.Resources.Image2;
    tempButton.KeyTip = "A1";
    menu1.Items.Add(tempButton);

}