RibbonDropDown 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 daftar item yang bisa dipilih pengguna dan daftar tombol Pita yang bisa diklik pengguna.

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

[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

Atribut: GuidAttribute

Penerapan: RibbonComponent RibbonControl IComponent IDisposable

Keterangan

dapat RibbonDropDown berisi RibbonDropDownItem objek dan RibbonButton kontrol.

Anda dapat membuat RibbonDropDown pada durasi dengan menggunakan CreateRibbonDropDown 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.

Anda tidak dapat menambahkan tombol ke koleksi pada Buttons durasi setelah Pita dimuat ke Office.

Prosedur di bawah ini menjelaskan cara menambahkan RibbonDropDownItem objek dan RibbonButton kontrol ke RibbonDropDown.

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 RibbonDropDown 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.

Beberapa anggota tipe ini dapat diatur hanya sebelum Pita dimuat ke dalam aplikasi Office. 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 kumpulan RibbonButton objek milik ini RibbonDropDown.
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 ini RibbonDropDown.
ImageName	Mendapatkan atau mengatur nama yang dapat Anda gunakan di penanganan LoadImage aktivitas untuk mengidentifikasi gambar untuk kontrol.
Items	Mendapatkan koleksi item dalam ini RibbonDropDown.
KeyTip	Mendapatkan atau mengatur pintasan keyboard untuk ini RibbonDropDown.
Label	Mendapatkan atau mengatur teks yang muncul di ini RibbonDropDown.
Name	Mendapatkan atau mengatur nama ini RibbonComponent. (Diperoleh dari RibbonComponent)
OfficeImageId	Mendapatkan atau mengatur gambar untuk ditampilkan di RibbonDropDown, jika Anda ingin menggunakan ikon Microsoft Office bawaan.
Parent	RibbonComponent Mendapatkan yang mewakili induk dari iniRibbonComponent. (Diperoleh dari RibbonComponent)
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 RibbonDropDownatas .
SelectedItem	Mendapatkan atau mengatur RibbonDropDownItem 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 RibbonDropDown terlihat.
ShowItemImage	Mendapatkan atau mengatur nilai yang menunjukkan apakah gambar ditampilkan untuk item di menu drop-down.
ShowItemLabel	Mendapatkan atau mengatur nilai yang menunjukkan apakah label ditampilkan untuk item di menu drop-down.
ShowLabel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah label untuk ini RibbonDropDown terlihat.
SizeString	Mendapatkan atau mengatur string yang menentukan ukuran RibbonDropDown.
SuperTip	Mendapatkan atau mengatur teks tip multibaris yang muncul saat pengguna memindahkan penunjuk ke RibbonDropDownatas .
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 RibbonDropDown.
ItemsLoading	Terjadi ketika kontrol dimuat ke RibbonDropDowndalam .
SelectionChanged	Terjadi saat pengguna memilih item baru pada kontrol drop-down Pita.

Berlaku untuk

Bagikan melalui