LayoutCollector

LayoutCollector class

Cette classe permet de calculer les numéros de page des nœuds du document.

Pour en savoir plus, visitez leConversion au format de page fixe article documentaire.

public class LayoutCollector

Constructeurs

Nom	La description
LayoutCollector(Document)	Initialise une instance de cette classe.

Propriétés

Nom	La description
Document { get; set; }	Obtient ou définit le document auquel cette instance de collecteur est attachée.

Méthodes

Nom	La description
Clear()	Efface toutes les données de mise en page collectées. Appelez cette méthode après que le document a été mis à jour manuellement ou que la mise en page a été reconstruite.
GetEndPageIndex(Node)	Obtient l’index de base 1 de la page où se termine le nœud. Renvoie 0 si le nœud ne peut pas être mappé à une page.
GetEntity(Node)	Renvoie une position opaque du`LayoutEnumerator` qui correspond au nœud spécifié. Vous pouvez utiliser la valeur renvoyée comme argument pour`Current` étant donné que le document étant énuméré et le document du nœud sont les mêmes.
GetNumPagesSpanned(Node)	Obtient le nombre de pages couvertes par le nœud spécifié. 0 si le nœud se trouve dans une seule page. C’est la même chose que`GetEndPageIndex` -`GetStartPageIndex` .
GetStartPageIndex(Node)	Obtient l’index de base 1 de la page où commence le nœud. Renvoie 0 si le nœud ne peut pas être mappé à une page.

Remarques

Lorsque vous créez unLayoutCollector et précisez unDocument objet de document auquel attacher, le collecteur enregistrera le mappage des nœuds de document aux objets de mise en page lorsque le document est formaté en pages.

Vous pourrez savoir sur quelle page se trouve un nœud de document particulier (par exemple une séquence, un paragraphe ou une cellule de tableau) en utilisant leGetStartPageIndex ,GetEndPageIndex etGetNumPagesSpannedméthodes. Ces méthodes créent automatiquement le modèle de mise en page du document et mettent à jour les champs si nécessaire.

Lorsque vous n’avez plus besoin de collecter des informations de mise en page, il est préférable de définir leDocument propriété ànul pour éviter la collecte inutile de mappages de mise en page supplémentaires.

Exemples

Montre comment afficher les plages de pages couvertes par un nœud.

Document doc = new Document();
LayoutCollector layoutCollector = new LayoutCollector(doc);

// Appelez la méthode "GetNumPagesSpanned" pour compter le nombre de pages que couvre le contenu de notre document.
// Puisque le document est vide, ce nombre de pages est actuellement nul.
Assert.AreEqual(doc, layoutCollector.Document);
Assert.AreEqual(0, layoutCollector.GetNumPagesSpanned(doc));

// Remplit le document avec 5 pages de contenu.
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Section 1");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.SectionBreakEvenPage);
builder.Write("Section 2");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);

// Avant le collecteur de mise en page, nous devons appeler la méthode "UpdatePageLayout" pour nous donner
// un chiffre précis pour toute métrique liée à la mise en page, telle que le nombre de pages.
Assert.AreEqual(0, layoutCollector.GetNumPagesSpanned(doc));

layoutCollector.Clear();
doc.UpdatePageLayout();

Assert.AreEqual(5, layoutCollector.GetNumPagesSpanned(doc));

// Nous pouvons voir les numéros des pages de début et de fin de n'importe quel nœud et leurs étendues globales de pages.
NodeCollection nodes = doc.GetChildNodes(NodeType.Any, true);
foreach (Node node in nodes)
{
    Console.WriteLine($"->  NodeType.{node.NodeType}: ");
    Console.WriteLine(
        $"\tStarts on page {layoutCollector.GetStartPageIndex(node)}, ends on page {layoutCollector.GetEndPageIndex(node)}," +
        $" spanning {layoutCollector.GetNumPagesSpanned(node)} pages.");
}

// Nous pouvons parcourir les entités de mise en page à l'aide d'un LayoutEnumerator.
LayoutEnumerator layoutEnumerator = new LayoutEnumerator(doc);

Assert.AreEqual(LayoutEntityType.Page, layoutEnumerator.Type);

// Le LayoutEnumerator peut parcourir la collection d'entités de mise en page comme un arbre.
// Nous pouvons également l'appliquer à l'entité de mise en page correspondante de n'importe quel nœud.
layoutEnumerator.Current = layoutCollector.GetEntity(doc.GetChild(NodeType.Paragraph, 1, true));

Assert.AreEqual(LayoutEntityType.Span, layoutEnumerator.Type);
Assert.AreEqual("¶", layoutEnumerator.Text);

Voir également

espace de noms Aspose.Words.Layout
Assemblée Aspose.Words

IPageLayoutCallback Interface LayoutEntityType Enum