ComboBoxContentControl Antarmuka

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Word

Rakitan:: Microsoft.Office.Tools.Word.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 kotak kombo pada dokumen.

public interface class ComboBoxContentControl : IDisposable, Microsoft::Office::Tools::Word::ContentControlBase, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent

[System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent

[<System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")>]
type ComboBoxContentControl = interface
    interface ContentControlBase
    interface IBindableComponent
    interface IComponent
    interface IDisposable
    interface ISupportInitialize

Public Interface ComboBoxContentControl
Implements ContentControlBase, IBindableComponent, IComponent, IDisposable, ISupportInitialize

Atribut: GuidAttribute

Penerapan: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Contoh

Contoh kode berikut menambahkan baru ComboBoxContentControl ke awal dokumen. Pengguna dapat memilih nama warna yang ditampilkan oleh kontrol, atau mereka dapat mengetikkan nama warna baru.

Versi ini untuk kustomisasi tingkat dokumen. Untuk menggunakan kode ini, tempelkan ke ThisDocument kelas di proyek Anda, dan panggil AddComboBoxControlAtSelection metode dari ThisDocument_Startup metode .

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

Versi ini untuk add-in tingkat aplikasi. Untuk menggunakan kode ini, tempelkan ke ThisAddIn kelas di proyek Anda, dan panggil AddComboBoxControlAtSelection metode dari ThisAddIn_Startup metode .

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
        "comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";            
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

Keterangan

Menampilkan ComboBoxContentControl daftar item yang bisa dipilih pengguna. Pengguna juga dapat mengetik teks mereka sendiri di ComboBoxContentControl.

Untuk menampilkan daftar drop-down item dalam kotak teks yang tidak dapat diedit pengguna, gunakan DropDownListContentControl.

Untuk mengakses daftar item dalam ComboBoxContentControl, gunakan DropDownListEntries properti .

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.

Kontrol Konten

ComboBoxContentControl adalah salah satu dari delapan tipe kontrol konten yang bisa Anda gunakan untuk mendesain dokumen dan templat di Microsoft Office Word. Kontrol konten memiliki antarmuka pengguna (UI) yang telah mengontrol input seperti formulir. Anda bisa menggunakan kontrol konten untuk mencegah pengguna mengedit bagian dokumen atau templat yang dilindungi, dan Anda juga bisa mengikat kontrol konten ke sumber data. Untuk informasi selengkapnya, lihat Kontrol Konten.

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

Application	Application Mendapatkan yang mewakili instans Microsoft Office Word saat ini.
Container	Mewakili kotak kombo pada dokumen. (Diperoleh dari ContentControlBase)
ContainerComponent	Mewakili kotak kombo pada dokumen. (Diperoleh dari ContentControlBase)
Creator	Mendapatkan bilangan bulat 32-bit yang menunjukkan aplikasi tempat ComboBoxContentControl dibuatnya.
DefaultDataSourceUpdateMode	Mendapatkan atau mengatur default DataSourceUpdateMode untuk ContentControlBase. (Diperoleh dari ContentControlBase)
DefaultTextStyle	Mendapatkan nama gaya karakter yang digunakan untuk memformat teks di ComboBoxContentControl.
DropDownListEntries	Mendapatkan koleksi item yang ditampilkan oleh ComboBoxContentControl.
ID	Mendapatkan nomor unik yang mengidentifikasi kontrol konten. (Diperoleh dari ContentControlBase)
InnerObject	Mendapatkan objek yang mendasar ContentControl untuk ContentControlBase. (Diperoleh dari ContentControlBase)
LockContentControl	Mendapatkan atau menetapkan nilai yang menentukan apakah ComboBoxContentControl dapat dihapus dari dokumen.
LockContents	Mendapatkan atau menetapkan nilai yang menentukan apakah konten ComboBoxContentControl dapat diedit.
MultiLine	Mendapatkan atau menetapkan nilai yang menentukan apakah ComboBoxContentControl bisa berisi hentian baris.
Parent	Mendapatkan induk dari ComboBoxContentControl.
ParentContentControl	Mendapatkan kontrol konten induk dari yang ComboBoxContentControl ditumpuk di kontrol konten lain.
PlaceholderText	Mendapatkan atau mengatur teks yang ditampilkan di ComboBoxContentControl hingga teks diubah oleh tindakan pengguna atau beberapa operasi lainnya.
Range	Range Mendapatkan yang mewakili konten ComboBoxContentControl.
ShowingPlaceholderText	Mendapatkan nilai yang menunjukkan apakah ComboBoxContentControl saat ini menampilkan teks tempat penampung.
Tag	Mendapatkan atau mengatur string yang ingin Anda kaitkan dengan ComboBoxContentControl.
Temporary	Mendapatkan atau mengatur nilai yang menentukan apakah ComboBoxContentControl dihapus secara otomatis dari dokumen saat kontrol diedit.
Text	Mendapatkan atau mengatur teks di ComboBoxContentControl.
Title	Mendapatkan atau mengatur judul ComboBoxContentControl.
XMLMapping	XMLMapping Mendapatkan yang mewakili pengikatan antara ComboBoxContentControl elemen dan di bagian XML kustom.

Metode

Copy()	ComboBoxContentControl Menyalin dari dokumen ke Clipboard.
Cut()	ComboBoxContentControl Menghapus dari dokumen dan menambahkannya ke Clipboard.
Delete(Boolean)	Menghapus kontrol konten yang dibuat secara dinamis dari dokumen dan menghapusnya dari ControlCollection dalam dokumen. (Diperoleh dari ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Menampilkan teks yang ada di T:Microsoft.Office.Interop. Word. BuildingBlock, Range, atau string sebagai teks tempat penampung di ComboBoxContentControl.

Acara

Added	Terjadi setelah kontrol konten ditambahkan ke dokumen. (Diperoleh dari ContentControlBase)
BindingContextChanged	Terjadi ketika nilai BindingContext properti dari ContentControlBase perubahan. (Diperoleh dari ContentControlBase)
ContentUpdating	Terjadi tepat sebelum Microsoft Office Word memperbarui teks dalam kontrol konten, jika kontrol konten terikat ke bagian XML kustom. (Diperoleh dari ContentControlBase)
Deleting	Terjadi tepat sebelum kontrol konten dihapus dari dokumen. (Diperoleh dari ContentControlBase)
Entering	Terjadi ketika pengguna mengklik kontrol konten, atau ketika kursor dipindahkan ke kontrol konten secara terprogram. (Diperoleh dari ContentControlBase)
Exiting	Terjadi ketika pengguna mengklik di luar kontrol konten, atau ketika kursor dipindahkan ke luar kontrol konten secara terprogram. (Diperoleh dari ContentControlBase)
StoreUpdating	Terjadi tepat sebelum Microsoft Office Word memperbarui data di bagian XML kustom yang terikat ke kontrol konten (yaitu, setelah teks dalam kontrol konten berubah). (Diperoleh dari ContentControlBase)
Validated	Terjadi ketika kontrol konten telah berhasil divalidasi. (Diperoleh dari ContentControlBase)
Validating	Terjadi ketika konten kontrol konten sedang divalidasi. (Diperoleh dari ContentControlBase)

Berlaku untuk

Bagikan melalui