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 de documentation.

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 une mise à jour manuelle du document ou une reconstruction de la mise en page.
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 ê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 que couvre le nœud spécifié. 0 si le nœud se trouve dans une seule page. Ceci est identique à`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 être mappé à une page.

Remarques

Lorsque vous créez unLayoutCollector et spécifiez unDocumentobjet de document auquel s’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 ligne, un paragraphe ou une cellule de tableau) en utilisant leGetStartPageIndex ,GetEndPageIndex etGetNumPagesSpanned mé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 voir les plages de pages qu’un nœud couvre.

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

// Appelez la méthode « GetNumPagesSpanned » pour compter le nombre de pages sur lesquelles s'étend le contenu de notre document.
// Étant donné que le document est vide, ce nombre de pages est actuellement nul.
Assert.AreEqual(doc, layoutCollector.Document);
Assert.AreEqual(0, layoutCollector.GetNumPagesSpanned(doc));

// Remplissez 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 mesure 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 de pages globales.
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