RibbonDialogLauncher Arabirim

Makale
08/01/2011

Küçük standartlaştırılmış bir simge iletişim kutusunu açmak için kullanılan bir grup üzerinde temsil eder.

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

Sözdizimi

'Bildirim
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

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

Özellikler

	Ad	Açıklama
	Enabled	Gösteren bir değeri alır veya ayarlar olup olmadığını bu RibbonDialogLauncher etkindir.
	Image	Alır veya görünen bir görüntü bu ayarlar RibbonDialogLauncher , hızlı erişim araç çubuğu eklenir
	ImageName	Alır veya ayarlar için resim atamak için kullanılan tanımlayıcı RibbonDialogLauncher , hızlı erişim araç çubuğu eklenir
	KeyTip	Alır veya klavye kısayolu için bu ayarlar RibbonDialogLauncher.
	OfficeImageId	Alır veya ayarlar bu görüntülenecek resmi RibbonDialogLauncher, kullanmak istediğiniz bir yerleşik Microsoft Office simgesi.
	Parent	Alır bir RibbonGroup Bu nesne RibbonDialogLauncher bir üye.
	Ribbon	Alır OfficeRibbon hangi bu RibbonDialogLauncher yerleştirilir.
	ScreenTip	Alır veya ayarlar kullanıcı işaretçiyi getirdiğinde beliren Ekran İpucu RibbonDialogLauncher.
	SuperTip	Alır veya ayarlar kullanıcı işaretçiyi getirdiğinde beliren çok satırlı ipucu metnini RibbonDialogLauncher.
	Visible	Gösteren bir değeri alır veya ayarlar olup olmadığını bu RibbonDialogLauncher görülebilir.

Ü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ı.)
	ResumeLayout	Etkisini tersine çevirir SuspendLayout yöntemi.
	SuspendLayout	Denetimlerde durumunu yenileme Microsoft Office uygulamasının engeller OfficeRibbon.

Üst

Açıklamalar

A RibbonDialogLauncher sağ alt köşesindeki bir grubun varsayılan olarak görüntülenir

Image, ImageName, Ve OfficeImageId Özellikler etkisi görünür olduğunda RibbonDialogLauncher şerit. gruptaki görüntülenir Ancak, ne zaman bir kullanıcının eklediği bir RibbonDialogLauncher hızlı erişim araç çubuğu, bu özellikleri gösterilen görüntünün yönetmenin. Ayrıca, Visible özelliği gizlemek değil RibbonDialogLauncher , hızlı erişim araç çubuğu görüntülenir Kullanıcı ekleyebilir RibbonDialogLauncher için hızlı erişim araç çubuğu Şerit (xml) madde. Daha fazla bilgi için bkz. Şerite Genel Bakış.

RibbonDialogLauncher Yalnızca geçerli bir RibbonGroup. RibbonGroup Nesnesinin bir DialogLauncher üyesi RibbonDialogLauncher türü. Nasıl ekleneceği hakkında bilgi için bir RibbonDialogLauncher için bir RibbonGroupbakın Nasıl Yapılır: Şerit Grubuna İletişim Kutusu Başlatıcısı Ekleme.

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

Şerit Office uygulamasına 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ış.

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 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 nasıl ekleneceğini gösterir bir RibbonDialogLauncher üzerinde tıklattığınızda bir şerit Grup ve kullanıcıların seçmelerini sağlayan özel bir iletişim başlatma ile Gelişmiş ayarları RibbonDialogLauncher 'ın sağ alt köşesindeki simge RibbonGroup.

Bu kod örneği çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:

Ekleme bir şerit (Visual Designer) Office project madde.
Ekleme bir RibbonDialogLauncher varsayılan gruba grup1 ana hatları gibi Nasıl Yapılır: Şerit Grubuna İletişim Kutusu Başlatıcısı Ekleme.
Visual Basic kullanıyorsanız, yeni bir ekleme iletişim proje için madde. C# kullanıyorsanız, yeni bir ekleme Windows formu ekleyerek bir iletişim kutusu açmak ve madde Tamam ve İptal düğmeleri forma ve olay işleyicileri düğmelere ilişkin oluşturarak olaylar'ı tıklatın.
Set (Name) özelliği iletişim advancedSettingsDialog. İletişim denetim eklemek ve daha fazla özellik ayarlayarak özelleştirebilirsiniz.
Ekleme DialogLauncherClick olay işleyicisini kod.
Aşağıdaki yönteme içeriğini koyun DialogLauncherClick olay işleyicisi.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}