PictureContentControl Arabirim

Makale
08/01/2011

Bir görüntüyü gösterir bir belge bölge temsil eder.

Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll içinde)

Sözdizimi

'Bildirim
<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 türü aşağıdaki üyeleri ortaya koyar.

Özellikler

	Ad	Açıklama
	Application	Alır bir Microsoft.Office.Interop.Word.Application temsil eden geçerli örneğini Microsoft Office Word.
	BindingContext	Alır veya ayarlar için para birimi yöneticileri topluluğu IBindableComponent. (IBindableComponent kaynağından devralındı.)
	Container	Altyapı. (ContentControlBase kaynağından devralındı.)
	ContainerComponent	Altyapı. (ContentControlBase kaynağından devralındı.)
	Creator	Uygulaması gösterir bir 32 bitlik tamsayı alır PictureContentControl oluşturuldu.
	DataBindings	Bu veri bağlama nesneler topluluğu alır IBindableComponent. (IBindableComponent kaynağından devralındı.)
	DefaultDataSourceUpdateMode	Alır veya ayarlar varsayılan DataSourceUpdateMode için ContentControlBase. (ContentControlBase kaynağından devralındı.)
	ID	İçerik denetimi tanımlayan benzersiz bir numara alır. (ContentControlBase kaynağından devralındı.)
	Image	Alır veya ayarlar tarafından görüntülenen görüntü PictureContentControl.
	InnerObject	Temel alır Microsoft.Office.Interop.Word.ContentControl için nesne Microsoft.Office.Tools.Word.ContentControlBase. (ContentControlBase kaynağından devralındı.)
	LockContentControl	Belirten bir değeri alır veya ayarlar olup olmadığını PictureContentControl belge. silinebilir
	LockContents	Belirten bir değeri alır veya ayarlar olup olmadığını içeriğini PictureContentControl düzenlenebilir.
	Parent	Üst alır PictureContentControl.
	ParentContentControl	En üst içerik denetimini bir PictureContentControl başka bir içerik denetimi yuvalanmış
	Range	Alır bir Range içeriğini temsil eden PictureContentControl.
	ShowInsertPictureIcon	Alır veya kullanıcıların zamanında denetimde görüntülemek için görüntü seçmek için tıklatabileceğiniz kullanıcı Arabirimi görüntülenip görüntülenmeyeceğini belirleyen bir değer ayarlar.
	Site	Alır veya ayarlar ISite ile ilgili IComponent. (IComponent kaynağından devralındı.)
	Tag	Alır veya ayarlar ile ilişkilendirmek istediğiniz dizeyi PictureContentControl.
	Temporary	Belirten bir değeri alır veya ayarlar olup olmadığını PictureContentControl Denetim düzenlendiğinde belgenin otomatik olarak silinir.
	Title	Alır veya ayarlar başlığının PictureContentControl.
	XMLMapping	Alır bir XMLMapping arasında bir bağ temsil eden PictureContentControl ve özel xml kısmı öğesinin

Üst

Yöntemler

	Ad	Açıklama
	BeginInit	Nesne sinyalleri bu başlatma başlatıyor. (ISupportInitialize kaynağından devralındı.)
	Copy	Kopya PictureContentControl belgesinden Pano.
	Cut	Kaldırır PictureContentControl belge ve onu panoya ekler.
	Delete	Belgeden bir dinamik olarak oluşturulan içerik denetimini siler ve bu kapsamdan kaldırır ControlCollection belge. (ContentControlBase kaynağından devralındı.)
	Dispose	Boşaltma, serbest bırakma veya yönetilmeyen kaynakları sıfırlama ile ilişkilendirilmiş uygulama tanımlı görevleri gerçekleştirir. (IDisposable kaynağından devralındı.)
	EndInit	Nesne sinyalleri bu Başlatma tamamlanır. (ISupportInitialize kaynağından devralındı.)

Üst

