ComboBoxContentControl Arabirim

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Word

Bütünleştirilmiş Kod:: Microsoft.Office.Tools.Word.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belgedeki birleşik giriş kutusunu temsil eder.

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

Öznitelikler: GuidAttribute

Uygulamalar: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Örnekler

Aşağıdaki kod örneği, belgenin başına yeni ComboBoxContentControl bir ekler. Kullanıcılar denetim tarafından görüntülenen bir renk adını seçebilir veya yeni bir rengin adını yazabilir.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisDocument yapıştırın ve yönteminden yöntemini çağırın AddComboBoxControlAtSelectionThisDocument_Startup .

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

Bu sürüm, uygulama düzeyinde eklenti içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisAddIn yapıştırın ve yönteminden yöntemini çağırın AddComboBoxControlAtSelectionThisAddIn_Startup .

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

Açıklamalar

, ComboBoxContentControl kullanıcıların seçebileceği öğelerin listesini görüntüler. Kullanıcılar bir öğesine ComboBoxContentControlkendi metinlerini de yazabilir.

Kullanıcıların düzenleyemeyeceği bir metin kutusunda öğelerin açılan listesini görüntülemek için kullanın DropDownListContentControl.

içindeki ComboBoxContentControlöğeler listesine erişmek için özelliğini kullanın DropDownListEntries .

Not

Bu arabirim, Office için Visual Studio Araçları çalışma zamanı modülü tarafından uygulanır. Kodunuzda gerçekleştirilmesi amaçlanmamıştır. Daha fazla bilgi için bkz. Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

İçerik Denetimleri

ComboBoxContentControl, Microsoft Office Word belgeleri ve şablonları tasarlamak için kullanabileceğiniz sekiz içerik denetimi türünden biridir. İçerik denetimleri, girdileri form gibi denetleyen bir kullanıcı arabirimine (UI) sahiptir. İçerik denetimlerini, kullanıcıların belgenin veya şablonun korunan bölümlerini düzenlemesini önlemek için kullanabilirsiniz. Ayrıca içerik denetimlerini bir veri kaynağına da bağlayabilirsiniz. Daha fazla bilgi için bkz. İçerik Denetimleri.

Kullanım

Bu belgede bu türün .NET Framework 4 veya sonraki sürümlerini hedefleyen Office projelerinde kullanılan sürümü açıklanmaktadır. .NET Framework 3.5'i hedefleyen projelerde, bu türün üyeleri farklı olabilir ve bu tür için sağlanan kod örnekleri çalışmayabilir. .NET Framework 3.5'i hedefleyen projelerde bu türle ilgili belgeler için Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: http://go.microsoft.com/fwlink/?LinkId=160658.

Özellikler

