RibbonMenu Antarmuka

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Ribbon

Rakitan:: Microsoft.Office.Tools.Common.dll

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.

Mewakili menu pada tab Pita atau pada Menu Microsoft Office.

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

[System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")>]
type RibbonMenu = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonMenu
Implements IComponent, IDisposable, RibbonControl

Atribut: GuidAttribute

Penerapan: RibbonComponent RibbonControl IComponent IDisposable

Contoh

Contoh berikut menunjukkan cara menambahkan dan mengisi sub-menu ke menu yang ada pada durasi.

Untuk contoh yang lebih kaya yang memperbarui kontrol pada run-time dan melibatkan mendapatkan data dari database sampel AdventureWorks menggunakan kueri Language-Integrated (LINQ), lihat Panduan: Memperbarui Kontrol pada Pita pada Durasi.

Untuk menjalankan contoh kode ini, Anda harus terlebih dahulu melakukan langkah-langkah berikut:

Tambahkan item Pita (Visual Designer) ke proyek Office.
Tambahkan grup ke tab kustom.
Tambahkan menu ke grup.
Atur properti (Nama) menu ke CustomerMenu.
Atur properti Label menu ke Pelanggan.
Atur properti Dinamis menu ke true.

Ini memungkinkan Anda untuk menambahkan dan menghapus kontrol pada menu pada durasi setelah Pita dimuat ke dalam aplikasi Office.

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = this.Factory.CreateRibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = this.Factory.CreateRibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

Keterangan

Visual Studio membuat RibbonMenu objek saat Anda menyeret kontrol Menu dari tab Kontrol Pita Office pada Kotak Alat ke pita Designer.

Anda dapat membuat RibbonMenu pada durasi dengan menggunakan CreateRibbonMenu metode RibbonFactory objek .

Ada dua cara untuk mengakses RibbonFactory objek:

Dengan menggunakan Factory properti kelas Pita. Gunakan pendekatan ini dari kode di kelas Pita Anda.
Dengan menggunakan Globals.Factory.GetRibbonFactory metode . Gunakan pendekatan ini dari kode di luar kelas Pita Anda.

Tugas umum

Tabel berikut ini mencantumkan anggota yang berguna untuk tugas umum. Semua tugas ini dapat dilakukan pada waktu desain. Beberapa tugas ini dapat dilakukan pada durasi hanya sebelum Pita dimuat ke dalam aplikasi Office atau sebelum kontrol ditambahkan ke menu dinamis pada durasi. Untuk informasi selengkapnya, lihat Gambaran Umum Model Objek Pita.

Tugas	Anggota
Tampilkan gambar pada menu.	Image Gunakan properti atau ImageName . Anda juga bisa menggunakan kembali gambar yang muncul di kontrol Pita bawaan. Untuk melakukannya, atur OfficeImageId ke ID gambar Microsoft Office bawaan yang ingin Anda tampilkan sebagai ikon untuk menu.
Ubah ukuran menu.	Atur ControlSize properti ke nilai yang Anda inginkan. Misalnya, untuk menu besar, atur ke `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Ubah ukuran item di menu.	Atur ItemSize properti ke nilai yang Anda inginkan. Misalnya, untuk menampilkan item yang lebih besar, atur ke `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Aktifkan perubahan pada menu pada durasi (misalnya, untuk mengaktifkan kontrol yang akan ditambahkan ke menu pada durasi).	Atur properti Dynamic ke `true`.
Akses kontrol di menu, tambahkan kontrol ke menu, atau hapus kontrol dari menu.	Gunakan properti Items.
Tambahkan menu ke Menu Microsoft Office, grup, atau ke kontrol lain yang bisa berisi menu.	RibbonMenu Tambahkan ke `Items` properti Menu, grup, atau kontrol Microsoft Office.

Catatan

Antarmuka ini diimplementasikan oleh runtime Visual Studio Tools for Office. Ini tidak dimaksudkan untuk diimplementasikan dalam kode Anda. Untuk informasi selengkapnya, lihat Gambaran Umum Visual Studio Tools for Office Runtime.

Penggunaan

Dokumentasi ini menjelaskan versi tipe ini yang digunakan dalam proyek Office yang menargetkan .NET Framework 4 atau yang lebih baru. Dalam proyek yang menargetkan .NET Framework 3.5, jenis ini mungkin memiliki anggota yang berbeda dan contoh kode yang disediakan untuk jenis ini mungkin tidak berfungsi. Untuk dokumentasi tentang jenis ini dalam proyek yang menargetkan .NET Framework 3.5, lihat bagian referensi berikut di dokumentasi Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Properti

ControlSize	Mendapatkan atau mengatur ukuran menu.
Description	Mendapatkan atau mengatur teks yang muncul pada menu saat ini.
Dynamic	Mendapatkan atau menetapkan nilai yang menunjukkan apakah menu dapat dimodifikasi pada durasi.
Enabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah ini RibbonControl diaktifkan. (Diperoleh dari RibbonControl)
Id	Mendapatkan string yang digunakan Microsoft Office untuk mengidentifikasi objek ini RibbonControl . (Diperoleh dari RibbonControl)
Image	Mendapatkan atau mengatur gambar yang ditampilkan pada menu.
ImageName	Mendapatkan atau mengatur nama yang dapat Anda gunakan di penanganan LoadImage aktivitas untuk mengidentifikasi gambar untuk menu.
Items	Mendapatkan koleksi kontrol yang ada di menu.
ItemSize	Mendapatkan atau mengatur ukuran kontrol pada menu.
KeyTip	Mendapatkan atau mengatur tombol akses keyboard menu.
Label	Mendapatkan atau mengatur teks yang ditampilkan oleh menu.
Name	Mendapatkan atau menetapkan nama ini RibbonComponent. (Diperoleh dari RibbonComponent)
OfficeImageId	Mendapatkan atau mengatur gambar untuk ditampilkan pada menu, jika Anda ingin menggunakan ikon Microsoft Office bawaan.
Parent	RibbonComponent Mendapatkan yang mewakili induk dari iniRibbonComponent. (Diperoleh dari RibbonComponent)
Position	Mendapatkan atau mengatur posisi menu, jika menu berada di Menu Microsoft Office.
Ribbon	Mendapatkan objek tingkat Ribbon atas yang berisi hierarki kontrol. (Diperoleh dari RibbonComponent)
RibbonUI	Mendapatkan instans IRibbonUI yang disediakan oleh aplikasi Microsoft Office ke kode ekstensibilitas Pita. (Diperoleh dari RibbonComponent)
ScreenTip	Mendapatkan atau mengatur teks tip yang muncul saat pengguna memindahkan penunjuk ke menu.
ShowImage	Mendapatkan atau menetapkan nilai yang menunjukkan apakah gambar yang terkait dengan menu terlihat.
ShowLabel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah label untuk menu terlihat.
SuperTip	Mendapatkan atau mengatur teks tip multibaris yang muncul saat pengguna memindahkan penunjuk ke menu.
Tag	Mendapatkan atau mengatur data khusus aplikasi yang terkait dengan ini RibbonComponent. (Diperoleh dari RibbonComponent)
Title	Mendapatkan atau mengatur judul yang ditampilkan saat pengguna memperluas menu yang ditambahkan ke Menu Microsoft Office.
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah ini RibbonControl terlihat. (Diperoleh dari RibbonControl)

Metode

PerformDynamicLayout()	Memanggil metode Microsoft.Office.Core.IRibbonUI.InvalidateControl dari kontrol induk jika RibbonComponent memiliki induk dinamis, seperti menu dinamis, dan tata letak tidak ditangguhkan. (Diperoleh dari RibbonComponent)
PerformLayout()	Memanggil Microsoft.Office.Core.IRibbonUI.InvalidateControl jika RibbonComponent memiliki induk dan tata letak tidak ditangguhkan. (Diperoleh dari RibbonComponent)
ResumeLayout()	Membalikkan efek SuspendLayout() metode . (Diperoleh dari RibbonComponent)
ResumeLayout(Boolean)	Membalikkan efek SuspendLayout() metode . (Diperoleh dari RibbonComponent)
SuspendLayout()	Mencegah aplikasi Microsoft Office menyegarkan status kontrol pada Pita. (Diperoleh dari RibbonComponent)

Acara

ItemsLoading

Terjadi ketika kontrol atau menu berlapis dimuat ke menu saat ini pada durasi.

Berlaku untuk

Bagikan melalui