36 lines
1.1 KiB
Python
36 lines
1.1 KiB
Python
|
"""Settings object, providing access to document-level settings."""
|
||
|
|
|
||
|
|
from __future__ import annotations
|
||
|
|
|
||
|
|
from typing import TYPE_CHECKING, cast
|
||
|
|
|
||
|
|
from docx.shared import ElementProxy
|
||
|
|
|
||
|
|
if TYPE_CHECKING:
|
||
|
|
import docx.types as t
|
||
|
|
from docx.oxml.settings import CT_Settings
|
||
|
|
from docx.oxml.xmlchemy import BaseOxmlElement
|
||
|
|
|
||
|
|
|
||
|
|
class Settings(ElementProxy):
|
||
|
|
"""Provides access to document-level settings for a document.
|
||
|
|
|
||
|
|
Accessed using the :attr:`.Document.settings` property.
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self, element: BaseOxmlElement, parent: t.ProvidesXmlPart | None = None):
|
||
|
|
super().__init__(element, parent)
|
||
|
|
self._settings = cast("CT_Settings", element)
|
||
|
|
|
||
|
|
@property
|
||
|
|
def odd_and_even_pages_header_footer(self) -> bool:
|
||
|
|
"""True if this document has distinct odd and even page headers and footers.
|
||
|
|
|
||
|
|
Read/write.
|
||
|
|
"""
|
||
|
|
return self._settings.evenAndOddHeaders_val
|
||
|
|
|
||
|
|
@odd_and_even_pages_header_footer.setter
|
||
|
|
def odd_and_even_pages_header_footer(self, value: bool):
|
||
|
|
self._settings.evenAndOddHeaders_val = value
|