WarningType

WarningType enumeration

Specifica il tipo di avviso emesso da Aspose.Words durante il caricamento o il salvataggio del documento.

[Flags]
public enum WarningType

I valori

NomeValoreDescrizione
DataLossCategoryFFParte del testo/carattere/immagine o altri dati mancheranno dall’albero del documento dopo il caricamento, o dal documento creato dopo il salvataggio.
DataLoss1Perdita di dati generica, nessun codice specifico.
MajorFormattingLossCategoryFF00Il documento risultante o una posizione particolare in esso potrebbe apparire sostanzialmente diverso rispetto al documento originale.
MajorFormattingLoss100Grossa perdita di formattazione generica, nessun codice specifico.
MinorFormattingLossCategoryFF0000Il documento risultante o una posizione particolare in esso potrebbe apparire leggermente diversa rispetto al documento originale.
MinorFormattingLoss10000Lieve perdita di formattazione generica, nessun codice specifico.
FontSubstitution20000Il carattere è stato sostituito.
FontEmbedding40000Perdita delle informazioni sui caratteri incorporati durante il salvataggio del documento.
UnexpectedContentCategoryF000000Alcuni contenuti del documento di origine non possono essere riconosciuti (ovvero non sono supportati), ciò potrebbe o meno causare problemi o provocare perdite di dati/formattazione.
UnexpectedContent1000000Contenuto generico imprevisto, nessun codice specifico.
Hint10000000Avverte di un potenziale problema o suggerisce un miglioramento.

Esempi

Mostra come impostare la proprietà per trovare la corrispondenza più vicina per un carattere mancante tra le origini dei caratteri disponibili.

public void EnableFontSubstitution()
{
    // Apre un documento che contiene testo formattato con un carattere che non esiste in nessuna delle nostre fonti di caratteri.
    Document doc = new Document(MyDir + "Missing font.docx");

    // Assegna una richiamata per gestire gli avvisi di sostituzione dei caratteri.
    HandleDocumentSubstitutionWarnings substitutionWarningHandler = new HandleDocumentSubstitutionWarnings();
    doc.WarningCallback = substitutionWarningHandler;

    // Imposta un nome di carattere predefinito e abilita la sostituzione del carattere.
    FontSettings fontSettings = new FontSettings();
    fontSettings.SubstitutionSettings.DefaultFontSubstitution.DefaultFontName = "Arial";
    ;
    fontSettings.SubstitutionSettings.FontInfoSubstitution.Enabled = true;

    // Le metriche dei caratteri originali devono essere utilizzate dopo la sostituzione dei caratteri.
    doc.LayoutOptions.KeepOriginalFontMetrics = true;

    // Riceveremo un avviso di sostituzione del carattere se salviamo un documento con un carattere mancante.
    doc.FontSettings = fontSettings;
    doc.Save(ArtifactsDir + "FontSettings.EnableFontSubstitution.pdf");

    using (IEnumerator<WarningInfo> warnings = substitutionWarningHandler.FontWarnings.GetEnumerator())
        while (warnings.MoveNext())
            Console.WriteLine(warnings.Current.Description);

    // Possiamo anche verificare gli avvisi nella raccolta e cancellarli.
    Assert.AreEqual(WarningSource.Layout, substitutionWarningHandler.FontWarnings[0].Source);
    Assert.AreEqual(
        "Font '28 Days Later' has not been found. Using 'Calibri' font instead. Reason: alternative name from document.",
        substitutionWarningHandler.FontWarnings[0].Description);

    substitutionWarningHandler.FontWarnings.Clear();

    Assert.That(substitutionWarningHandler.FontWarnings, Is.Empty);
}

public class HandleDocumentSubstitutionWarnings : IWarningCallback
{
    /// <summary>
    /// Chiamato ogni volta che si verifica un avviso durante il caricamento/salvataggio.
    /// </summary>
    public void Warning(WarningInfo info)
    {
        if (info.WarningType == WarningType.FontSubstitution)
            FontWarnings.Warning(info);
    }

    public WarningInfoCollection FontWarnings = new WarningInfoCollection();
}

Guarda anche