mlreportgen.dom. Класс DOCXPageSize

Пакет: mlreportgen.dom
Суперклассы:

Размер и ориентация страниц в документе Microsoft Word

Примечание

mlreportgen.dom.DOCXPageSize будет удален в будущем релизе. Используйте mlreportgen.dom.PageSize вместо этого.

Описание

Задает высоту, ширину и ориентацию страниц в разделе документа Word Microsoft®.

Конструкция

docxPageSizeObj = DOCXPageSize() создает объект размера страницы, имеющий значения по умолчанию 8.5 11 дюймов и портретной ориентации.

docxPageSizeObj = DOCXPageSize(height,width) создает страницу портрета, имеющую заданную высоту и ширину.

docxPageSizeObj = DOCXPageSize(height,width,orientation) создает страницу, имеющую заданную высоту, ширину и ориентацию.

Входные параметры

развернуть все

вектор символов, задающий высоту страницы. Вектор символов должен иметь формат valueUnits, где Units является сокращением от модулей, в которых выражается размер ширины. Допустимые сокращения:

  • никакое сокращение — пиксели

  • cm — 'centimeters'

  • \in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt — 'points'

  • px — 'pixels'

Вектор символов должен иметь формат valueUnits, где Units является сокращением от модулей, в которых выражается размер ширины. Допустимые сокращения:

  • никакое сокращение — пиксели

  • cm — 'centimeters'

  • \in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt — 'points'

  • px — 'pixels'

Используйте одно из этих значений:

  • 'portrait' (значение по умолчанию)

  • 'landscape'

Задайте значения высоты и ширины, которые отражают установку ориентации. Например, если ориентация является средой, и документ должен быть распечатан на бумаге 8.5x11-дюйма, установите height на '8.5in' и width к '11in'.

Выходные аргументы

развернуть все

Размер страницы и ориентация документа Word, представленного объектом mlreportgen.dom.DOCXPageSize.

Свойства

развернуть все

вектор символов, задающий высоту страницы. Вектор символов должен иметь формат valueUnits, где Units является сокращением от модулей, в которых выражается размер ширины. Допустимые сокращения:

  • никакое сокращение — пиксели

  • cm — 'centimeters'

  • \in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt — 'points'

  • px — 'pixels'

ID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.

Используйте одно из этих значений:

  • 'portrait' (значение по умолчанию)

  • 'landscape'

Задайте значения высоты и ширины, которые отражают установку ориентации. Например, если ориентация является средой, и документ должен быть распечатан на бумаге 8.5x11-дюйма, установите height на '8.5in' и width к '11in'.

Пометьте для элемента документа, указанного как вектор символов.

Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму CLASS:ID, где CLASS является классом элемента, и ID является значением свойства Id объекта. Можно задать тег, чтобы заменить сгенерированный тег.

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

Вектор символов должен иметь формат valueUnits, где Units является сокращением от модулей, в которых выражается размер ширины. Допустимые сокращения:

  • никакое сокращение — пиксели

  • cm — 'centimeters'

  • \in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt — 'points'

  • px — 'pixels'

Примеры

свернуть все

Измените ориентацию страницы и размер, заданный шаблоном DOM по умолчанию.

import mlreportgen.dom.*;
d = Document('myreport','docx');
open(d);
 
s = d.CurrentDOCXSection;
s.PageSize.Orientation  ='landscape';
s.PageSize.Height = '8.5in';
s.PageSize.Width = '11in';
append(d,'This document has landscape pages');

close(d);
rptview('myreport','docx');