Interfejs PlainTextContentControl

Artykuł
05/08/2013

Reprezentuje bloku tekstu w dokumencie.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
<GuidAttribute("a8c46931-fa10-4760-8b46-0f2d881e269f")> _
Public Interface PlainTextContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("a8c46931-fa10-4760-8b46-0f2d881e269f")]
public interface PlainTextContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Typ PlainTextContentControl uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Application	Pobiera Microsoft.Office.Interop.Word.Application , oznaczającą w bieżącym wystąpieniu programu Microsoft Office Word.
	BindingContext	Zwraca lub ustawia kolekcji menedżerów waluty IBindableComponent. (Odziedziczone z IBindableComponent).
	Container	Infrastruktura. (Odziedziczone z ContentControlBase).
	ContainerComponent	Infrastruktura. (Odziedziczone z ContentControlBase).
	Creator	32-Bitowa liczba całkowita, która wskazuje aplikacji, w którym dostaje PlainTextContentControl został utworzony.
	DataBindings	Zwraca kolekcję obiektów wiązania danych dla tej IBindableComponent. (Odziedziczone z IBindableComponent).
	DefaultDataSourceUpdateMode	Pobiera lub ustawia domyślną DataSourceUpdateMode dla ContentControlBase. (Odziedziczone z ContentControlBase).
	DefaultTextStyle	Pobiera nazwę stylu znakowego, który będzie formatował tekst w PlainTextContentControl.
	ID	Pobiera unikatowy numer identyfikacyjny formantu zawartości. (Odziedziczone z ContentControlBase).
	InnerObject	Pobiera, podstawową Microsoft.Office.Interop.Word.ContentControl obiekt na potrzeby Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość, która określa, czy PlainTextContentControl mogą zostać usunięte z dokumentu.
	LockContents	Pobiera lub ustawia wartość, która określa, czy zawartość PlainTextContentControl mogą być edytowane.
	MultiLine	Pobiera lub ustawia wartość, która określa, czy PlainTextContentControl może zawierać podziałów wierszy.
	Parent	Pobiera element nadrzędny z PlainTextContentControl.
	ParentContentControl	Pobiera element nadrzędny zawartości kontrolę nad PlainTextContentControl który jest zagnieżdżony w innym formancie zawartości.
	PlaceholderText	Pobiera lub ustawia tekst, który jest wyświetlany na PlainTextContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub wykonania innej operacji.
	Range	Pobiera Range , oznaczającą zawartość PlainTextContentControl.
	ShowingPlaceholderText	Pobiera wartość, która określa, czy PlainTextContentControl nieużywanym tekst zastępczy.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który chcesz skojarzyć z PlainTextContentControl.
	Temporary	Pobiera lub ustawia wartość, która określa, czy PlainTextContentControl jest automatycznie usuwany z dokumentu, gdy formant jest edytowany.
	Text	Pobiera lub ustawia tekst w PlainTextContentControl.
	Title	Pobiera lub ustawia tytuł PlainTextContentControl.
	XMLMapping	Pobiera XMLMapping , oznaczającą powiązania między PlainTextContentControl i element niestandardowa część kodu XML.

Początek

Metody

	Nazwa	Opis
	BeginInit	Sygnalizuje ten obiekt, że inicjowania jest uruchamiana. (Odziedziczone z ISupportInitialize).
	Copy	Kopie PlainTextContentControl z dokumentu do Schowka.
	Cut	Usuwa PlainTextContentControl z dokumentu i dodaje go do Schowka.
	Delete	Usuwa dynamicznie utworzony formant zawartości z dokumentu i usuwa go z ControlCollection w dokumencie. (Odziedziczone z ContentControlBase).
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Odziedziczone z IDisposable).
	EndInit	Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).
	SetPlaceholderText	Wyświetlany tekst, który znajduje się w BuildingBlock, Range, lub ciąg znaków jako tekstu zastępczego w PlainTextContentControl.

Początek

Zdarzenia

	Nazwa	Opis
	Added	Występuje po dodaniu formantu zawartości do dokumentu. (Odziedziczone z ContentControlBase).
	BindingContextChanged	Występuje, gdy wartość BindingContext właściwość ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed programu Microsoft Office Word tekst w formancie zawartości jest aktualizowany, jeśli formant zawartości jest powiązany niestandardowa część kodu XML. (Odziedziczone z ContentControlBase).
	Deleting	Występuje tuż przed formant zawartości jest usunięte z dokumentu. (Odziedziczone z ContentControlBase).
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	Entering	Występuje, gdy użytkownik kliknie w formancie zawartości lub w przypadku, gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formantu zawartości lub gdy kursor jest przesuwany poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, która jest ograniczona do zawartości kontroli (to znaczy, po tekstu w treści kontrolowania zmian). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości została pomyślnie sprawdzona. (Odziedziczone z ContentControlBase).
	Validating	Występuje, gdy trwa sprawdzanie poprawności zawartości formantu zawartości. (Odziedziczone z ContentControlBase).

Początek

Uwagi

A PlainTextContentControl może zawierać tylko tekst.Można formatować tekst w PlainTextContentControl, ale ma cały tekst w formancie automatycznie, to samo formatowanie.Na przykład, jeśli umożliwia zastosowanie kursywy jednego wyrazu w zdaniu, który znajduje się w PlainTextContentControl, cały tekst wewnątrz formantu jest pisany kursywą.

Do dostępu do tekstu w PlainTextContentControl, użyj Text właściwość.Domyślnie PlainTextContentControl nie mogą zawierać podziałów wierszy.Aby zmienić to zachowanie, użyj MultiLine właściwość.

Aby utworzyć region dokumentu, który może zawierać tekst i wiele innych typów zawartości, w tym tabel, obrazów i innych formantów zawartości, należy użyć RichTextContentControl.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools dla pakietu Office, omówienie Runtime.

Formanty zawartości

PlainTextContentControl Jest jednym z ośmiu typów formantów zawartości, które służą do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartości, że formanty mają interfejs użytkownika (UI) który kontrolował dane tak, jak formularz.Formanty zawartości można użyć, aby uniemożliwić użytkownikom edytowanie chronionych sekcji dokumentu lub szablonu, a formanty zawartości można również powiązać ze źródłem danych.Aby uzyskać więcej informacji, zobacz Formanty zawartości.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Przykłady

Poniższy przykład kodu dodaje nowy PlainTextContentControl do początku dokumentu.

Ta wersja jest dostosowywanie poziomie dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie, a wywołanie AddTextControlAtSelection metodę z ThisDocument_Startup metoda.

Dim plainTextControl1 As Microsoft.Office.Tools.Word.PlainTextContentControl

Private Sub AddPlainTextControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    plainTextControl1 = Me.Controls.AddPlainTextContentControl("plainTextControl1")
    plainTextControl1.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;

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

    textControl1 = this.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}

Ta wersja jest na poziomie aplikacji dodatek.Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie, a wywołanie AddTextControlAtSelection metodę z ThisAddIn_Startup metoda.

Dim plainTextControl1 As Microsoft.Office.Tools.Word.PlainTextContentControl

Private Sub AddPlainTextControlAtSelection()
    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()
    plainTextControl1 = vstoDoc.Controls.AddPlainTextContentControl("plainTextControl1")
    plainTextControl1.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;

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

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

    textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}