ComboBoxContentControl Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Kombinationsfeld in einem Dokument dar.

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

Attribute: GuidAttribute

Implementiert: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Beispiele

Im folgenden Codebeispiel wird am Anfang des Dokuments ein neues ComboBoxContentControl hinzugefügt. Benutzer können einen Farbnamen auswählen, der vom Steuerelement angezeigt wird, oder sie können den Namen einer neuen Farbe eingeben.

Diese Version ist für eine Anpassung auf Dokumentebene vorgesehen. Um diesen Code zu verwenden, fügen Sie ihn in die ThisDocument -Klasse in Ihr Projekt ein, und rufen Sie die AddComboBoxControlAtSelection -Methode von der ThisDocument_Startup -Methode auf.

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

Diese Version ist für ein Add-In auf Anwendungsebene vorgesehen. Um diesen Code zu verwenden, fügen Sie ihn in die ThisAddIn -Klasse in Ihr Projekt ein, und rufen Sie die AddComboBoxControlAtSelection -Methode von der ThisAddIn_Startup -Methode auf.

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

Hinweise

A ComboBoxContentControl zeigt eine Liste der Elemente an, die Benutzer auswählen können. Benutzer können auch ihren eigenen Text in ein ComboBoxContentControleingeben.

Um eine Dropdownliste mit Elementen in einem Textfeld anzuzeigen, das Benutzer nicht bearbeiten können, verwenden Sie ein DropDownListContentControl.

Verwenden Sie die -Eigenschaft, um auf die DropDownListEntries Liste der Elemente in einem ComboBoxContentControlzuzugreifen.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Visual Studio Tools for Office Runtime Overview.

Inhaltssteuerelemente

Die ComboBoxContentControl ist eine von acht Arten von Inhaltssteuerelementen, die Sie zum Entwerfen von Dokumenten und Vorlagen in Microsoft Office Word verwenden können. Inhaltssteuerelemente verfügen über eine Benutzeroberfläche( UI), die über eine kontrollierte Eingabe wie ein Formular verfügt. Sie können Inhaltssteuerelemente verwenden, um zu verhindern, dass Benutzer geschützte Abschnitte des Dokuments oder der Vorlage bearbeiten, und Sie können auch Inhaltssteuerelemente an eine Datenquelle binden. Weitere Informationen finden Sie unter Content Controls.

Verbrauch

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

Application	Ruft eine Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.
Container	Stellt ein Kombinationsfeld in einem Dokument dar. (Geerbt von ContentControlBase)
ContainerComponent	Stellt ein Kombinationsfeld in einem Dokument dar. (Geerbt von ContentControlBase)
Creator	Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das ComboBoxContentControl erstellt wurde.
DefaultDataSourceUpdateMode	Ruft den Standard-DataSourceUpdateMode für das ContentControlBase ab oder legt diesen fest. (Geerbt von ContentControlBase)
DefaultTextStyle	Ruft den Namen des Zeichenstils ab, der verwendet wird, um im ComboBoxContentControl Text zu formatieren.
DropDownListEntries	Ruft die Auflistung von Elementen ab, die vom ComboBoxContentControl angezeigt werden.
ID	Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert. (Geerbt von ContentControlBase)
InnerObject	Ruft das zugrunde liegende ContentControl-Objekt für ContentControlBase ab. (Geerbt von ContentControlBase)
LockContentControl	Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl aus dem Dokument gelöscht werden kann, oder legt diesen Wert fest.
LockContents	Ruft einen Wert ab, der angibt, ob die Inhalte des ComboBoxContentControl bearbeitet werden können, oder legt diesen Wert fest.
MultiLine	Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl Zeilenumbrüche enthalten kann, oder legt einen Wert fest.
Parent	Ruft das übergeordnete Element von ComboBoxContentControl ab.
ParentContentControl	Ruft das übergeordnete Inhaltssteuerelement von einem ComboBoxContentControl ab, das in einem anderen Inhaltselement geschachtelt ist.
PlaceholderText	Ruft den Text ab, der im ComboBoxContentControl angezeigt wird, bis der Text durch eine Benutzeraktion oder einen anderen Vorgang geändert wird, oder legt den Text fest.
Range	Ruft einen Range ab, der den Inhalt von ComboBoxContentControl darstellt.
ShowingPlaceholderText	Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl derzeit Platzhaltertext anzeigt.
Tag	Ruft eine Zeichenfolge ab, die Sie dem ComboBoxContentControl zuordnen möchten, oder legt eine Zeichenfolge fest.
Temporary	Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl bei Bearbeitung des Steuerelements automatisch aus dem Dokument gelöscht wird, oder legt den Wert fest.
Text	Ruft den Text im ComboBoxContentControl ab oder legt ihn fest.
Title	Ruft den Titel für das ComboBoxContentControl ab oder legt diesen fest.
XMLMapping	Ruft eine XMLMapping ab, die die Bindung zwischen dem ComboBoxContentControl und einem Element in einem benutzerdefinierten XML-Teil darstellt.

Methoden

Copy()	Kopiert das ComboBoxContentControl aus dem Dokument in die Zwischenablage.
Cut()	Entfernt das ComboBoxContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.
Delete(Boolean)	Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument. (Geerbt von ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Zeigt Text in einem T:Microsoft.Office.Interop an. Word. BuildingBlock, eine Range- oder eine Zeichenfolge als Platzhaltertext im ComboBoxContentControl.

Ereignisse

Added	Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde. (Geerbt von ContentControlBase)
BindingContextChanged	Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird. (Geerbt von ContentControlBase)
ContentUpdating	Tritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist. (Geerbt von ContentControlBase)
Deleting	Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf. (Geerbt von ContentControlBase)
Entering	Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird. (Geerbt von ContentControlBase)
Exiting	Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird. (Geerbt von ContentControlBase)
StoreUpdating	Tritt auf, kurz bevor Microsoft Office Word automatisch die Daten in einem benutzerdefinierten XML-Abschnitt aktualisiert, der an das Inhaltssteuerelement gebunden ist (d.h. nachdem sich der Text im Inhaltssteuerelement ändert). (Geerbt von ContentControlBase)
Validated	Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde. (Geerbt von ContentControlBase)
Validating	Tritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird. (Geerbt von ContentControlBase)

Gilt für: