ComboBoxContentControl Arabirim

Makale
02/17/2014

Açılan kutu bir belgeyi temsil eder.

Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll içinde)

Sözdizimi

'Bildirim
<GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")> _
Public Interface ComboBoxContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

ComboBoxContentControl türü aşağıdaki üyeleri ortaya koyar.

Özellikler

	Ad	Açıklama
	Application	Alır bir Microsoft.Office.Interop.Word.Application , Microsoft Office Word'ün geçerli örneğini temsil eder.
	BindingContext	Alır veya ayarlar için para birimi yöneticileri topluluğu IBindableComponent. (IBindableComponent kaynağından devralındı.)
	Container	Altyapı. (ContentControlBase kaynağından devralındı.)
	ContainerComponent	Altyapı. (ContentControlBase kaynağından devralındı.)
	Creator	Alır, bir uygulamayı gösteren bir 32 bitlik tamsayı ComboBoxContentControl oluşturuldu.
	DataBindings	Bu veri bağlama nesneler topluluğu alır IBindableComponent. (IBindableComponent kaynağından devralındı.)
	DefaultDataSourceUpdateMode	Alır veya ayarlar varsayılan DataSourceUpdateMode için ContentControlBase. (ContentControlBase kaynağından devralındı.)
	DefaultTextStyle	Metni biçimlendirmek için kullanılan karakter stilinin adını alır ComboBoxContentControl.
	DropDownListEntries	Tarafından görüntülenen öğeler koleksiyonu alır ComboBoxContentControl.
	ID	İçerik denetimi tanımlayan benzersiz bir numara alır. (ContentControlBase kaynağından devralındı.)
	InnerObject	Arka plandaki alır Microsoft.Office.Interop.Word.ContentControl için nesne Microsoft.Office.Tools.Word.ContentControlBase. (ContentControlBase kaynağından devralındı.)
	LockContentControl	Belirten bir değeri alır veya ayarlar olup olmadığını ComboBoxContentControl belgeden silinebilir.
	LockContents	Belirten bir değeri alır veya ayarlar olup olmadığını içeriğini ComboBoxContentControl düzenlenebilir.
	MultiLine	Belirten bir değeri alır veya ayarlar olup olmadığını ComboBoxContentControl satır sonları içerebilir.
	Parent	Üst alır ComboBoxContentControl.
	ParentContentControl	En üst içerik denetimini bir ComboBoxContentControl başka bir içerik denetiminde yuvalanmış.
	PlaceholderText	Alır veya ayarlar görüntülenen metni ComboBoxContentControl kadar metin kullanıcı eylemi veya başka bir işlem tarafından değiştirildi.
	Range	Alır bir Range içeriğini temsil eden ComboBoxContentControl.
	ShowingPlaceholderText	Gösteren değer alır mı ComboBoxContentControl şu anda yer tutucu metni görüntüleyen.
	Site	Alır veya ayarlar ISite ile ilgili IComponent. (IComponent kaynağından devralındı.)
	Tag	Alır veya ayarlar ile ilişkilendirmek istediğiniz bir dize ComboBoxContentControl.
	Temporary	Belirten bir değeri alır veya ayarlar olup olmadığını ComboBoxContentControl denetim düzenlendiğinde belgeden otomatik olarak silinir.
	Text	Alır veya ayarlar metin ComboBoxContentControl.
	Title	Alır veya ayarlar unvanını ComboBoxContentControl.
	XMLMapping	Alır bir Microsoft.Office.Interop.Word.XMLMapping arasında bir bağ temsil eden ComboBoxContentControl ve bir özelleşmiş XML bölümündeki bir öğe.

Üst

