RibbonGallery Antarmuka

Definisi

Ruang nama:

Microsoft.Office.Tools.Ribbon

Rakitan:

Microsoft.Office.Tools.Common.dll

Mewakili kontrol yang menampilkan menu RibbonDropDownItem objek dan RibbonButton kontrol.

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

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Atribut

GuidAttribute

Penerapan

RibbonComponent RibbonControl IComponent IDisposable

Keterangan

RibbonDropDown Seperti antarmuka, RibbonGallery menampilkan menu RibbonDropDownItem objek dan RibbonButton kontrol.

RibbonDropDown Tidak seperti Antarmuka, RibbonGallery antarmuka menaikkan Click peristiwa, bukan SelectionChanged peristiwa, ketika pengguna mengklik RibbonDropDownItem. Ini berarti, misalnya, bahwa Click peristiwa dinaikkan dua kali ketika pengguna mengklik yang sama RibbonDropDownItem dua kali. (Peristiwa SelectionChanged akan dinaikkan paling banyak sekali ketika pilihan awal dibuat untuk skenario yang sama pada RibbonDropDown, tergantung pada pilihan sebelum klik pertama.)

Properti ShowItemSelection mengontrol apakah yang saat ini dipilih RibbonDropDownItem dibedakan secara visual dari item yang tidak dipilih. Hanya satu item dalam satu waktu yang dapat dipilih dalam RibbonGallery.

Properti ItemImageSize dapat digunakan untuk menentukan ukuran gambar selain 16x16 dan 32x32.

Untuk menambahkan objek RibbonDropDownItem pada waktu desain

1. Klik properti Item di jendela Properti .

2. Klik elipsis (...).

3. Di Editor Koleksi DropDown, tambahkan, urutkan, dan edit item baru.

Anda dapat menambahkan RibbonButton kontrol ke RibbonGallery pada waktu desain.

Untuk menambahkan kontrol RibbonButton pada waktu desain

1. Klik properti Tombol di jendela Properti .

2. Klik elipsis (...).

3. Di Editor Koleksi Tombol, tambahkan, urutkan, dan edit kontrol tombol baru.

Anda dapat membuat RibbonGallery pada durasi dengan menggunakan CreateRibbonGallery 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 metode .Globals.Factory.GetRibbonFactory Gunakan pendekatan ini dari kode di luar kelas Pita Anda.

Beberapa properti kontrol ini bisa diatur hanya sebelum Pita dimuat ke dalam aplikasi Office atau sebelum kontrol ditambahkan ke menu dinamis pada durasi. Untuk informasi tentang pengaturan properti ini, lihat Gambaran Umum Model Objek Pita.

Catatan

Antarmuka ini diimplementasikan oleh Visual Studio Tools untuk runtime Office. Ini tidak dimaksudkan untuk diimplementasikan dalam kode Anda. Untuk informasi selengkapnya, lihat Visual Studio Tools untuk Gambaran Umum 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 dalam dokumentasi Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Properti

Buttons	Mendapatkan koleksi tombol pada ini RibbonGallery.
ColumnCount	Mendapatkan atau mengatur jumlah kolom Item dalam ini RibbonGallery.
ControlSize	Mendapatkan atau mengatur ukuran RibbonGallery kontrol.
Description	Mendapatkan atau mengatur teks yang muncul pada kontrol ini RibbonGallery pada menu atau tombol pisahkan.
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 tombol .
ImageName	Mendapatkan atau mengatur nama yang dapat Anda gunakan untuk mengidentifikasi RibbonGallery di penanganan LoadImage aktivitas.
ItemImageSize	Mendapatkan atau mengatur Size yang memberikan dimensi gambar yang ditampilkan oleh item dalam ini RibbonGallery.
Items	Mendapatkan koleksi RibbonDropDownItem komponen dalam ini RibbonGallery.
KeyTip	Mendapatkan atau mengatur pintasan keyboard untuk ini RibbonGallery.
Label	Mendapatkan atau mengatur teks yang muncul di ini RibbonGallery.
Name	Mendapatkan atau mengatur nama ini RibbonComponent. (Diperoleh dari RibbonComponent)
OfficeImageId	Mendapatkan atau mengatur gambar yang akan ditampilkan pada kontrol, jika Anda ingin menggunakan ikon Microsoft Office bawaan.
Parent	RibbonComponent Mendapatkan yang mewakili induk dari iniRibbonComponent. (Diperoleh dari RibbonComponent)
Position	Mendapatkan atau mengatur posisi galeri, jika galeri 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)
RowCount	Mendapatkan atau mengatur jumlah baris RibbonDropDownItem komponen yang ditampilkan ini RibbonGallery .
ScreenTip	Mendapatkan atau mengatur teks tip yang muncul saat pengguna memindahkan penunjuk ke atas ini RibbonGallery.
SelectedItem	Mendapatkan atau menyetel item yang saat ini dipilih.
SelectedItemIndex	Mendapatkan atau mengatur indeks dari yang saat ini dipilih RibbonDropDownItem.
ShowImage	Mendapatkan atau menetapkan nilai yang menunjukkan apakah gambar yang terkait dengan RibbonGallery terlihat.
ShowItemImage	Mendapatkan atau menetapkan nilai yang menunjukkan apakah gambar ditampilkan untuk item di galeri.
ShowItemLabel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah label ditampilkan untuk item pada ini RibbonGallery.
ShowItemSelection	Mendapatkan atau mengatur nilai yang menunjukkan apakah yang saat ini dipilih RibbonDropDownItem dibedakan secara visual dari item lain yang tidak dipilih.
ShowLabel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah label untuk ini RibbonGallery terlihat.
SuperTip	Mendapatkan atau mengatur teks tip multibaris yang muncul saat pengguna memindahkan penunjuk ke RibbonGalleryatas .
Tag	Mendapatkan atau mengatur data khusus aplikasi yang terkait dengan ini RibbonComponent. (Diperoleh dari RibbonComponent)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah ini RibbonControl terlihat. (Diperoleh dari RibbonControl)

Metode

PerformDynamicLayout()	Memanggil metode Microsoft.Office.Core.IRibbonUI.InvalidateControl 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

ButtonClick	Terjadi ketika pengguna mengklik tombol pada ini RibbonGallery.
Click	Terjadi ketika pengguna mengklik item pada ini RibbonGallery.
ItemsLoading	Terjadi ketika ini RibbonGallery dibuka.