BuildingBlockCollection
Contenu
[
Cacher
]BuildingBlockCollection class
Une collection deBuildingBlock
objets dans le document.
Pour en savoir plus, visitez leModèle objet de document (DOM) Aspose.Words article documentaire.
public class BuildingBlockCollection : NodeCollection
Propriétés
Nom | La description |
---|---|
Count { get; } | Obtient le nombre de nœuds dans la collection. |
Item { get; } | Récupère un bloc de construction à l’index donné. (2 indexers) |
Méthodes
Nom | La description |
---|---|
Add(Node) | Ajoute un nœud à la fin de la collection. |
Clear() | Supprime tous les nœuds de cette collection et du document. |
Contains(Node) | Détermine si un nœud fait partie de la collection. |
GetEnumerator() | Fournit une simple itération de style “foreach” sur la collection de nœuds. |
IndexOf(Node) | Renvoie l’index de base zéro du nœud spécifié. |
Insert(int, Node) | Insère un nœud dans la collection à l’index spécifié. |
Remove(Node) | Supprime le nœud de la collection et du document. |
RemoveAt(int) | Supprime le nœud à l’index spécifié de la collection et du document. |
ToArray() | Copie tous les blocs de construction de la collection vers un nouveau tableau de blocs de construction. (2 methods) |
Remarques
Vous ne créez pas directement des instances de cette classe. Pour accéder à une collection de blocs de construction, utilisez leBuildingBlocks
propriété.
Exemples
Montre les moyens d’accéder aux blocs de construction dans un document glossaire.
public void GlossaryDocument()
{
Document doc = new Document();
GlossaryDocument glossaryDoc = new GlossaryDocument();
glossaryDoc.AppendChild(new BuildingBlock(glossaryDoc) { Name = "Block 1" });
glossaryDoc.AppendChild(new BuildingBlock(glossaryDoc) { Name = "Block 2" });
glossaryDoc.AppendChild(new BuildingBlock(glossaryDoc) { Name = "Block 3" });
glossaryDoc.AppendChild(new BuildingBlock(glossaryDoc) { Name = "Block 4" });
glossaryDoc.AppendChild(new BuildingBlock(glossaryDoc) { Name = "Block 5" });
Assert.AreEqual(5, glossaryDoc.BuildingBlocks.Count);
doc.GlossaryDocument = glossaryDoc;
// Il existe différentes manières d'accéder aux blocs de construction.
// 1 - Récupère les premier/dernier blocs de construction de la collection :
Assert.AreEqual("Block 1", glossaryDoc.FirstBuildingBlock.Name);
Assert.AreEqual("Block 5", glossaryDoc.LastBuildingBlock.Name);
// 2 - Récupère un bloc de construction par index :
Assert.AreEqual("Block 2", glossaryDoc.BuildingBlocks[1].Name);
Assert.AreEqual("Block 3", glossaryDoc.BuildingBlocks.ToArray()[2].Name);
// 3 - Obtenez le premier bloc de construction qui correspond à une galerie, un nom et une catégorie :
Assert.AreEqual("Block 4",
glossaryDoc.GetBuildingBlock(BuildingBlockGallery.All, "(Empty Category)", "Block 4").Name);
// Nous ferons cela en utilisant un visiteur personnalisé,
// qui donnera à chaque BuildingBlock du GlossaryDocument un GUID unique
GlossaryDocVisitor visitor = new GlossaryDocVisitor();
glossaryDoc.Accept(visitor);
Console.WriteLine(visitor.GetText());
// Dans Microsoft Word, nous pouvons accéder aux blocs de construction via "Insérer" -> "Pièces rapides" -> "Organisateur de blocs de construction".
doc.Save(ArtifactsDir + "BuildingBlocks.GlossaryDocument.dotx");
}
/// <summary>
/// Donne à chaque bloc de construction d'un document de glossaire visité un GUID unique.
/// Stocke les paires de blocs de construction GUID dans un dictionnaire.
/// </summary>
public class GlossaryDocVisitor : DocumentVisitor
{
public GlossaryDocVisitor()
{
mBlocksByGuid = new Dictionary<Guid, BuildingBlock>();
mBuilder = new StringBuilder();
}
public string GetText()
{
return mBuilder.ToString();
}
public Dictionary<Guid, BuildingBlock> GetDictionary()
{
return mBlocksByGuid;
}
public override VisitorAction VisitGlossaryDocumentStart(GlossaryDocument glossary)
{
mBuilder.AppendLine("Glossary document found!");
return VisitorAction.Continue;
}
public override VisitorAction VisitGlossaryDocumentEnd(GlossaryDocument glossary)
{
mBuilder.AppendLine("Reached end of glossary!");
mBuilder.AppendLine("BuildingBlocks found: " + mBlocksByGuid.Count);
return VisitorAction.Continue;
}
public override VisitorAction VisitBuildingBlockStart(BuildingBlock block)
{
block.Guid = Guid.NewGuid();
mBlocksByGuid.Add(block.Guid, block);
return VisitorAction.Continue;
}
public override VisitorAction VisitBuildingBlockEnd(BuildingBlock block)
{
mBuilder.AppendLine("\tVisited block \"" + block.Name + "\"");
mBuilder.AppendLine("\t Type: " + block.Type);
mBuilder.AppendLine("\t Gallery: " + block.Gallery);
mBuilder.AppendLine("\t Behavior: " + block.Behavior);
mBuilder.AppendLine("\t Description: " + block.Description);
return VisitorAction.Continue;
}
private readonly Dictionary<Guid, BuildingBlock> mBlocksByGuid;
private readonly StringBuilder mBuilder;
}
Voir également
- class NodeCollection
- espace de noms Aspose.Words.BuildingBlocks
- Assemblée Aspose.Words