DocumentBase.CreateRibbonExtensibilityObject Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan objek yang mengimplementasikan antarmuka Microsoft.Office.Core.IRibbonExtensibility.
protected:
virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();
protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();
abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility
Mengembalikan
Objek yang mengimplementasikan antarmuka Microsoft.Office.Core.IRibbonExtensibility.
Contoh
Contoh kode berikut mengambil alih CreateRibbonExtensibilityObject
metode di ThisAddin
kelas atau ThisDocument
proyek dan mengembalikan Pita yang ingin Anda tampilkan. Contoh ini mengharuskan Anda menambahkan dua Pita ke proyek Anda yang dipanggil Ribbon1
dan Ribbon2
dengan menggunakan item Pita (Visual Designer). Contoh memeriksa nilai bidang bernama myCondition
dan mengembalikan Pita yang sesuai. Untuk menggunakan contoh ini, jalankan dari ThisDocument
kelas dalam proyek tingkat dokumen.
protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
{
if (myCondition == true)
{
return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
}
else
{
return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
}
}
Protected Overrides Function CreateRibbonExtensibilityObject() As _
Microsoft.Office.Core.IRibbonExtensibility
If myCondition = True Then
Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
(New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
{New Ribbon1()})
Else
Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
(New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
{New Ribbon2()})
End If
End Function
Keterangan
Ambil alih metode ini untuk mengembalikan implementasi Microsoft.Office.Core.IRibbonExtensibility
antarmuka. Jika Anda memiliki beberapa Pita dalam proyek, Anda bisa menentukan Pita mana yang akan ditampilkan pada durasi.
Anda tidak perlu mengambil alih metode ini untuk mengembalikan Pita yang Anda tambahkan ke proyek dengan menggunakan templat item Pita (Visual Designer). Secara default, metode ini mengembalikan RibbonManager objek yang mewakili semua item Pita (Visual Designer) dalam proyek. Untuk informasi selengkapnya, lihat Gambaran Umum Pita.
Anda harus mengambil CreateRibbonExtensibilityObject alih metode atau RequestService untuk mengembalikan Pita dalam proyek yang Anda tambahkan dengan menggunakan templat item Pita (XML). Untuk informasi selengkapnya tentang cara mengambil alih CreateRibbonExtensibilityObject metode, lihat XML Pita.