Homepage Library Lernen Code-Beispiele Downloads Support Community Foren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

PictureContentControl-Schnittstelle

Visual Studio 2012

Stellt einen Dokumentbereich dar, der ein Bild anzeigt.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
C#
VB
Kopieren 
[GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : ContentControlBase, 
	IBindableComponent, IComponent, IDisposable, ISupportInitialize

Der PictureContentControl-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche EigenschaftApplicationRuft eine Microsoft.Office.Interop.Word.Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.
Öffentliche EigenschaftBindingContextRuft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Von IBindableComponent geerbt.)
Öffentliche EigenschaftContainerInfrastruktur. (Von ContentControlBase geerbt.)
Öffentliche EigenschaftContainerComponentInfrastruktur. (Von ContentControlBase geerbt.)
Öffentliche EigenschaftCreatorRuft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das PictureContentControl erstellt wurde.
Öffentliche EigenschaftDataBindingsRuft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Von IBindableComponent geerbt.)
Öffentliche EigenschaftDefaultDataSourceUpdateModeRuft den Standard-DataSourceUpdateMode für den ContentControlBase ab oder legt diesen fest. (Von ContentControlBase geerbt.)
Öffentliche EigenschaftIDRuft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert. (Von ContentControlBase geerbt.)
Öffentliche EigenschaftImageRuft das im PictureContentControl dargestellte Bild ab oder legt dieses fest.
Öffentliche EigenschaftInnerObjectRuft das zugrunde liegende Microsoft.Office.Interop.Word.ContentControl-Objekt für das Microsoft.Office.Tools.Word.ContentControlBase ab. (Von ContentControlBase geerbt.)
Öffentliche EigenschaftLockContentControlRuft einen Wert ab, der angibt, ob das PictureContentControl-Element aus dem Dokument gelöscht werden kann, oder legt den Wert fest.
Öffentliche EigenschaftLockContentsRuft einen Wert ab, der angibt, ob der Inhalt vom PictureContentControl bearbeitet werden kann, oder legt den Wert fest.
Öffentliche EigenschaftParentRuft das übergeordnete Element für das PictureContentControl ab.
Öffentliche EigenschaftParentContentControlRuft das übergeordnete Inhaltssteuerelement von einem PictureContentControl ab, das in einem anderen Inhaltselement geschachtelt ist.
Öffentliche EigenschaftRangeRuft einen Range ab, der den Inhalt vom PictureContentControl darstellt.
Öffentliche EigenschaftShowInsertPictureIconRuft einen Wert ab, der angibt, ob die Benutzeroberfläche angezeigt wird, auf die Benutzer klicken können, um ein Bild auszuwählen, das zur Laufzeit im Steuerelement angezeigt werden kann.
Öffentliche EigenschaftSiteRuft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
Öffentliche EigenschaftTagRuft eine Zeichenfolge ab, die Sie dem PictureContentControl zuordnen möchten, oder legt eine Zeichenfolge fest.
Öffentliche EigenschaftTemporaryRuft einen Wert ab, der angibt, ob das PictureContentControl bei Bearbeitung des Steuerelements automatisch aus dem Dokument gelöscht wird, oder legt den Wert fest.
Öffentliche EigenschaftTitleRuft den Titel für das PictureContentControl ab oder legt diesen fest.
Öffentliche EigenschaftXMLMappingRuft eine XMLMapping ab, die die Bindung zwischen dem PictureContentControl und einem Element in einem benutzerdefinierten XML-Abschnitt darstellt.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeBeginInitSignalisiert dem Objekt den Start der Initialisierung. (Von ISupportInitialize geerbt.)
Öffentliche MethodeCopyKopiert das PictureContentControl aus dem Dokument in die Zwischenablage.
Öffentliche MethodeCutEntfernt das PictureContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.
Öffentliche MethodeDeleteLöscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument. (Von ContentControlBase geerbt.)
Öffentliche MethodeDisposeFührt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
Öffentliche MethodeEndInitSignalisiert dem Objekt den Abschluss der Initialisierung. (Von ISupportInitialize geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliches EreignisAddedTritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde. (Von ContentControlBase geerbt.)
Öffentliches EreignisBindingContextChangedTritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird. (Von ContentControlBase geerbt.)
Öffentliches EreignisContentUpdatingTritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist. (Von ContentControlBase geerbt.)
Öffentliches EreignisDeletingTritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf. (Von ContentControlBase geerbt.)
Öffentliches EreignisDisposedStellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
Öffentliches EreignisEnteringTritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches EreignisExitingTritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches EreignisStoreUpdatingTritt auf, kurz bevor Microsoft Office Word Daten in einem benutzerdefinierten XML-Abschnitt aktualisiert, der an das Inhaltssteuerelement gebunden ist (nachdem der Text im Inhaltssteuerelement sich ändert). (Von ContentControlBase geerbt.)
Öffentliches EreignisValidatedTritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde. (Von ContentControlBase geerbt.)
Öffentliches EreignisValidatingTritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird. (Von ContentControlBase geerbt.)
Zum Seitenanfang

Ein PictureContentControl zeigt ein Bild an. Sie können das Bild zur Entwurfszeit oder zur Laufzeit angeben, oder Benutzer können auf dieses Steuerelement klicken, um ein Bild auszuwählen, das in das Dokument eingefügt werden soll.

Um das Bild abzurufen oder festzulegen, verwenden Sie die Image-Eigenschaft. Standardmäßig können Benutzer das Bild zur Laufzeit nicht im PictureContentControl ändern. Wenn Sie möchten, dass Benutzer das Bild auswählen können, das im Steuerelement angezeigt wird, legen Sie die ShowInsertPictureIcon-Eigenschaft auf true fest.

HinweisHinweis

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 Übersicht über die Visual Studio Tools for Office-Laufzeit.

Inhaltssteuerelemente

Das PictureContentControl ist einer von acht Steuerelementtypen, die Sie in Microsoft Office Word zum Entwerfen von Dokumenten und Vorlagen verwenden können. Inhaltssteuerelemente haben eine Benutzeroberfläche mit verwalteten Benutzereingaben wie bei einem Formular. Sie können mithilfe von Inhaltssteuerelementen verhindern, dass Benutzer geschützte Abschnitte des Dokuments bzw. der Vorlage bearbeiten. Außerdem können Sie Inhaltssteuerelemente an eine Datenquelle binden. Weitere Informationen finden Sie unter Inhaltssteuerelemente.

Verwendung

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 verfügt dieser Typ möglicherweise über unterschiedliche Member und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: http://go.microsoft.com/fwlink/?LinkId=160658.

Im folgenden Codebeispiel wird am Anfang des Dokuments ein neues PictureContentControl hinzugefügt. In diesem Beispiel wird davon ausgegangen, dass sich eine Datei mit dem Namen picture.bmp im Ordner %UserProfile%\My Documents (für Windows XP und frühere Windows-Versionen) bzw. im Ordner %UserProfile%\Documents (für Windows Vista) befindet.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisDocument-Klasse in das Projekt ein und rufen in der ThisDocument_Startup-Methode die AddPictureControlAtSelection-Methode auf.

C#
VB
Kopieren 

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

private void AddPictureControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    pictureControl1 = this.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisAddIn-Klasse in das Projekt ein und rufen in der ThisAddIn_Startup-Methode die AddPictureControlAtSelection-Methode auf.

C#
VB
Kopieren 

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

private void AddPictureControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Informationen zur Datensicherheit
© 2013 Microsoft. Alle Rechte vorbehalten.
|
Feedback zur Website
© 2013 Microsoft. Alle Rechte vorbehalten.