TextFragment
TextFragment class
Stellt ein Fragment des PDF-Textes dar.
public class TextFragment : BaseParagraph
Konstrukteure
Name | Beschreibung |
---|---|
TextFragment() | Initialisiert eine neue Instanz vonTextFragment Objekt. |
TextFragment(string) | erstelltTextFragment Objekt mit SingleTextSegment Objekt drin. Gibt die Textzeichenfolge innerhalb des Segments an. |
TextFragment(TabStops) | Initialisiert eine neue Instanz vonTextFragment Objekt mit vordefiniertenTabStops Positionen. |
TextFragment(string, TabStops) | erstelltTextFragment Objekt mit SingleTextSegment Objekt innerhalb und vordefiniertTabStops Positionen. |
Eigenschaften
Name | Beschreibung |
---|---|
BaselinePosition { get; set; } | Ruft Textposition für Text ab, dargestellt mitTextFragment object. Der YIndent der Positionsstruktur stellt die Basiskoordinate des Textfragments dar. |
EndNote { get; set; } | Ruft die Endnote des Absatzes ab oder legt sie fest. (Nur für PDF-Generierung) |
FootNote { get; set; } | Ruft die Fußnote des Absatzes ab oder legt sie fest. (Nur für PDF-Generierung) |
Form { get; } | Ruft das Formularobjekt ab, das das TextFragment enthält |
override HorizontalAlignment { get; set; } | Holt oder setzt eine horizontale Ausrichtung des Textfragments. |
override Hyperlink { set; } | Setzt das Fragment hyperlink |
IsFirstParagraphInColumn { get; set; } | Ruft einen Bool-Wert ab oder legt ihn fest, der angibt, ob dieser Absatz in der nächsten Spalte steht. Standard ist „false“.(für PDF-Generierung) |
IsInLineParagraph { get; set; } | Ruft ab oder legt fest, dass ein Absatz inline ist. Standard ist „false“.(für PDF-Generierung) |
IsInNewPage { get; set; } | Ruft einen Bool-Wert ab oder legt ihn fest, der erzwingt, dass dieser Absatz auf einer neuen Seite generiert wird. Der Standardwert ist falsch. (für die PDF-Generierung) |
IsKeptWithNext { get; set; } | Ruft einen Bool-Wert ab oder legt ihn fest, der angibt, ob der aktuelle Absatz zusammen mit dem nächsten Absatz auf derselben Seite verbleibt. Der Standardwert ist „false“. (für die PDF-Generierung) |
Margin { get; set; } | Liest oder setzt einen Außenrand für Absatz (für PDF-Generierung) |
Page { get; } | Ruft Seite ab, die das TextFragment enthält |
Position { get; set; } | Ermittelt oder setzt die Textposition für Text, dargestellt durchTextFragment Objekt. |
Rectangle { get; } | Ruft Rechteck des TextFragments ab |
ReplaceOptions { get; } | Ruft Textersetzungsoptionen ab. Die Optionen definieren das Verhalten, wenn Fragmenttext durch kürzeren/langen ersetzt wird. |
Segments { get; set; } | Ruft Textsegmente für Strom abTextFragment . |
Text { get; set; } | Holt oder setztString Textobjekt, das dieTextFragment Objekt repräsentiert. |
TextState { get; } | Ermittelt oder setzt den Textstatus für den Text, derTextFragment Objekt repräsentiert. |
override VerticalAlignment { get; set; } | Holt oder setzt eine vertikale Ausrichtung des Textfragments. |
WrapLinesCount { get; set; } | Ruft die Anzahl der Umbruchzeilen für diesen Absatz ab oder legt sie fest (nur für die PDF-Generierung) |
ZIndex { get; set; } | Ruft einen int-Wert ab oder legt ihn fest, der die Z-Reihenfolge des Diagramms angibt. Ein Graph mit größerem ZIndex wird über dem Graphen mit kleinerem ZIndex platziert. ZIndex kann negativ sein. Grafik mit negativem ZIndex wird hinter dem Text auf der Seite platziert. |
Methoden
Name | Beschreibung |
---|---|
override Clone() | Klonen Sie das Fragment. |
virtual CloneWithSegments() | Klonen Sie das Fragment mit allen Segmenten. |
IsolateTextSegments(int, int) | erhältTextSegment (s) repräsentiert einen bestimmten Teil derTextFragment text. |
Bemerkungen
In wenigen Worten,TextFragment
Objekt enthält Liste vonTextSegment
Objekte. Im Detail: Text des PDF-Dokuments inPdf wird durch zwei grundlegende Objekte dargestellt:TextFragment
undTextSegment
Die Unterschiede zwischen ihnen sind größtenteils kontextabhängig. Betrachten wir folgendes Szenario. Der Benutzer sucht nach dem Text „Hello World“, um damit zu arbeiten, seine Eigenschaften zu ändern, umzusehen usw. Physikalisch ist die Darstellung von PDF-Texten sehr komplex. Der Text “Hallo Welt” kann aus mehreren physikalisch unabhängigen Textsegmenten bestehen. Das Aspose.Pdf-Textmodell stellt dies grundsätzlich herTextFragment
object bietet eine einzelne logische Operation, die über physisch gesetzt wirdTextSegment
Objektsatz, der die Abfrage des Benutzers darstellt. Im TextsuchszenarioTextFragment
ist eine logische “Hallo Welt”-Textdarstellung, undTextSegment
Die Objektsammlung stellt alle physischen Segmente dar, die das Textobjekt „Hallo Welt“ bilden. Also,TextFragment
ist der logischen Textdarstellung nahe. UndTextSegment
ist nah an der physischen Textdarstellung. Offensichtlich jederTextSegment
Objekt kann seine eigene Schriftart, Farbgebung und Positionierungseigenschaften haben. TextFragment
bietet eine einfache Möglichkeit, Text mit seinen Eigenschaften zu ändern: Schriftart festlegen, Schriftgröße festlegen, Schriftfarbe festlegen usw. InzwischenTextSegment
Objekte sind zugänglich und Benutzer können damit arbeitenTextSegment
Objekte unabhängig. Beachten Sie, dass das Ändern von TextFragment-Eigenschaften innere ändern kannSegments
Sammlung, da TextFragment ein aggregiertes Objekt ist und interne Segmente neu anordnen oder zu einem einzigen Segment zusammenführen kann. Wenn Sie die verlassen möchtenSegments
Kollektion unverändert, Innensegmente bitte individuell ändern.
Document doc = new Document(docFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
doc.Pages[1].Accept(absorber);
Beispiele
Das Beispiel zeigt, wie Sie Text auf der ersten PDF-Dokumentseite finden und den Text und seine Schriftart ersetzen.
// Dokument öffnen
Document doc = new Document(@"D:\Tests\input.pdf");
// Schriftart finden, die verwendet wird, um die Schriftart des Dokumenttexts zu ändern
Aspose.Pdf.Txt.Font font = FontRepository.FindFont("Arial");
// TextFragmentAbsorber-Objekt erstellen, um alle "Hello World"-Textvorkommen zu finden
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
// Akzeptiere den Absorber für die erste Seite
doc.Pages[1].Accept(absorber);
// Text und Schriftart des ersten Textvorkommens ändern
absorber.TextFragments[1].Text = "hi world";
absorber.TextFragments[1].TextState.Font = font;
// Dokument speichern
doc.Save(@"D:\Tests\output.pdf");
Siehe auch
- class BaseParagraph
- namensraum Aspose.Pdf.Text
- Montage Aspose.PDF