Interfejs PlainTextContentControl

Artykuł
01/08/2014

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 reprezentująca 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	Pobiera całkowita 32-bitowa, wskazująca aplikacji, w której 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, który identyfikuje formant zawartości. (Odziedziczone z ContentControlBase).
	InnerObject	Pobiera podstawowych Microsoft.Office.Interop.Word.ContentControl dla obiektu Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość określająca, czy PlainTextContentControl może być usunięty z dokumentu.
	LockContents	Pobiera lub ustawia wartość, która określa, czy zawartość PlainTextContentControl mogą być edytowane.
	MultiLine	Pobiera lub ustawia wartość określająca, czy PlainTextContentControl mogą zawierać podziałów wierszy.
	Parent	Pobiera element nadrzędny z PlainTextContentControl.
	ParentContentControl	Pobiera nadrzędnego 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 w PlainTextContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub innej operacji.
	Range	Pobiera Range reprezentująca zawartość PlainTextContentControl.
	ShowingPlaceholderText	Pobiera wartość, która określa, czy PlainTextContentControl jest obecnie wyświetlanie tekstu zastępczego.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który ma być skojarzony z PlainTextContentControl.
	Temporary	Pobiera lub ustawia wartość określająca, czy PlainTextContentControl jest automatycznie usuwany z dokumentu podczas edycji formantu.
	Text	Pobiera lub ustawia tekst w PlainTextContentControl.
	Title	Pobiera lub ustawia tytuł PlainTextContentControl.
	XMLMapping	Pobiera XMLMapping reprezentująca 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 przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable).
	EndInit	Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).
	SetPlaceholderText	Wyświetla 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ści ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed tekstu w formancie zawartości, aktualizacje programu Microsoft Office Word, jeśli niestandardowa część kodu XML jest powiązany formant zawartości. (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 przycisk w formancie zawartości lub gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formant zawartości lub gdy kursor zostanie przeniesiony poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, powiązaną z zawartością sterowania (po tekstu w treści kontrolować zmiany). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości został pomyślnie sprawdzony. (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 cały tekst w formancie automatycznie ma to samo formatowanie.Na przykład, jeśli kursywy jeden wyraz zdania, który znajduje się w PlainTextContentControl, cały tekst wewnątrz formantu jest pisany kursywą.

Aby dostęp 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ć obszar 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 for Office Runtime ― Przegląd.

Formanty zawartości

PlainTextContentControl Jest jednym z ośmiu typów formantów zawartości, których można użyć do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartość formantów ma interfejs użytkownika (UI) który kontrolował wprowadzania, np.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 kod dodaje nowy PlainTextContentControl do początku dokumentu.

Ta wersja jest dla dostosowania poziomu dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołanie AddTextControlAtSelection metodę z ThisDocument_Startup metody.

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 i wywołanie AddTextControlAtSelection metodę z ThisAddIn_Startup metody.

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