PictureContentControl Arabirim
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 Microsoft Office Word'ün geçerli örneğinin temsil eden. | |
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ı belirten 32 bitlik bir 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 belgeden silindi. | |
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 içinde yuvalanmış. | |
Range | Alır bir Range içeriğini temsil eden PictureContentControl. | |
ShowInsertPictureIcon | Alır veya kullanıcıların, çalışma zamanında denetim içinde görüntülenecek görüntüyü 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 bir dize 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 ile özel bir xml parçası bir öğe. |
Üst
Yöntemler
Ad | Açıklama | |
---|---|---|
BeginInit | Nesne sinyalleri bu başlatma başlatıyor. (ISupportInitialize kaynağından devralındı.) | |
Copy | Kopya PictureContentControl Pano belgesinden. | |
Cut | Kaldırır PictureContentControl belge ve panoya ekler. | |
Delete | Belgeden bir dinamik olarak oluşturulan içerik denetimini siler ve bu kapsamdan kaldırır ControlCollection belge içinde. (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 ekledikten sonra oluşur. (ContentControlBase kaynağından devralındı.) | |
BindingContextChanged | Oluşur, değeri BindingContext özelliðinin ContentControlBase değişiklikler. (ContentControlBase kaynağından devralındı.) | |
ContentUpdating | Yalnızca Microsoft Office Word içerik denetimindeki metni güncelleştirir önce içerik denetimi için özel bir xml parçası bağlıysa oluşur. (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 bir bileşenin olay. (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ı olarak 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 bölümündeki verileri güncelleştirir önce oluşur (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 denetim içeriğini doğrulandığı zaman ortaya çıkar. (ContentControlBase kaynağından devralındı.) |
Üst
Notlar
A PictureContentControl bir resim görüntüler.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 zamanında.Kullanıcıların denetimde görüntülemek için ayarlamak görüntü sağlamak isterseniz, ShowInsertPictureIcon özelliğine true.
[!NOT]
Bu arabirim Office için Visual Studio Araçları çalışma zamanı 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 , Tasarım belgeleri ve şablonları, Microsoft Office Word için kullanabileceğiniz içerik denetimlerinin sekiz türlerinden biridir.İçerik denetimleri, bir kullanıcı arabirimi (UI) sahip, form gibi giriş kontrol.İçerik denetimleri bir veri kaynağına bağlayabilir ve kullanıcıların belgeyi veya şablonu korumalı bölümleri düzenlemesini engellemek için içerik denetimleri kullanabilirsiniz.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 ekler yeni bir PictureContentControl belgenin başına.Bu örnekte, dosya adında kabul 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ğildir.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;
}
Bir uygulama düzeyinde eklenti değildir.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;
}
Ayrıca bkz.
Başvuru
Microsoft.Office.Tools.Word Ad Alanı
Diğer Kaynaklar
Nasıl yapılır: Word belgeleri için içerik denetimleri ekleme
Nasıl yapılır: belgelerin kısımlarını içerik denetimleri kullanarak koruyun
İzlenecek yol: içerik denetimlerini kullanarak şablon oluşturma
İzlenecek yol: Özel xml bölümlerine bağlama içerik denetimlerine