Yöntemler

	Ad	Açıklama
	BeginInit	Nesne sinyalleri bu başlatma başlatıyor. (ISupportInitialize kaynağından devralındı.)
	Copy	Kopya ComboBoxContentControl Pano belgesinden.
	Cut	Kaldırır ComboBoxContentControl belgeden ve panoya ekler.
	Delete	Dinamik olarak oluşturulmuş içerik denetimi belgeden siler ve buradan kaldırır ControlCollection belge içinde. (ContentControlBase kaynağından devralındı.)
	Dispose	Yönetilmeyen kaynakları boşaltma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir. (IDisposable kaynağından devralındı.)
	EndInit	Nesne sinyalleri bu başlatma tamamlanır. (ISupportInitialize kaynağından devralındı.)
	SetPlaceholderText	Görüntüler, metin bir T:Microsoft.Office.Interop.Word.BuildingBlock, Range, yer tutucu metni olarak bir dize veya ComboBoxContentControl.

Üst

Olaylar

	Ad	Açıklama
	Added	İçerik denetimini belgeye eklendikten sonra gerçekleşir. (ContentControlBase kaynağından devralındı.)
	BindingContextChanged	Oluşur, değeri BindingContext özelliği ContentControlBase değişiklikler. (ContentControlBase kaynağından devralındı.)
	ContentUpdating	Yalnızca Microsoft Office Word'ün içerik denetimindeki metni güncelleştirir önce içerik denetimi özel XML bölümüne bağlıysa oluşur. (ContentControlBase kaynağından devralındı.)
	Deleting	Yalnızca içerik denetimi belgeden silinmeden önce oluşur. (ContentControlBase kaynağından devralındı.)
	Disposed	İşleme yöntemini gösteren Disposed bir bileşenin olay. (IComponent kaynağından devralındı.)
	Entering	Kullanıcı içerik denetimine tıkladığında veya imleç program aracılığıyla içerik denetimine hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	Exiting	Kullanıcı içerik denetiminin dışına tıkladığında veya imleç program aracılığıyla içerik denetiminin dışına hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	StoreUpdating	Yalnızca Microsoft Office Word'ün verileri, içeriğe bağlı özel XML bölümü güncellemeden önce oluşur (metin içerik denetimi değişiklikleri) sonra denetlemek. (ContentControlBase kaynağından devralındı.)
	Validated	İçerik denetimi başarıyla doğrulandı oluşur. (ContentControlBase kaynağından devralındı.)
	Validating	İçerik denetiminin içeriği doğrulama oluşur. (ContentControlBase kaynağından devralındı.)

Üst

Notlar

A ComboBoxContentControl kullanıcının seçebileceği öğelerin listesini görüntüler.Kullanıcılar ayrıca, kendi metin yazın bir ComboBoxContentControl.

Aşağı açılan liste öğelerinin kullanıcının düzenleyemeceği bir metin kutusunda görüntülemek için kullanın bir DropDownListContentControl.

Öğeler listesine erişmek için bir ComboBoxContentControl, kullanın DropDownListEntries özelliği.

[!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 Çalışma Zamanı İçin Visual Studio Araçlarına Genel Bakış.

İçerik Denetimleri

ComboBoxContentControl Sekiz tasarım belgeleri ve şablonları Microsoft Office Word için kullanabileceğiniz içerik denetimi türü bulunan biridir.İçerik denetimleri, bir kullanıcı arabirimi (UI) sahiptir, girdileri form gibi kontrol.Kullanıcılar korumalı belgenin veya şablonun bölümlerini düzenlemesini engellemek için içerik denetimlerini kullanabilirsiniz ve içerik denetimlerini veri kaynağına bağlayabilirsiniz.Daha fazla bilgi için bkz. İçerik Denetimleri.

Kullanım

Bu belgelerde, .NET Framework 4 ve .NET Framework 4.5'i hedefleyen Office projelerinde kullanılan bu türün sürümü açıklanı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ür hakkındaki belgeler için Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: https://go.microsoft.com/fwlink/?LinkId=160658.

Örnekler

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

Belge düzeyi özelleştirmesinde sürümüdür.Bu kodu kullanmak için içine yapıştırın ThisDocument sınıfı proje ve çağrı AddComboBoxControlAtSelection yönteminden ThisDocument_Startup yöntem.

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

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";
}

Bir uygulama düzeyi eklentisi değildir.Bu kodu kullanmak için içine yapıştırın ThisAddIn sınıfı proje ve çağrı AddComboBoxControlAtSelection yönteminden ThisAddIn_Startup yöntem.

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

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";            
}