GroupContentControl Schnittstelle
Definition
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 einen geschützten Bereich eines Dokuments dar, den Benutzer weder bearbeiten noch löschen können.
[System.Runtime.InteropServices.Guid("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")]
public interface GroupContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
- Attribute
- Implementiert
Beispiele
Im folgenden Codebeispiel wird ein neuer Absatz am Anfang des Dokuments hinzugefügt, und es wird ein neuer Absatz erstellt, der GroupContentControl diesen Absatz enthält. Verhindert, dass GroupContentControl Benutzer den Text im Absatz bearbeiten.
Diese Version ist für eine Anpassung auf Dokument Ebene vorgesehen. Um diesen Code zu verwenden, fügen Sie ihn in die ThisDocument -Klasse in Ihrem Projekt ein, und nennen Sie die- AddGroupControlAtSelection Methode von der- ThisDocument_Startup Methode.
private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;
private void AddGroupControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Word.Range range1 = this.Paragraphs[1].Range;
range1.Text = "You cannot edit or change the formatting of text " +
"in this paragraph, because this paragraph is in a GroupContentControl.";
range1.Select();
groupControl1 = this.Controls.AddGroupContentControl("groupControl1");
}
Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl
Private Sub AddGroupControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Text = "You cannot edit or change the formatting of text " & _
"in this paragraph, because this paragraph is in a GroupContentControl."
Me.Paragraphs(1).Range.Select()
groupControl1 = Me.Controls.AddGroupContentControl("groupControl1")
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 Ihrem Projekt ein, und nennen Sie die- AddGroupControlAtSelection Methode von der- ThisAddIn_Startup Methode.
private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;
private void AddGroupControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
Word.Range range1 = vstoDoc.Paragraphs[1].Range;
range1.Text = "You cannot edit or change the formatting of text " +
"in this paragraph, because this paragraph is in a GroupContentControl.";
range1.Select();
groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1");
}
Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl
Private Sub AddGroupControlAtSelection()
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.Text = "You cannot edit or change the formatting of text " & _
"in this paragraph, because this paragraph is in a GroupContentControl."
vstoDoc.Paragraphs(1).Range.Select()
groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1")
End Sub
Hinweise
Verwenden GroupContentControl Sie, um einen geschützten Bereich eines Dokuments zu definieren, den Benutzer nicht bearbeiten oder löschen können. Ein GroupContentControl kann beliebige Dokument Elemente enthalten, z. b. Text, Tabellen, Grafiken und sogar andere Inhalts Steuerelemente. Eine GroupContentControl stellt keine Benutzeroberfläche bereit, die für den Benutzer sichtbar ist. Weitere Informationen zum GroupContentControl Schützen eines Teils eines Dokuments mithilfe von finden Sie unter Inhalts Steuer Elemente und Gewusst wie: Schützen von Teilen von Dokumenten mithilfe von Inhalts Steuerelementen.
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
Der GroupContentControl ist einer von acht Typen von Inhalts Steuerelementen, die Sie zum Entwerfen von Dokumenten und Vorlagen in Microsoft Office Word verwenden können. Inhalts Steuerelemente verfügen über eine Benutzeroberfläche (UI), die über kontrollierte Eingaben wie ein Formular verfügt. 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. Weitere Informationen finden Sie unter Content Controls.
Verwendung
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 | (Geerbt von ContentControlBase) |
| ContainerComponent | (Geerbt von ContentControlBase) |
| Creator |
Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das GroupContentControl erstellt wurde. |
| DefaultDataSourceUpdateMode |
Ruft den Standard-DataSourceUpdateMode für das ContentControlBase ab oder legt diesen fest. (Geerbt von ContentControlBase) |
| 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 GroupContentControl aus dem Dokument gelöscht werden kann, oder legt diesen Wert fest. |
| Parent |
Ruft das übergeordnete Element von GroupContentControl ab. |
| ParentContentControl |
Ruft das übergeordnete Inhaltssteuerelement von einem GroupContentControl ab, das in einem anderen Inhaltselement geschachtelt ist. |
| Range |
Ruft einen Range ab, der den Inhalt von GroupContentControl darstellt. |
| Tag |
Ruft eine Zeichenfolge ab, die Sie dem GroupContentControl zuordnen möchten, oder legt eine Zeichenfolge fest. |
| Text |
Ruft den Text im GroupContentControl ab oder legt ihn fest. |
| Title |
Ruft den Titel für das GroupContentControl ab oder legt diesen fest. |
Methoden
| Copy() |
Kopiert das GroupContentControl aus dem Dokument in die Zwischenablage. |
| Cut() |
Entfernt das GroupContentControl 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) |
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) |