ComboBoxContentControl Schnittstelle

Definition

Stellt ein Kombinationsfeld in einem Dokument dar.Represents a combo box on a document.

[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
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird ComboBoxContentControl am Anfang des Dokuments ein neues hinzugefügt.The following code example adds a new ComboBoxContentControl to the beginning of the document. Benutzer können einen Farbnamen auswählen, der vom Steuerelement angezeigt wird, oder Sie können den Namen einer neuen Farbe eingeben.Users can select a color name displayed by the control, or they can type the name of a new color.

Diese Version ist für eine Anpassung auf Dokument Ebene vorgesehen.This version is for a document-level customization. Um diesen Code zu verwenden, fügen Sie ihn in die ThisDocument -Klasse in Ihrem Projekt ein, und nennen Sie die- AddComboBoxControlAtSelection Methode von der- ThisDocument_Startup Methode.To use this code, paste it into the ThisDocument class in your project, and call the AddComboBoxControlAtSelection method from the ThisDocument_Startup method.

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.This version is for an application-level add-in. Um diesen Code zu verwenden, fügen Sie ihn in die ThisAddIn -Klasse in Ihrem Projekt ein, und nennen Sie die- AddComboBoxControlAtSelection Methode von der- ThisAddIn_Startup Methode.To use this code, paste it into the ThisAddIn class in your project, and call the AddComboBoxControlAtSelection method from the ThisAddIn_Startup method.

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

Eine ComboBoxContentControl zeigt eine Liste von Elementen an, die Benutzer auswählen können.A ComboBoxContentControl displays a list of items that users can select. Benutzer können auch ihren eigenen Text in einem eingeben ComboBoxContentControl .Users can also type their own text in a ComboBoxContentControl.

Verwenden Sie zum Anzeigen einer Dropdown Liste von Elementen in einem Textfeld, das von Benutzern nicht bearbeitet werden kann, eine DropDownListContentControl .To display a drop-down list of items in a text box that users cannot edit, use a DropDownListContentControl.

Um auf die Liste der Elemente in einem zuzugreifen ComboBoxContentControl , verwenden Sie die- DropDownListEntries Eigenschaft.To access the list of items in a ComboBoxContentControl, use the DropDownListEntries property.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert.This interface is implemented by the Visual Studio Tools for Office runtime. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird.It is not intended to be implemented in your code. Weitere Informationen finden Sie unter Visual Studio Tools for Office Runtime Overview.For more information, see Visual Studio Tools for Office Runtime Overview.

InhaltssteuerelementeContent Controls

Der ComboBoxContentControl ist einer von acht Typen von Inhalts Steuerelementen, die Sie zum Entwerfen von Dokumenten und Vorlagen in Microsoft Office Word verwenden können.The ComboBoxContentControl is one of eight types of content controls that you can use to design documents and templates in Microsoft Office Word. Inhalts Steuerelemente verfügen über eine Benutzeroberfläche (UI), die über kontrollierte Eingaben wie ein Formular verfügt.Content controls have a user interface (UI) that has controlled input like a form. Sie können Inhalts Steuerelemente verwenden, um zu verhindern, dass Benutzer geschützte Abschnitte des Dokuments oder der Vorlage bearbeiten, und Sie können Inhalts Steuerelemente auch an eine Datenquelle binden.You can use content controls to prevent users from editing protected sections of the document or template, and you can also bind content controls to a data source. Weitere Informationen finden Sie unter Content Controls.For more information, see Content Controls.

VerwendungUsage

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher ausgerichtet sind.This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 or later. 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.In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. 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.For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

Application

Ruft eine Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.Gets a Application that represents the current instance of Microsoft Office Word.

Container (Geerbt von ContentControlBase)
ContainerComponent (Geerbt von ContentControlBase)
Creator

Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das ComboBoxContentControl erstellt wurde.Gets a 32-bit integer that indicates the application in which the ComboBoxContentControl was created.

DefaultDataSourceUpdateMode

Ruft den Standard-DataSourceUpdateMode für das ContentControlBase ab oder legt diesen fest.Gets or sets the default DataSourceUpdateMode for the ContentControlBase.

(Geerbt von ContentControlBase)
DefaultTextStyle

Ruft den Namen des Zeichenstils ab, der verwendet wird, um im ComboBoxContentControl Text zu formatieren.Gets the name of the character style that is used to format text in the ComboBoxContentControl.

DropDownListEntries

Ruft die Auflistung von Elementen ab, die vom ComboBoxContentControl angezeigt werden.Gets the collection of items that are displayed by the ComboBoxContentControl.

ID

Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert.Gets a unique number that identifies the content control.

(Geerbt von ContentControlBase)
InnerObject

Ruft das zugrunde liegende ContentControl-Objekt für ContentControlBase ab.Gets the underlying ContentControl object for the ContentControlBase.

(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.Gets or sets a value that specifies whether the ComboBoxContentControl can be deleted from the document.

LockContents

Ruft einen Wert ab, der angibt, ob die Inhalte des ComboBoxContentControl bearbeitet werden können, oder legt diesen Wert fest.Gets or sets a value that specifies whether the contents of the ComboBoxContentControl can be edited.

MultiLine

Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl Zeilenumbrüche enthalten kann, oder legt einen Wert fest.Gets or sets a value that specifies whether the ComboBoxContentControl can contain line breaks.

Parent

Ruft das übergeordnete Element von ComboBoxContentControl ab.Gets the parent of the ComboBoxContentControl.

ParentContentControl

Ruft das übergeordnete Inhaltssteuerelement von einem ComboBoxContentControl ab, das in einem anderen Inhaltselement geschachtelt ist.Gets the parent content control of a ComboBoxContentControl that is nested in another content control.

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.Gets or sets the text that is displayed in the ComboBoxContentControl until the text is changed by a user action or some other operation.

Range

Ruft einen Range ab, der den Inhalt von ComboBoxContentControl darstellt.Gets a Range that represents the contents of the ComboBoxContentControl.

ShowingPlaceholderText

Ruft einen Wert ab, der angibt, ob das ComboBoxContentControl derzeit Platzhaltertext anzeigt.Gets a value that indicates whether the ComboBoxContentControl is currently displaying placeholder text.

Tag

Ruft eine Zeichenfolge ab, die Sie dem ComboBoxContentControl zuordnen möchten, oder legt eine Zeichenfolge fest.Gets or sets a string that you want to associate with the ComboBoxContentControl.

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.Gets or sets a value that specifies whether the ComboBoxContentControl is automatically deleted from the document when the control is edited.

Text

Ruft den Text im ComboBoxContentControl ab oder legt ihn fest.Gets or sets the text in the ComboBoxContentControl.

Title

Ruft den Titel für das ComboBoxContentControl ab oder legt diesen fest.Gets or sets the title of the ComboBoxContentControl.

XMLMapping

Ruft eine XMLMapping ab, die die Bindung zwischen dem ComboBoxContentControl und einem Element in einem benutzerdefinierten XML-Teil darstellt.Gets an XMLMapping that represents the binding between the ComboBoxContentControl and an element in a custom XML part.

Methoden

Copy()

Kopiert das ComboBoxContentControl aus dem Dokument in die Zwischenablage.Copies the ComboBoxContentControl from the document to the Clipboard.

Cut()

Entfernt das ComboBoxContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.Removes the ComboBoxContentControl from the document and adds it to the Clipboard.

Delete(Boolean)

Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument.Deletes a dynamically created content control from the document and removes it from the ControlCollection in the document.

(Geerbt von ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)

Zeigt Text an, der sich in T:Microsoft.Office.Interop.Word.BuildingBlock, Range oder in einer Zeichenfolge als Platzhaltertext in ComboBoxContentControl befindet.Displays text that is in a T:Microsoft.Office.Interop.Word.BuildingBlock, a Range, or a string as the placeholder text in the ComboBoxContentControl.

Ereignisse

Added

Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde.Occurs after the content control is added to the document.

(Geerbt von ContentControlBase)
BindingContextChanged

Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird.Occurs when the value of the BindingContext property of the ContentControlBase changes.

(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.Occurs just before Microsoft Office Word updates the text in the content control, if the content control is bound to a custom XML part.

(Geerbt von ContentControlBase)
Deleting

Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf.Occurs just before the content control is deleted from the document.

(Geerbt von ContentControlBase)
Entering

Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird.Occurs when the user clicks in the content control, or when the cursor is moved into the content control programmatically.

(Geerbt von ContentControlBase)
Exiting

Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird.Occurs when the user clicks outside the content control, or when the cursor is moved outside the content control programmatically.

(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).Occurs just before Microsoft Office Word updates data in a custom XML part that is bound to the content control (that is, after the text in the content control changes).

(Geerbt von ContentControlBase)
Validated

Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde.Occurs when the content control has been successfully validated.

(Geerbt von ContentControlBase)
Validating

Tritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird.Occurs when the contents of the content control are being validated.

(Geerbt von ContentControlBase)

Gilt für: