TextFragment

TextFragment class

Représente un fragment de texte Pdf.

public class TextFragment : BaseParagraph

Constructeurs

NomLa description
TextFragment()Initialise la nouvelle instance duTextFragment objet.
TextFragment(string)CréeTextFragment objet avec un seulTextSegment objet à l’intérieur. Spécifie la chaîne de texte à l’intérieur du segment.
TextFragment(TabStops)Initialise la nouvelle instance duTextFragment objet avec prédéfiniTabStops positions.
TextFragment(string, TabStops)CréeTextFragment objet avec un seulTextSegment objet à l’intérieur et prédéfiniTabStops positions.

Propriétés

NomLa description
BaselinePosition { get; set; }Obtient la position du texte pour le texte, représenté parTextFragment object. L’YIndent de la structure Position représente la coordonnée de base du fragment de texte.
EndNote { get; set; }Obtient ou définit la note de fin de paragraphe. (pour la génération de pdf uniquement)
FootNote { get; set; }Obtient ou définit la note de bas de paragraphe. (pour la génération de pdf uniquement)
Form { get; }Obtient l’objet de formulaire qui contient le TextFragment
override HorizontalAlignment { get; set; }Obtient ou définit un alignement horizontal du fragment de texte.
override Hyperlink { set; }Définit le lien hypertexte fragment
IsFirstParagraphInColumn { get; set; }Obtient ou définit une valeur booléenne qui indique si ce paragraphe sera dans la colonne suivante. La valeur par défaut est false.(for pdf generation)
IsInLineParagraph { get; set; }Obtient ou définit qu’un paragraphe est en ligne. La valeur par défaut est false.(pour la génération de pdf)
IsInNewPage { get; set; }Obtient ou définit une valeur booléenne qui force la génération de ce paragraphe sur une nouvelle page. La valeur par défaut est false.(for pdf generation)
IsKeptWithNext { get; set; }Obtient ou définit une valeur booléenne qui indique si le paragraphe actuel reste dans la même page avec le paragraphe suivant. La valeur par défaut est false.(for pdf generation)
Margin { get; set; }Obtient ou définit une marge extérieure pour le paragraphe (pour la génération de pdf)
Page { get; }Obtient la page qui contient le TextFragment
Position { get; set; }Obtient ou définit la position du texte pour le texte, représenté parTextFragment objet.
Rectangle { get; }Récupère le rectangle du TextFragment
ReplaceOptions { get; }Obtient les options de remplacement de texte. Les options définissent le comportement lorsque le texte fragmenté est remplacé par un texte plus court/long.
Segments { get; set; }Obtient les segments de texte pour le courantTextFragment .
Text { get; set; }Obtient ou définitString objet texte que leTextFragment l’objet représente.
TextState { get; }Obtient ou définit l’état du texte pour le texte quiTextFragment l’objet représente.
override VerticalAlignment { get; set; }Obtient ou définit un alignement vertical du fragment de texte.
WrapLinesCount { get; set; }Obtient ou définit le nombre de lignes d’habillage pour ce paragraphe (pour la génération de pdf uniquement)
ZIndex { get; set; }Obtient ou définit une valeur int qui indique l’ordre Z du graphique. Un graphique avec un ZIndex plus grand sera placé sur le graphique avec un ZIndex plus petit. ZIndex peut être négatif. Le graphique avec ZIndex négatif sera placé derrière le texte dans la page.

Méthodes

NomLa description
override Clone()Clonez le fragment.
virtual CloneWithSegments()Cloner le fragment avec tous les segments.
IsolateTextSegments(int, int)ObtientTextSegment (s) représentant une partie spécifiée duTextFragment texte.

Remarques

En quelques mots,TextFragment l’objet contient une liste deTextSegment objects. En détails : Texte du document pdf dansPdf est représenté par deux objets de base :TextFragment etTextSegment Les différences entre eux dépendent principalement du contexte. Considérons le scénario suivant. L’utilisateur recherche le texte “hello world” pour l’utiliser, modifier ses propriétés, etc. Physiquement, la représentation du texte pdf est très complexe. Le texte “hello world” peut être composé de plusieurs segments de texte physiquement indépendants. Le modèle de texte Aspose.Pdf établit essentiellement queTextFragment object fournit une opération logique unique définie sur physiqueTextSegment ensemble d’objets qui représentent la requête de l’utilisateur. Dans le scénario de recherche de texte,TextFragment est une représentation textuelle logique “hello world”, etTextSegmentla collection d’objets représente tous les segments physiques qui construisent l’objet texte “hello world”. Donc,TextFragment est proche de la représentation logique du texte. EtTextSegment est proche de la représentation textuelle physique. Évidemment, chaqueTextSegment l’objet peut avoir ses propres propriétés de police, de coloration et de positionnement. TextFragment fournit un moyen simple de modifier le texte avec ses propriétés : définir la police, définir la taille de la police, définir la couleur de la police, etc. TextSegment les objets sont accessibles et les utilisateurs peuvent opérer avecTextSegment objets indépendamment. Notez que la modification des propriétés TextFragment peut modifierSegments car TextFragment est un objet agrégé et il peut réorganiser les segments internes ou les fusionner en un seul segment. Si votre exigence est de quitter leSegmentscollection inchangée, veuillez modifier les segments internes individuellement.

Document doc = new Document(docFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
doc.Pages[1].Accept(absorber);

Exemples

L’exemple montre comment rechercher du texte sur la première page du document PDF et remplacer le texte et sa police.

// Ouvrir le document
Document doc = new Document(@"D:\Tests\input.pdf");

// Trouve la police qui sera utilisée pour changer la police du texte du document
Aspose.Pdf.Txt.Font font = FontRepository.FindFont("Arial");

// Crée un objet TextFragmentAbsorber pour trouver toutes les occurrences de texte "hello world"
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

// Accepte l'absorbeur pour la première page
doc.Pages[1].Accept(absorber);

// Changer le texte et la police de la première occurrence de texte
absorber.TextFragments[1].Text = "hi world";
absorber.TextFragments[1].TextState.Font = font;

// Enregistrer le document
doc.Save(@"D:\Tests\output.pdf");  

Voir également