Установите поля страницы отчета Microsoft Word

Этот пример иллюстрирует, как установить ширину полей страницы отчета Microsoft Word.

Copyright 2014 MathWorks, Inc.

Скрипт в качестве примера

Следующее является скриптом, используемым, чтобы проиллюстрировать этот пример:

import mlreportgen.dom.*;
workdir = tempdir;
docpath = fullfile(workdir, 'myreport');
d = mlreportgen.dom.Document(docpath,'docx');
open(d);
section = d.CurrentDOCXSection;
section.PageMargins.Left = '0.5in';
section.PageMargins.Right = '0.5in';
append(d,'Left and right margins are .5 inch');
membrane();
imagePath = fullfile(workdir, 'membrane.png');
print('-dpng', imagePath);
image = Image(imagePath);
image.Style = {ScaleToFit}
append(d,image);
close(d);
if ispc
    rptview(d.OutputPath);
end

Импортируйте пакет API DOM

Это позволяет скрипту отсылать к классам API DOM их неполными именами, например, Документом вместо mlreportgen.dom.Document:

import mlreportgen.dom.*;

Создайте документ

Создайте документ Word на основе шаблона Word API DOM по умолчанию. Шаблон Word по умолчанию содержит раздел макета страницы отдельного слова, который задает 1-дюймовые поля страницы.

workdir = tempdir;
docpath = fullfile(workdir, 'myreport');
d = mlreportgen.dom.Document(docpath,'docx'); %#ok<*NOPTS>

Обратите внимание на то, что свойство CurrentDOCXSection документа является пустым.

d.CurrentDOCXSection
ans =

     []

Откройте документ

Необходимо открыть документ прежде, чем попытаться изменить его поля страницы. Это вызвано тем, что API DOM не анализирует шаблон документа, пока это не открыто.

open(d);

Свойство CurrentDOCXSection документа является теперь указателем на объект DOCXSection, свойства которого установлены в значения, проанализированные из шаблона API DOM по умолчанию.

d.CurrentDOCXSection
ans = 
  DOCXSection with properties:

         PageHeaders: []
         PageFooters: []
          RawFormats: {1x2 cell}
         PageMargins: [1x1 mlreportgen.dom.PageMargins]
            PageSize: [1x1 mlreportgen.dom.PageSize]
     FirstPageNumber: 0
    PageNumberFormat: []
        SectionBreak: 'Next Page'
           StyleName: []
               Style: {1x4 cell}
    CustomAttributes: []
              Parent: [1x1 mlreportgen.dom.Document]
            Children: [1x0 mlreportgen.dom.Node]
                 Tag: 'dom.DOCXSection:1300'
                  Id: '1300'

Граничные свойства объекта DOCXSection установлены в значения, проанализированные из шаблона API DOM по умолчанию.

d.CurrentDOCXSection.PageMargins
ans = 
  PageMargins with properties:

       Top: '1in'
    Bottom: '1in'
      Left: '1in'
     Right: '1in'
    Header: '0.5in'
    Footer: '0.5in'
    Gutter: '0in'
       Tag: 'dom.PageMargins:1304'
        Id: '1304'

Измените поля страницы

Сначала присвойте указатель на текущий объект DOCXSection к новой переменной. Это не необходимо, но это делает код немного более читаемым.

section = d.CurrentDOCXSection;

Теперь измените левые и правые поля.

section.PageMargins.Left = '0.5in';
section.PageMargins.Right = '0.5in';

Обратите внимание на то, что, потому что объект DOCXSection является объектом указателя (как все Объекты DOM), установка полей через переменную раздела совпадает с установкой полей через d переменную.

d.CurrentDOCXSection.PageMargins
ans = 
  PageMargins with properties:

       Top: '1in'
    Bottom: '1in'
      Left: '0.5in'
     Right: '0.5in'
    Header: '0.5in'
    Footer: '0.5in'
    Gutter: '0in'
       Tag: 'dom.PageMargins:1307'
        Id: '1307'

Добавьте некоторое иллюстративное содержимое

Добавьте некоторый текст

append(d,'Left and right margins are .5 inch');

Создайте изображение PNG L-образной мембраны.

membrane();
imagePath = fullfile(workdir, 'membrane.png');
print('-dpng', imagePath);

Перенесите изображение PNG в изображение DOM.

image = Image(imagePath)
image = 
  Image with properties:

                Path: '/tmp/BR2020ad_1302590_239645/mlx_to_docbook2/membrane.png'
              Height: '840px'
               Width: '1120px'
                 Map: []
           StyleName: []
               Style: {1x2 cell}
    CustomAttributes: []
              Parent: []
            Children: [1x0 mlreportgen.dom.Node]
                 Tag: 'dom.Image:1310'
                  Id: '1310'

Масштабируйте изображение, чтобы соответствовать между новыми полями страницы.

image.Style = {ScaleToFit}
image = 
  Image with properties:

                Path: '/tmp/BR2020ad_1302590_239645/mlx_to_docbook2/membrane.png'
              Height: []
               Width: []
                 Map: []
           StyleName: []
               Style: {[1x1 mlreportgen.dom.ScaleToFit]}
    CustomAttributes: []
              Parent: []
            Children: [1x0 mlreportgen.dom.Node]
                 Tag: 'dom.Image:1310'
                  Id: '1310'

Добавьте изображение к документу

append(d,image);

Закройте документ.

close(d);

Покажите документ

Можно показать документ только о Windows.

if ispc
    rptview(d.OutputPath);
end
Для просмотра документации необходимо авторизоваться на сайте