RibbonGallery Antarmuka
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.
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
- Penerapan
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
Klik properti Item di jendela Properti .
Klik elipsis (...).
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
Klik properti Tombol di jendela Properti .
Klik elipsis (...).
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. |