Скрытое поле абзаца имеет функционал, подобный функционалу скрытых текстовых полей. Однако скрытое поле абзаца не имеет какого-либо содержимого. Оно скрывает абзац, в котором находится, что позволяет скрывать или отображать абзац форматированного текста в зависимости от того, какое значение вернуло определенное условие: true или false.
Скрытые поля абзаца часто используются совместно со стандартным письмом. Например, если состояние зависит от поля базы данных, скрытое поле абзаца может использоваться для выборочного включения абзацев в стандартное письмо, в зависимости от содержимого базы данных. В одном абзаце может находиться множество полей абзаца. Абзац отображается, если хотя бы в одном скрытом поле абзаца условие вернуло значение false. Как вариант, условия, связанные с несколькими скрытыми полями абзаца, могут быть объединены в одно в единственном поле с помощью логических операций в условиях.
Примечание - В отличие от большинства полей это поле не отображает текст, а влияет на абзац, в котором оно содержится.
С элементом <text:hidden-paragraph> могут быть связаны следующие атрибуты:
условие;
скрытость.
Условие
Атрибут text:condition содержит логическое выражение. Если результатом выполнения логического выражения является true, абзац скрывается. Если же результатом выполнения логического выражения является false, абзац отображается.
Скрытость
Атрибут text:is-hidden хранит значение: отображается ли абзац или нет. Его цель аналогична соответствующему атрибуту скрытого текстового поля, а именно, позволить правильно отображать абзац без необходимости сначала вычислять условное выражение. Значение этого атрибута перезаписывается новым значением каждый раз, когда приложение вычисляет значение выражения.
Примечание - Этот атрибут не имеет другого назначения, кроме упрощения преобразований или начального отображения документа.