Application	Microsoft Office Word'nin geçerli örneğini temsil eden bir Application alır.
Container	Belgedeki birleşik giriş kutusunu temsil eder. (Devralındığı yer: ContentControlBase)
ContainerComponent	Belgedeki birleşik giriş kutusunu temsil eder. (Devralındığı yer: ContentControlBase)
Creator	oluşturulduğu uygulamayı ComboBoxContentControl gösteren 32 bitlik bir tamsayı alır.
DefaultDataSourceUpdateMode	için ContentControlBasevarsayılanı DataSourceUpdateMode alır veya ayarlar. (Devralındığı yer: ContentControlBase)
DefaultTextStyle	içindeki metni biçimlendirmek için kullanılan karakter stilinin ComboBoxContentControladını alır.
DropDownListEntries	tarafından ComboBoxContentControlgörüntülenen öğe koleksiyonunu alır.
ID	İçerik denetimini tanımlayan benzersiz bir sayı alır. (Devralındığı yer: ContentControlBase)
InnerObject	için ContentControlBasetemel alınan ContentControl nesneyi alır. (Devralındığı yer: ContentControlBase)
LockContentControl	öğesinin belgeden silinip ComboBoxContentControl silinemeyeceğini belirten bir değer alır veya ayarlar.
LockContents	öğesinin içeriğinin düzenlenip düzenlenemeyeceğini ComboBoxContentControl belirten bir değer alır veya ayarlar.
MultiLine	öğesinin satır sonları içerip içeremeyeceğini ComboBoxContentControl belirten bir değer alır veya ayarlar.
Parent	öğesinin üst öğesini ComboBoxContentControlalır.
ParentContentControl	Başka bir içerik denetiminde iç içe yerleştirilmiş bir ComboBoxContentControl öğesinin üst içerik denetimini alır.
PlaceholderText	Metin bir kullanıcı eylemi veya başka bir işlem tarafından değiştirilene ComboBoxContentControl kadar içinde görüntülenen metni alır veya ayarlar.
Range	öğesinin içeriğini ComboBoxContentControltemsil eden bir Range alır.
ShowingPlaceholderText	öğesinin şu anda yer tutucu metni görüntüleyip görüntülemediğini ComboBoxContentControl gösteren bir değer alır.
Tag	ile ComboBoxContentControlilişkilendirmek istediğiniz dizeyi alır veya ayarlar.
Temporary	Denetim düzenlendiğinde öğesinin belgeden otomatik olarak silinip silinmeyeceğini ComboBoxContentControl belirten bir değer alır veya ayarlar.
Text	içindeki ComboBoxContentControlmetni alır veya ayarlar.
Title	başlığını ComboBoxContentControlalır veya ayarlar.
XMLMapping	özel XML XMLMapping bölümündeki ve öğesi arasındaki bağlamayı ComboBoxContentControl temsil eden bir alır.

Yöntemler

Copy()	ComboBoxContentControl öğesini belgeden Pano'ya kopyalar.
Cut()	ComboBoxContentControl belgeden öğesini kaldırır ve Pano'ya ekler.
Delete(Boolean)	Dinamik olarak oluşturulan içerik denetimini belgeden siler ve belgedekinden ControlCollection kaldırır. (Devralındığı yer: ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	T:Microsoft.Office.Interop içindeki metni görüntüler. Word. BuildingBlock, içinde yer tutucu metin ComboBoxContentContrololarak bir Rangeveya bir dize.

Ekinlikler

Added	İçerik denetimi belgeye eklendikten sonra gerçekleşir. (Devralındığı yer: ContentControlBase)
BindingContextChanged	Özelliğinin BindingContext değeri değiştiğinde ContentControlBase gerçekleşir. (Devralındığı yer: ContentControlBase)
ContentUpdating	İçerik denetimi özel bir XML bölümüne bağlıysa, Microsoft Office Word içerik denetimindeki metni güncelleştirmeden hemen önce gerçekleşir. (Devralındığı yer: ContentControlBase)
Deleting	İçerik denetimi belgeden silinmeden hemen önce gerçekleşir. (Devralındığı yer: ContentControlBase)
Entering	Kullanıcı içerik denetimine tıkladığında veya imleç program aracılığıyla içerik denetimine taşındığında gerçekleşir. (Devralındığı yer: ContentControlBase)
Exiting	Kullanıcı içerik denetiminin dışına tıkladığında veya imleç program aracılığıyla içerik denetiminin dışına taşındığında gerçekleşir. (Devralındığı yer: ContentControlBase)
StoreUpdating	Microsoft Office Word içerik denetimine bağlı özel bir XML bölümündeki verileri güncelleştirmeden hemen önce gerçekleşir (yani, içerik denetimindeki metin değiştikten sonra). (Devralındığı yer: ContentControlBase)
Validated	İçerik denetimi başarıyla doğrulandığında gerçekleşir. (Devralındığı yer: ContentControlBase)
Validating	İçerik denetiminin içeriği doğrulandığında gerçekleşir. (Devralındığı yer: ContentControlBase)

Şunlara uygulanır