Comment définir un dossier de polices en utilisant C#
Police personnalisée – Pourquoi la police est-elle importante ?
Les polices de caractères jouent un rôle important dans l’apparence, l’accessibilité, l’attrait esthétique et l’impact émotionnel d’un texte. Par conséquent, le choix de la bonne police peut s’avérer crucial pour atteindre des objectifs spécifiques, qu’il s’agisse de rendre un texte plus attrayant visuellement, plus lisible ou plus reconnaissable. Dans certains cas, vous pouvez souhaiter installer des polices personnalisées que vous avez conçues, achetées ou acquises auprès d’une source externe.
Cet article décrit comment installer les dossiers de polices de manière à ce qu’ils puissent être utilisés lors du rendu de documents HTML.
Installer une police – Ajouter un dossier de police personnalisé en C#
Aspose.HTML for .NET est une puissante bibliothèque permettant de travailler avec des documents HTML. Elle permet aux développeurs d’accéder au DOM HTML et de le manipuler en C# et dans d’autres langages .NET. Elle permet également de définir des dossiers de polices pour le rendu de documents HTML dans des formats particuliers.
Par défaut, Aspose.HTML for .NET recherche les polices installées dans le système. L’utilisation de la classe FontsSettings permet de définir les dossiers dans lesquels Aspose.HTML recherche les polices lors du rendu des documents.
Les exemples C# montrent comment définir un dossier de polices pour le rendu d’un document HTML aux formats PDF et Image. Nous examinerons les méthodes SetFontsLookupFolder()
qui sont utilisées dans la bibliothèque Aspose.HTML for .NET pour spécifier un dossier où se trouvent les polices personnalisées. Mais avant de commencer :
- Localisez les fichiers de polices personnalisées que vous souhaitez utiliser.
- Créez un dossier dans lequel vous stockerez les polices personnalisées.
- Copiez les polices personnalisées dans le dossier des polices.
Définir le dossier de polices pour convertir HTML en PDF
Lors du rendu d’un document HTML vers un fichier PDF, par exemple, il est important de s’assurer que les polices personnalisées utilisées dans le document HTML sont disponibles pour le moteur de rendu. Par défaut, Aspose.HTML recherche les polices dans le dossier des polices du système. Cependant, si vous utilisez des polices personnalisées, vous devrez appeler la méthode SetFontsLookupFolder(fontsFolder)
et lui indiquer où les trouver.
Voici un exemple de définition d’une police personnalisée pour le rendu d’un document HTML au format PDF à l’aide de la bibliothèque Aspose.HTML C# :
1// Use custom font folder in HTML to PDF conversion
2
3// Prepare a path to a source HTML file
4string documentPath = Path.Combine(DataDir, "file.html");
5
6// Create an instance of Configuration
7using Configuration configuration = new Configuration();
8
9// Get the IUserAgentService
10IUserAgentService service = configuration.GetService<IUserAgentService>();
11
12// Set a custom font folder path
13service.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "fonts"));
14
15// Initialize the HTML document with specified configuration
16using (HTMLDocument document = new HTMLDocument(documentPath, configuration))
17{
18 // Convert HTML to PDF
19 Converter.ConvertHTML(document, new PdfSaveOptions(), Path.Combine(OutputDir, "file-fontsetting.pdf"));
20}
Prenons l’exemple en C# de la définition d’un dossier de polices personnalisé. Vous devez suivre quelques étapes :
- Créez une instance de la classe Configuration à l’aide du constructeur Configuration().
- Appelez la méthode GetService sur l’objet de configuration pour récupérer une instance de l’interface IUserAgentService.
- Utilisez la méthode
SetFontsLookupFolder(
fontsFolder
) de la classe FontsSettings et transmettez-lui un chemin d’accès personnalisé au dossier des polices. Cette méthode permet à la bibliothèque de rechercher les polices dans le dossier spécifié lors de la génération du document PDF. Si des polices personnalisées ne se trouvent pas dans ce dossier, elles ne pourront pas être utilisées dans le document PDF. - Initialiser un document HTML avec la configuration spécifiée en utilisant le constructeur HTMLDocument().
- Appeler la méthode ConvertHTML() pour la conversion de HTML en PDF.
Vous pouvez télécharger des fichiers de données et des exemples C# complets qui démontrent comment définir le dossier des polices à partir de GitHub.
Définir le dossier de polices pour convertir le HTML en image
Prenons l’exemple en C# de l’utilisation de la bibliothèque Aspose.HTML for .NET pour convertir un document HTML en format image, tout en définissant un dossier pour les polices personnalisées :
1// Set custom font folder for HTML to PNG conversion in C#
2
3// Prepare a path to a source HTML file
4string documentPath = Path.Combine(DataDir, "file.html");
5
6// Prepare a path to save the converted file
7string savePath = Path.Combine(OutputDir, "file-output.png");
8
9// Create an instance of the Configuration class
10using Configuration configuration = new Configuration();
11
12// Get the IUserAgentService
13IUserAgentService userAgentService = configuration.GetService<IUserAgentService>();
14
15// Use the SetFontsLookupFolder() method to set a directory which will act as a new fontsFolder
16// Pass "true" as the recursive parameter to use all nested directories
17userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "font"), true);
18
19// Initialize the HTML document with specified configuration
20using (HTMLDocument document = new HTMLDocument(documentPath, configuration))
21{
22 // Convert HTML to Image
23 Converter.ConvertHTML(document, new ImageSaveOptions(), savePath);
24}
Pour transformer du HTML en image en utilisant des polices personnalisées, vous devez suivre quelques étapes :
- Créez l’objet
configuration
et utilisez la méthode GetService pour obtenir une référence à l’interface IUserAgentService. - Appelez la méthode
SetFontsLookupFolder(
fontsFolder
,recursive
) pour définir le dossier des polices. Cette méthode prend deux paramètres : le chemin du dossier où se trouvent les polices et une valeur booléenne qui spécifie s’il faut inclure les sous-dossiers ou non. En définissanttrue
comme paramètrerecursive
, la méthode inclut tous les sous-dossiers du dossier spécifié dans la recherche de polices. - Initialise le document HTML avec la configuration spécifiée.
- Appeler la méthode ConvertHTML() pour convertir le HTML en image.
Ainsi, en définissant le dossier de polices à l’aide des méthodes SetFontsLookupFolder()
, la bibliothèque Aspose.HTML utilisera les polices personnalisées situées dans le dossier spécifié pour rendre le document HTML dans différents formats de sortie, tels que PDF ou images, en s’assurant que les documents sont affichés comme prévu avec les polices souhaitées.
Aspose.HTML propose des applications Web HTML gratuites qui constituent une collection en ligne de convertisseurs, de fusions, d’outils SEO, de générateurs de code HTML, d’outils URL, et bien plus encore. Les applications fonctionnent sur n’importe quel système d’exploitation doté d’un navigateur web et ne nécessitent aucune installation de logiciel supplémentaire. C’est un moyen rapide et facile de résoudre efficacement vos tâches liées au HTML.