RibbonButton Arabirim

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Ribbon

Bütünleştirilmiş Kod:: Microsoft.Office.Tools.Common.dll

Ö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.

Özel şeritteki bir düğmeyi temsil eder.

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

[System.Runtime.InteropServices.Guid("b57e6217-33f2-46bf-9625-c313526de60c")]
public interface RibbonButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("b57e6217-33f2-46bf-9625-c313526de60c")>]
type RibbonButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonButton
Implements IComponent, IDisposable, RibbonControl

Öznitelikler: GuidAttribute

Uygulamalar: RibbonComponent RibbonControl IComponent IDisposable

Örnekler

Aşağıdaki örnek yeni bir düğme oluşturur, düğmenin çeşitli özelliklerini ayarlar ve ardından düğmeyi bir menüye ekler. Bu kod örneğini çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:

Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan bir projeye Şerit (Visual Tasarım Aracı) öğesi ekleyin.
Özel sekmeye bir grup ekleyin.
Gruba bir menü ekleyin.
Menünün Dynamic özelliğini olarak trueayarlayın.
Menünün ItemSize özelliğini RibbonControlSizeLarge olarak ayarlayın.

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);

}

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

Açıklamalar

Visual Studio, Araç Kutusu'nunOffice Şerit Denetimleri sekmesinden RibbonButtonŞerit Tasarım Aracı düğme denetimini sürüklediğinizde arabirimi uygulayan bir sınıfın örneğini oluşturur.

Ayrıca çalışma zamanında bu denetimin bir örneğini oluşturabilir ve dinamik bir menüye ekleyebilirsiniz. Bir menü, özelliğini olarak ayarlarsanız Dynamic dinamiktir true.

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ış.

nesnesinin CreateRibbonButton yöntemini RibbonFactory kullanarak çalışma zamanında oluşturabilirsinizRibbonButton.

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.

Ortak Görevler

Aşağıdaki tabloda, ortak görevler için yararlı olan üyeler listelenir.

Görev	Üye
Çalışma zamanında, özelliği true olarak ayarlanmış bir menüye Dynamic düğme ekleyin.	kullanarak arabirimini uygulayan bir sınıfın RibbonButton örneğini oluşturma CreateRibbonButton yöntemini kullanır RibbonFactory . Daha fazla bilgi için bkz. Office Projelerindeki Nesnelere Genel Erişim. Örneği menünün `Items` koleksiyonuna ekleyin.
Düğmenin boyutunu değiştirin.	İstediğiniz değere ayarlayın ControlSize . Örneğin, büyük bir düğme için olarak `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`ayarlayın.
Düğme üzerinde bir görüntü görüntüleyin.	Bir görüntüyü görüntülemenin üç yolu vardır: - özelliğini kullanın Image . Bu özellik en fazla denetimi sağlar. - Düğmenin simgesi olarak görüntülemek istediğiniz yerleşik bir Microsoft Office görüntüsünün kimliğine ayarlayın OfficeImageId . - Olayla LoadImage birlikte özelliğini kullanınImageName. Bu özellik bazı performans avantajları sağlar.
Düğmeleri devre dışı bırakın veya gizleyin.	Düğmeyi devre dışı bırakmak için olarak `false`ayarlayınEnabled. Düğmeyi gizlemek için olarak `false`ayarlayınVisible.
Kullanıcı düğmeye tıkladığında kodu çalıştırın.	Olay işleyicisine Click kod ekleyin.

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

ControlSize	Düğmenin boyutunu alır veya ayarlar.
Description	Menünün özelliği Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge olarak ayarlandığında menüde bu düğmede ItemSize 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şleyicisindeki düğmeyi LoadImage tanımlamak için kullanabileceğiniz adı alır veya ayarlar.
KeyTip	Düğmenin klavye kısayolunu alır veya ayarlar.
Label	Düğmede 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, düğmede görüntülenecek resmi alır veya ayarlar.
Parent	Bu RibbonComponentöğesinin üst öğesini temsil eden bir RibbonComponent alır. (Devralındığı yer: RibbonComponent)
Position	Düğme Microsoft Office Menüsündeyse düğmenin 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)
ScreenTip	Kullanıcı işaretçiyi düğmenin üzerine getirince görüntülenen araç ipucu metnini alır veya ayarlar.
ShowImage	Düğmeyle ilişkili görüntünün görünür olup olmadığını gösteren bir değer alır veya ayarlar.
ShowLabel	Düğme etiketinin görünür olup olmadığını gösteren bir değer alır veya ayarlar.
SuperTip	Kullanıcı işaretçiyi düğmenin üzerine getirince 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

Click

Kullanıcı düğmeye tıkladığında gerçekleşir.

Şunlara uygulanır

Aracılığıyla paylaş