Travailler avec les options et l'apparence des documents Word

Parfois, vous devrez peut-être modifier l’apparence d’un document, par exemple, définir les préférences de langue ou le nombre de lignes par page.Aspose.Words permet de contrôler la façon dont le document sera affiché, ainsi que certaines options supplémentaires. Cet article décrit ces possibilités.

Définir Les Options D’Affichage Du Document

Vous pouvez contrôler la façon dont un document sera affiché dans Microsoft Word en utilisant la classe ViewOptions. Par exemple, vous pouvez définir une valeur de zoom de document à l’aide de la propriété ZoomPercent ou le mode d’affichage à l’aide de la propriété ViewType.

L’exemple de code suivant montre comment s’assurer qu’un document est affiché à 50% lorsqu’il est ouvert dans Microsoft Word:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.doc");
doc.getViewOptions().setViewType(ViewType.PAGE_LAYOUT);
doc.getViewOptions().setZoomPercent(50);
doc.save(dataDir + "Document.SetZoom_out.doc");

Vous pouvez télécharger le fichier modèle de cet exemple à partir de Aspose.Words GitHub.

Microsoft Word 2013 n’écrit aucun facteur de zoom dans un document et ne définit plus le zoom par défaut à partir de la valeur écrite dans le document, à la place, il semble utiliser le facteur de zoom du dernier document ouvert.

Définir Les Options D’Affichage De La Page

Si vous souhaitez définir le nombre de caractères par ligne, utilisez la propriété CharactersPerLine. Vous pouvez également définir le nombre de lignes par page pour un document Word – utilisez la propriété LinesPerPage pour obtenir ou définir le nombre de lignes par page dans la grille du document.

Dans Microsoft Word, vous pouvez définir les mêmes paramètres à l’aide de l’onglet “Grille de document” de la boîte de dialogue “Mise en page” uniquement lorsque la prise en charge de la langue asiatique est installée.

L’exemple de code suivant montre comment définir le nombre de caractères par ligne et le nombre de lignes par page pour un document Microsoft Word:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.

Document doc = new Document(dataDir + "Document.doc");
// Set the layout mode for a section allowing to define the document grid
// behavior
// Note that the Document Grid tab becomes visible in the Page Setup dialog of
// MS Word if any Asian language is defined as editing language.
doc.getFirstSection().getPageSetup().setLayoutMode(SectionLayoutMode.GRID);
// Set the number of characters per line in the document grid.
doc.getFirstSection().getPageSetup().setCharactersPerLine(30);
// Set the number of lines per page in the document grid.
doc.getFirstSection().getPageSetup().setLinesPerPage(10);
// Save the document
doc.save(dataDir + "Document.PageSetup_out.doc");

Définir les Préférences de Langue

L’affichage d’un document dans Microsoft Word dépend des langues définies par défaut pour ce document. Si aucune langue n’est définie par défaut, Microsoft Word prend des informations dans la boîte de dialogue “Définir les préférences linguistiques d’Office”, qui, par exemple, se trouve sous “Fichier → Options → Langue” dans Microsoft Word 2019.

Avec Aspose.Words, vous pouvez également définir des préférences de langue à l’aide de la classe LanguagePreferences. Notez également que pour l’affichage correct de votre document, il est nécessaire de définir la version Microsoft Word à laquelle le processus de chargement du document doit correspondre – cela peut être fait en utilisant la propriété MswVersion.

Si votre document généré Aspose.Words n’a pas l’apparence attendue, vérifiez les valeurs LanguagePreferences et MswVersion et ajustez-les si nécessaire pour qu’elles correspondent aux paramètres de votre version Microsoft Word.

L’exemple de code suivant montre comment ajouter le japonais aux langues d’édition:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// Specify LoadOptions to add Editing Language
LoadOptions loadOptions = new LoadOptions();
loadOptions.getLanguagePreferences().addEditingLanguage(EditingLanguage.JAPANESE);

Document doc = new Document(dataDir + "languagepreferences.docx", loadOptions);

int localeIdFarEast = doc.getStyles().getDefaultFont().getLocaleIdFarEast();
if (localeIdFarEast == (int) EditingLanguage.JAPANESE)
    System.out.println("The document either has no any FarEast language set in defaults or it was set to Japanese originally.");
else
    System.out.println("The document default FarEast language was set to another than Japanese language originally, so it is not overridden.");

L’exemple de code suivant montre comment définir le russe comme langue d’édition par défaut:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// Specify LoadOptions to set Default Editing Language
   LoadOptions loadOptions = new LoadOptions();
   loadOptions.getLanguagePreferences().setDefaultEditingLanguage(EditingLanguage.RUSSIAN);

   Document doc = new Document(dataDir + "languagepreferences.docx", loadOptions);

   int localeId = doc.getStyles().getDefaultFont().getLocaleId();
   if (localeId == (int) EditingLanguage.RUSSIAN)
       System.out.println("The document either has no any language set in defaults or it was set to Russian originally.");
   else
       System.out.println("The document default language was set to another than Russian language originally, so it is not overridden.");

Optimiser un Document pour une version Word particulière

La méthode OptimizeFor permet d’optimiser le contenu du document, ainsi que le comportement par défaut Aspose.Words pour une version particulière de Microsoft Word. Vous pouvez utiliser cette méthode pour empêcher Microsoft Word d’afficher le ruban “Mode de compatibilité” lors du chargement du document. Notez que vous devrez peut-être également définir la propriété Compliance sur Iso29500_2008_Transitional ou plus.

L’exemple de code suivant montre comment optimiser le contenu du document pour Microsoft Word 2016:

Document doc = new Document(dataDir + "Document.docx");

// Set Word2016 version for document
doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2016);

// Save the document.
doc.save(dataDir + "output.docx");