Aracılığıyla paylaş


ComboBoxContentControl Arabirim

Tanım

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
Uygulamalar

Ö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