public static void Run()
{
//ExStart:SetFontsFoldersSystemAndCustomFolder
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_RenderingAndPrinting();
Document doc = new Document(dataDir + "Rendering.doc");
FontSettings FontSettings = new FontSettings();
// Retrieve the array of environment-dependent font sources that are searched by default. For example this will contain a "Windows\Fonts\" source on a Windows machines.
// We add this array to a new ArrayList to make adding or removing font entries much easier.
ArrayList fontSources = new ArrayList(FontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource("C:\\MyFonts\\", true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
// Convert the Arraylist of source back into a primitive array of FontSource objects.
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
// Apply the new set of font sources to use.
FontSettings.SetFontsSources(updatedFontSources);
dataDir = dataDir + "Rendering.SetFontsFolders_out_.pdf";
doc.Save(dataDir);
//ExEnd:SetFontsFoldersSystemAndCustomFolder
Console.WriteLine("\nFonts system and coustom folder is setup.\nFile saved at " + dataDir);
}
public static void GetListOfAvailableFonts(string dataDir)
{
// ExStart:GetListOfAvailableFonts
// The path to the documents directory.
Document doc = new Document(dataDir + "TestFile.docx");
FontSettings fontSettings = new FontSettings();
ArrayList fontSources = new ArrayList(fontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource(dataDir, true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
// Convert the Arraylist of source back into a primitive array of FontSource objects.
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
foreach (PhysicalFontInfo fontInfo in updatedFontSources[0].GetAvailableFonts())
{
Console.WriteLine("FontFamilyName : " + fontInfo.FontFamilyName);
Console.WriteLine("FullFontName : " + fontInfo.FullFontName);
Console.WriteLine("Version : " + fontInfo.Version);
Console.WriteLine("FilePath : " + fontInfo.FilePath);
}
// ExEnd:GetListOfAvailableFonts
}
public void SetFontsFoldersSystemAndCustomFolder()
{
//ExStart:SetFontsFoldersSystemAndCustomFolder
Document doc = new Document(MyDir + "Rendering.docx");
FontSettings fontSettings = new FontSettings();
// Retrieve the array of environment-dependent font sources that are searched by default.
// For example this will contain a "Windows\Fonts\" source on a Windows machines.
// We add this array to a new ArrayList to make adding or removing font entries much easier.
ArrayList fontSources = new ArrayList(fontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource("C:\\MyFonts\\", true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
fontSettings.SetFontsSources(updatedFontSources);
doc.FontSettings = fontSettings;
doc.Save(ArtifactsDir + "WorkingWithFonts.SetFontsFoldersSystemAndCustomFolder.pdf");
//ExEnd:SetFontsFoldersSystemAndCustomFolder
}
public static void Run()
{
// ExStart:SetFontsFoldersSystemAndCustomFolder
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_RenderingAndPrinting();
Document doc = new Document(dataDir + "Rendering.doc");
FontSettings FontSettings = new FontSettings();
// Retrieve the array of environment-dependent font sources that are searched by default. For example this will contain a "Windows\Fonts\" source on a Windows machines.
// We add this array to a new ArrayList to make adding or removing font entries much easier.
ArrayList fontSources = new ArrayList(FontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource("C:\\MyFonts\\", true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
// Convert the Arraylist of source back into a primitive array of FontSource objects.
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
// Apply the new set of font sources to use.
FontSettings.SetFontsSources(updatedFontSources);
// Set font settings
doc.FontSettings = FontSettings;
dataDir = dataDir + "Rendering.SetFontsFolders_out.pdf";
doc.Save(dataDir);
// ExEnd:SetFontsFoldersSystemAndCustomFolder
Console.WriteLine("\nFonts system and coustom folder is setup.\nFile saved at " + dataDir);
}
public void SetFontsFoldersSystemAndCustomFolder()
{
// Store the font sources currently used so we can restore them later.
FontSourceBase[] origFontSources = FontSettings.GetFontsSources();
//ExStart
//ExFor:FontSettings
//ExFor:FontSettings.GetFontsSources()
//ExFor:FontSettings.SetFontsSources()
//ExId:SetFontsFoldersSystemAndCustomFolder
//ExSummary:Demonstrates how to set Aspose.Words to look for TrueType fonts in system folders as well as a custom defined folder when scanning for fonts.
Aspose.Words.Document doc = new Aspose.Words.Document(MyDir + "Rendering.doc");
// Retrieve the array of environment-dependent font sources that are searched by default. For example this will contain a "Windows\Fonts\" source on a Windows machines.
// We add this array to a new ArrayList to make adding or removing font entries much easier.
ArrayList fontSources = new ArrayList(FontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource("C:\\MyFonts\\", true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
// Convert the Arraylist of source back into a primitive array of FontSource objects.
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
// Apply the new set of font sources to use.
FontSettings.SetFontsSources(updatedFontSources);
doc.Save(MyDir + "Rendering.SetFontsFolders Out.pdf");
//ExEnd
// Verify that font sources are set correctly.
Assert.IsInstanceOf(typeof(SystemFontSource), FontSettings.GetFontsSources()[0]); // The first source should be a system font source.
Assert.IsInstanceOf(typeof(FolderFontSource), FontSettings.GetFontsSources()[1]); // The second source should be our folder font source.
FolderFontSource folderSource = ((FolderFontSource)FontSettings.GetFontsSources()[1]);
Assert.AreEqual(@"C:\MyFonts\", folderSource.FolderPath);
Assert.True(folderSource.ScanSubfolders);
// Restore the original sources used to search for fonts.
FontSettings.SetFontsSources(origFontSources);
}
public void RecieveFontSubstitutionNotification()
{
// Store the font sources currently used so we can restore them later.
FontSourceBase[] origFontSources = FontSettings.GetFontsSources();
//ExStart
//ExFor:IWarningCallback
//ExFor:SaveOptions.WarningCallback
//ExId:FontSubstitutionNotification
//ExSummary:Demonstrates how to recieve notifications of font substitutions by using IWarningCallback.
// Load the document to render.
Aspose.Words.Document doc = new Aspose.Words.Document(MyDir + "Document.doc");
// We can choose the default font to use in the case of any missing fonts.
FontSettings.DefaultFontName = "Arial";
// For testing we will set Aspose.Words to look for fonts only in a folder which doesn't exist. Since Aspose.Words won't
// find any fonts in the specified directory, then during rendering the fonts in the document will be subsuited with the default
// font specified under FontSettings.DefaultFontName. We can pick up on this subsuition using our callback.
FontSettings.SetFontsFolder(string.Empty, false);
// Create a new class implementing IWarningCallback which collect any warnings produced during document save.
HandleDocumentWarnings callback = new HandleDocumentWarnings();
// We assign the callback to the appropriate save options class. In this case, we are going to save to PDF
// so we create a PdfSaveOptions class and assign the callback there.
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.WarningCallback = callback;
// Pass the save options along with the save path to the save method.
doc.Save(MyDir + "Rendering.MissingFontNotification Out.pdf", saveOptions);
//ExEnd
Assert.Greater(callback.mFontWarnings.Count, 0);
Assert.True(callback.mFontWarnings[0].WarningType == WarningType.FontSubstitution);
Assert.True(callback.mFontWarnings[0].Description.Contains("has not been found"));
// Restore default fonts.
FontSettings.SetFontsSources(origFontSources);
}
public void RecieveFontSubstitutionUpdatePageLayout()
{
// Store the font sources currently used so we can restore them later.
FontSourceBase[] origFontSources = FontSettings.GetFontsSources();
// Load the document to render.
Aspose.Words.Document doc = new Aspose.Words.Document(MyDir + "Document.doc");
// We can choose the default font to use in the case of any missing fonts.
FontSettings.DefaultFontName = "Arial";
// For testing we will set Aspose.Words to look for fonts only in a folder which doesn't exist. Since Aspose.Words won't
// find any fonts in the specified directory, then during rendering the fonts in the document will be subsuited with the default
// font specified under FontSettings.DefaultFontName. We can pick up on this subsuition using our callback.
FontSettings.SetFontsFolder(string.Empty, false);
//ExStart
//ExId:FontSubstitutionUpdatePageLayout
//ExSummary:Demonstrates how IWarningCallback will still recieve warning notifcations even if UpdatePageLayout is called before document save.
// When you call UpdatePageLayout the document is rendered in memory. Any warnings that occured during rendering
// are stored until the document save and then sent to the appropriate WarningCallback.
doc.UpdatePageLayout();
// Create a new class implementing IWarningCallback and assign it to the PdfSaveOptions class.
HandleDocumentWarnings callback = new HandleDocumentWarnings();
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.WarningCallback = callback;
// Even though the document was rendered previously, any save warnings are notified to the user during document save.
doc.Save(MyDir + "Rendering.FontsNotificationUpdatePageLayout Out.pdf", saveOptions);
//ExEnd
Assert.Greater(callback.mFontWarnings.Count, 0);
Assert.True(callback.mFontWarnings[0].WarningType == WarningType.FontSubstitution);
Assert.True(callback.mFontWarnings[0].Description.Contains("has not been found"));
// Restore default fonts.
FontSettings.SetFontsSources(origFontSources);
}
public void GetListOfAvailableFonts()
{
//ExStart:GetListOfAvailableFonts
FontSettings fontSettings = new FontSettings();
ArrayList fontSources = new ArrayList(fontSettings.GetFontsSources());
// Add a new folder source which will instruct Aspose.Words to search the following folder for fonts.
FolderFontSource folderFontSource = new FolderFontSource(MyDir, true);
// Add the custom folder which contains our fonts to the list of existing font sources.
fontSources.Add(folderFontSource);
FontSourceBase[] updatedFontSources = (FontSourceBase[])fontSources.ToArray(typeof(FontSourceBase));
foreach (PhysicalFontInfo fontInfo in updatedFontSources[0].GetAvailableFonts())
{
Console.WriteLine("FontFamilyName : " + fontInfo.FontFamilyName);
Console.WriteLine("FullFontName : " + fontInfo.FullFontName);
Console.WriteLine("Version : " + fontInfo.Version);
Console.WriteLine("FilePath : " + fontInfo.FilePath);
}
//ExEnd:GetListOfAvailableFonts
}
public void SetFontsFoldersMultipleFolders()
{
// Store the font sources currently used so we can restore them later.
FontSourceBase[] fontSources = FontSettings.GetFontsSources();
//ExStart
//ExFor:FontSettings
//ExFor:FontSettings.SetFontsFolders(String[], Boolean)
//ExId:SetFontsFoldersMultipleFolders
//ExSummary:Demonstrates how to set Aspose.Words to look in multiple folders for TrueType fonts when rendering or embedding fonts.
Aspose.Words.Document doc = new Aspose.Words.Document(MyDir + "Rendering.doc");
// Note that this setting will override any default font sources that are being searched by default. Now only these folders will be searched for
// fonts when rendering or embedding fonts. To add an extra font source while keeping system font sources then use both FontSettings.GetFontSources and
// FontSettings.SetFontSources instead.
FontSettings.SetFontsFolders(new string[] { @"C:\MyFonts\", @"D:\Misc\Fonts\" }, true);
doc.Save(MyDir + "Rendering.SetFontsFolders Out.pdf");
//ExEnd
// Restore the original sources used to search for fonts.
FontSettings.SetFontsSources(fontSources);
}