PictureContentControl الواجهة

مقالة
09/21/2010

يمثل منطقة مستند الذي يعرض نسخة.

مساحة الاسم: Microsoft.Office.Tools.Word
التجميع: Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
<GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")> _
Public Interface PictureContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

ملاحظات

PictureContentControlيعرض نسخة. يمكنك تحديد الصورة في وقت التصميم أو في وقت التشغيل، أو يمكن للمستخدمين النقر فوق عنصر التحكم هذا لتحديد صورة لإدراجها في المستند.

إلى الحصول على أو تعيين الصورة، استخدم Imageخاصية. افتراضياً، يتعذر على المستخدمين تغيير نسخة في PictureContentControlفي وقت التشغيل. إذا كنت ترغب في تمكين المستخدمين من اختيار الصورة التي سيتم عرضها في عنصر تحكم، قم بتعيين ShowInsertPictureIconخاصية إلى true.

ملاحظة

يتم تطبيق هذه الواجهة بواسطة Visual Studio Tools لوقت تشغيل Office. ولم يتم تصميمها لتطبيقها في التعليمة البرمجية الخاصة بك. لمزيد من المعلومات، راجع أدوات Visual Studio نظرة عامة وقت تشغيل Office.

عناصر تحكم المحتوى

PictureContentControlهو ثمانية من أنواع عناصر تحكم المحتوى التي يمكنك استخدامها لتصميم مستندات والقوالب في Microsoft المكتب الكلمة. محتوى عناصر التحكم وجود واجهة مستخدم (واجه المستخدم) الذي يحتوي على التحكم في إدخال كنموذج. يمكنك استخدام عناصر تحكم المحتوى لمنع المستخدمين من ‏‏تحرير مقاطع محمية من مستند أو القالب، و يمكنك أيضا يربط عناصر تحكم المحتوى إلى مصدر بيانات. لمزيد من المعلومات، راجع عناصر تحكم المحتوى.

الاستخدام

توضح هذه الوثائق الإصدار الخاص بهذا النوع المستخدم في مشاريع Office والذي يستهدف .NET Framework 4. وفي المشاريع التي تستهدف .NET Framework 3.5، قد يكون لدى هذا النوع أعضاء مختلفون وقد لا تعمل نماذج التعليمات البرمجية الخاصة بهذا النوع. للحصول على وثائق حول هذا النوع في المشاريع التي تستهدف .NET Framework 3.5، اطلع على جزء المرجع التالي في وثائق Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

أمثلة

يلي تعليمات برمجية في المثال إضافة جديد PictureContentControlإلى بداية مستند. يفترض هذا المثال وجود ملف يسمى صورة.bmp في المجلد "مستندات"%UserProfile%\My (لنظام التشغيل ‏‫نظام التشغيل Windows XP و سابقا) أو في مجلد%UserProfile%\مستندات (لنظام التشغيل ‏‫Windows Vista).

Th هو الإصدار هو لتخصيص المستوى مستند. إلى استخدام هذا الرمز، قم بلصقه في إلى ThisDocumentالفئة في مشروع، واستدعاء AddPictureControlAtSelectionأسلوب من ThisDocument_Startupالأسلوب.

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    pictureControl1 = Me.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

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;
}

Th هو الإصدار هو للوظيفة الإضافية المستوى تطبيق. إلى استخدام هذا الرمز، قم بلصقه في إلى ThisAddInالفئة في مشروع، واستدعاء AddPictureControlAtSelectionأسلوب من ThisAddIn_Startupالأسلوب.

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    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()
    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

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;
}