Olaylar

	Ad	Açıklama
	Added	İçerik denetimi belgeye eklendikten sonra gerçekleşir. (ContentControlBase kaynağından devralındı.)
	BindingContextChanged	Oluşur, değeri BindingContext özelliği ContentControlBase değişiklikler. (ContentControlBase kaynağından devralındı.)
	ContentUpdating	Yalnızca Microsoft Office Word içerik denetimindeki metni güncelleştirir önce özel bir xml parçası içerik denetimine bağlı ortaya çıkar. (ContentControlBase kaynağından devralındı.)
	Deleting	Belgeden içerik denetimi yalnızca silinmeden önce oluşur. (ContentControlBase kaynağından devralındı.)
	Disposed	İşleme yöntemini gösteren Disposed olayı için bir bileşen. (IComponent kaynağından devralındı.)
	Entering	Kullanıcı içerik denetimi tıklattığında veya imleci içerik denetime programlı hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	Exiting	Kullanıcı dışında içerik denetimi tıklattığında veya imleci programlı içerik denetimi dışında hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	StoreUpdating	Yalnızca Microsoft Office Word içeriğine bağlı özel bir xml parçası güncelleştirir önce gerçekleşir (yani, metin içeriği kontrol sonra değişiklikleri) kontrol. (ContentControlBase kaynağından devralındı.)
	Validated	İçerik denetimi başarıyla doğrulandı oluşur. (ContentControlBase kaynağından devralındı.)
	Validating	İçerik denetimi içeriğinin doğrulandığı zaman ortaya çıkar. (ContentControlBase kaynağından devralındı.)

Üst

Açıklamalar

A PictureContentControl görüntüler bir görüntü. Görüntüyü tasarım yada çalışma anında belirleyebilirsiniz veya kullanıcılar bu denetimi bir görüntüyü belgeye eklemek için tıklayabilirler.

Almak ya da görüntüyü ayarlamak için Image özelliği. Varsayılan olarak, görüntüdeki kullanıcılar değiştiremez PictureContentControl çalışma süresi. Kullanıcıların denetimde görüntülemek ayarlamak için görüntü sağlamak istiyorsanız, ShowInsertPictureIcon özelliğine true.

Not

Bu arabirim Office için Visual Studio Araçları çalışma zamanı modülü tarafından uygulanır. Kodunuzda gerçekleştirilmesi amaçlanmamıştır. Daha fazla bilgi için bkz: Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

İçerik Denetimleri

PictureContentControl İçerik denetimleri, belgeler ve şablonlar, tasarlamak için kullanabileceğiniz sekiz tür bir taneMicrosoft Office Word. İçerik denetimleri, bir kullanıcı arabirimi (UI) sahip, form gibi giriş kontrol. Kullanıcıların belgeyi veya şablonu korumalı bölümleri düzenlemesini engellemek için içerik denetimlerini kullanabilirsiniz ve İçerik denetimlerine veri kaynağına bağlayabilirsiniz. Daha fazla bilgi için bkz. İçerik Denetimleri.

Kullanım

Bu belgelerde, .NET Framework 4'ü hedefleyen projelerde kullanılan bu türün sürümü açıklanır. .NET Framework 3.5'i hedefleyen projelerde, bu türün üyeleri farklı olabilir ve bu tür için sağlanan kod örnekleri çalışmayabilir. .NET Framework 3.5'i hedefleyen projelerde bu tür hakkındaki belgeler için, Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: https://go.microsoft.com/fwlink/?LinkId=160658.

Örnekler

Aşağıdaki kod örneği, yeni bir ekler PictureContentControl başına belge. Bu örnek, bir dosya adındaki varsayar Resim.bmp %USERPROFILE%\My Documents klasöründe (Windows xp ve önceki sürümleri için) veya %UserProfile%\Documents klasöründe (Windows Vista) bulunmaktadır.

Belge düzeyinde özelleştirme için değil. Bu kodu kullanmak için içine Yapıştır ThisDocument sınıfı proje ve çağrı AddPictureControlAtSelection yönteminden ThisDocument_Startup yöntemi.

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

Bu bir uygulama düzeyinde eklentisi sürümüdür. Bu kodu kullanmak için içine Yapıştır ThisAddIn sınıfı proje ve çağrı AddPictureControlAtSelection yönteminden ThisAddIn_Startup yöntemi.

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