FieldAutoNumLgl
Contenuti
[
Nascondere
]FieldAutoNumLgl class
Implementa il campo AUTONUMLGL.
Per saperne di più, visita ilLavorare con i campi articolo di documentazione.
public class FieldAutoNumLgl : Field
Costruttori
Nome | Descrizione |
---|---|
FieldAutoNumLgl() | Default_Costruttore |
Proprietà
Nome | Descrizione |
---|---|
DisplayResult { get; } | Ottiene il testo che rappresenta il risultato del campo visualizzato. |
End { get; } | Ottiene il nodo che rappresenta la fine del campo. |
Format { get; } | Ottiene aFieldFormat oggetto che fornisce accesso digitato alla formattazione del campo. |
IsDirty { get; set; } | Ottiene o imposta se il risultato corrente del campo non è più corretto (obsoleto) a causa di altre modifiche apportate al documento. |
IsLocked { get; set; } | Ottiene o imposta se il campo è bloccato (non deve ricalcolare il risultato). |
LocaleId { get; set; } | Ottiene o imposta l’LCID del campo. |
RemoveTrailingPeriod { get; set; } | Ottiene o imposta se visualizzare il numero senza punto finale. |
Result { get; set; } | Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo. |
Separator { get; } | Ottiene il nodo che rappresenta il separatore di campo. Può esserenullo . |
SeparatorCharacter { get; set; } | Ottiene o imposta il carattere separatore da utilizzare. |
Start { get; } | Ottiene il nodo che rappresenta l’inizio del campo. |
virtual Type { get; } | Ottiene il tipo di campo Microsoft Word. |
Metodi
Nome | Descrizione |
---|---|
GetFieldCode() | Restituisce il testo compreso tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi secondari. |
GetFieldCode(bool) | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). |
Remove() | Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo figlio del suo nodo genitore, restituisce il paragrafo genitore. Se il campo è già stato rimosso, restituiscenullo . |
Unlink() | Esegue lo scollegamento del campo. |
Update() | Esegue l’aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento. |
Update(bool) | Esegue un aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento. |
Osservazioni
Inserisce un numero automatico in formato legale.
Esempi
Mostra come organizzare un documento utilizzando i campi AUTONUMLGL.
public void FieldAutoNumLgl()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
const string fillerText = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. " +
"\nUt enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. ";
// I campi AUTONUMLGL visualizzano un numero che aumenta in ciascun campo AUTONUMLGL all'interno del livello di intestazione corrente.
// Questi campi mantengono un conteggio separato per ciascun livello di intestazione,
// e ciascun campo visualizza anche i conteggi del campo AUTONUMLGL per tutti i livelli di intestazione inferiori al proprio.
// La modifica del conteggio per qualsiasi livello di intestazione reimposta su 1 i conteggi per tutti i livelli superiori a quel livello.
// Questo ci consente di organizzare il nostro documento sotto forma di un elenco schematico.
// Questo è il primo campo AUTONUMLGL al livello di intestazione 1, che visualizza "1." nel documento.
InsertNumberedClause(builder, "\tHeading 1", fillerText, StyleIdentifier.Heading1);
// Questo è il secondo campo AUTONUMLGL al livello di intestazione 1, quindi verrà visualizzato "2.".
InsertNumberedClause(builder, "\tHeading 2", fillerText, StyleIdentifier.Heading1);
// Questo è il primo campo AUTONUMLGL al livello di intestazione 2,
// e il conteggio AUTONUMLGL per il livello di intestazione sottostante è "2", quindi verrà visualizzato "2.1.".
InsertNumberedClause(builder, "\tHeading 3", fillerText, StyleIdentifier.Heading2);
// Questo è il primo campo AUTONUMLGL al livello di intestazione 3.
// Funzionando allo stesso modo del campo precedente, verrà visualizzato "2.1.1.".
InsertNumberedClause(builder, "\tHeading 4", fillerText, StyleIdentifier.Heading3);
// Questo campo è al livello di intestazione 2 e il suo rispettivo conteggio AUTONUMLGL è 2, quindi il campo visualizzerà "2.2.".
InsertNumberedClause(builder, "\tHeading 5", fillerText, StyleIdentifier.Heading2);
// Incremento del conteggio AUTONUMLGL per un livello di intestazione inferiore a questo
// ha reimpostato il conteggio per questo livello in modo che questo campo visualizzi "2.2.1.".
InsertNumberedClause(builder, "\tHeading 6", fillerText, StyleIdentifier.Heading3);
foreach (FieldAutoNumLgl field in doc.Range.Fields.Where(f => f.Type == FieldType.FieldAutoNumLegal))
{
// Il carattere separatore, che appare nel campo risultato immediatamente dopo il numero,
// è un punto per impostazione predefinita. Se lasciamo questa proprietà nulla,
// il nostro ultimo campo AUTONUMLGL visualizzerà "2.2.1." nel documento.
Assert.IsNull(field.SeparatorCharacter);
// Impostazione di un carattere separatore personalizzato e rimozione del punto finale
// cambierà l'aspetto di quel campo da "2.2.1." a "2:2:1".
// Lo applicheremo a tutti i campi che abbiamo creato.
field.SeparatorCharacter = ":";
field.RemoveTrailingPeriod = true;
Assert.AreEqual(" AUTONUMLGL \\s : \\e", field.GetFieldCode());
}
doc.Save(ArtifactsDir + "Field.AUTONUMLGL.docx");
}
/// <summary>
/// Utilizza un generatore di documenti per inserire una clausola numerata da un campo AUTONUMLGL.
/// </summary>
private static void InsertNumberedClause(DocumentBuilder builder, string heading, string contents, StyleIdentifier headingStyle)
{
builder.InsertField(FieldType.FieldAutoNumLegal, true);
builder.CurrentParagraph.ParagraphFormat.StyleIdentifier = headingStyle;
builder.Writeln(heading);
// Questo testo apparterrà al campo legale auto num sopra di esso.
// Collasserà quando si fa clic sulla freccia accanto al campo AUTONUMLGL corrispondente in Microsoft Word.
builder.CurrentParagraph.ParagraphFormat.StyleIdentifier = StyleIdentifier.BodyText;
builder.Writeln(contents);
}
Guarda anche
- class Field
- spazio dei nomi Aspose.Words.Fields
- assemblea Aspose.Words