ShortCitation
Contenu
[
Cacher
]FieldTA.ShortCitation property
Obtient ou définit la courte citation de l’entrée.
public string ShortCitation { get; set; }
Exemples
Montre comment créer et personnaliser une table de autorités à l’aide des champs TOA et TA.
public void FieldTOA()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insère un champ TOA, qui créera une entrée pour chaque champ TA du document,
// affichant de longues citations et des numéros de page pour chaque entrée.
FieldToa fieldToa = (FieldToa)builder.InsertField(FieldType.FieldTOA, false);
// Définit la catégorie d'entrée pour notre table. Ce TOA n'inclura désormais que les champs TA
// qui ont une valeur correspondante dans leur propriété EntryCategory.
fieldToa.EntryCategory = "1";
// De plus, la catégorie Table of Authorities à l'index 1 est "Cas",
// qui apparaîtra comme titre de notre table si nous définissons cette variable sur true.
fieldToa.UseHeading = true;
// Nous pouvons filtrer davantage les champs TA en nommant un signet dont ils devront se trouver dans les limites du TOA.
fieldToa.BookmarkName = "MyBookmark";
// Par défaut, un onglet en pointillé sur toute la page apparaît entre la citation du champ TA
// et son numéro de page. Nous pouvons le remplacer par n'importe quel texte que nous mettons sur cette propriété.
// L'insertion d'un caractère de tabulation conservera la tabulation d'origine.
fieldToa.EntrySeparator = " \t p.";
// Si nous avons plusieurs entrées TA partageant la même longue citation,
// tous leurs numéros de page respectifs apparaîtront sur une seule ligne.
// Nous pouvons utiliser cette propriété pour spécifier une chaîne qui séparera leurs numéros de page.
fieldToa.PageNumberListSeparator = " & p. ";
// Nous pouvons définir cela sur true pour que notre table affiche le mot "passim"
// s'il y a cinq numéros de page ou plus sur une ligne.
fieldToa.UsePassim = true;
// Un champ TA peut faire référence à une plage de pages.
// Nous pouvons spécifier ici une chaîne qui apparaîtra entre les numéros de page de début et de fin pour ces plages.
fieldToa.PageRangeSeparator = " to ";
// Le format des champs TA sera reporté dans notre table.
// Nous pouvons désactiver cela en définissant l'indicateur RemoveEntryFormatting.
fieldToa.RemoveEntryFormatting = true;
builder.Font.Color = Color.Green;
builder.Font.Name = "Arial Black";
Assert.AreEqual(" TOA \\c 1 \\h \\b MyBookmark \\e \" \t p.\" \\l \" & p. \" \\p \\g \" to \" \\f", fieldToa.GetFieldCode());
builder.InsertBreak(BreakType.PageBreak);
// Ce champ TA n'apparaîtra pas comme une entrée dans le TOA puisqu'il est en dehors
// les limites du signet spécifiées par la propriété BookmarkName du TOA.
FieldTA fieldTA = InsertToaEntry(builder, "1", "Source 1");
Assert.AreEqual(" TA \\c 1 \\l \"Source 1\"", fieldTA.GetFieldCode());
// Ce champ TA est à l'intérieur du signet,
// mais la catégorie de l'entrée ne correspond pas à celle de la table, donc le champ TA ne l'inclura pas.
builder.StartBookmark("MyBookmark");
fieldTA = InsertToaEntry(builder, "2", "Source 2");
// Cette entrée apparaîtra dans le tableau.
fieldTA = InsertToaEntry(builder, "1", "Source 3");
// Un tableau TOA n'affiche pas les citations courtes,
// mais nous pouvons les utiliser comme raccourci pour faire référence à des noms de sources volumineux référencés par plusieurs champs TA.
fieldTA.ShortCitation = "S.3";
Assert.AreEqual(" TA \\c 1 \\l \"Source 3\" \\s S.3", fieldTA.GetFieldCode());
// Nous pouvons formater le numéro de page pour le mettre en gras/italique en utilisant les propriétés suivantes.
// Nous verrons toujours ces effets si nous configurons notre table pour qu'elle ignore le formatage.
fieldTA = InsertToaEntry(builder, "1", "Source 2");
fieldTA.IsBold = true;
fieldTA.IsItalic = true;
Assert.AreEqual(" TA \\c 1 \\l \"Source 2\" \\b \\i", fieldTA.GetFieldCode());
// Nous pouvons configurer les champs TA pour que leurs entrées TOA fassent référence à une plage de pages traversées par un signet.
// Notez que cette entrée fait référence à la même source que celle ci-dessus pour partager une ligne de notre tableau.
// Cette ligne aura le numéro de page de l'entrée ci-dessus et la plage de pages de cette entrée,
// avec la liste des pages du tableau et les séparateurs de plage de numéros de page entre les numéros de page.
fieldTA = InsertToaEntry(builder, "1", "Source 3");
fieldTA.PageRangeBookmarkName = "MyMultiPageBookmark";
builder.StartBookmark("MyMultiPageBookmark");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
builder.EndBookmark("MyMultiPageBookmark");
Assert.AreEqual(" TA \\c 1 \\l \"Source 3\" \\r MyMultiPageBookmark", fieldTA.GetFieldCode());
// Si nous avons activé la fonctionnalité "Passim" de notre table, avoir 5 entrées TA ou plus avec la même source l'invoquera.
for (int i = 0; i < 5; i++)
{
InsertToaEntry(builder, "1", "Source 4");
}
builder.EndBookmark("MyBookmark");
doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.TOA.TA.docx");
}
private static FieldTA InsertToaEntry(DocumentBuilder builder, string entryCategory, string longCitation)
{
FieldTA field = (FieldTA)builder.InsertField(FieldType.FieldTOAEntry, false);
field.EntryCategory = entryCategory;
field.LongCitation = longCitation;
builder.InsertBreak(BreakType.PageBreak);
return field;
}
Voir également
- class FieldTA
- espace de noms Aspose.Words.Fields
- Assemblée Aspose.Words