Source code for

Module for managing paragraph Line Spacing.

.. versionadded:: 0.17.8

# region Import
from __future__ import annotations
from typing import Any, Tuple, cast, overload, Type, TypeVar

from import LineSpacing as UnoLineSpacing
from import CancelEventArgs
from ooodev.exceptions import ex as mEx
from import line_spacing_struct as mLs
from ooodev.utils.kind.line_spacing_mode_kind import ModeKind
from ooodev.format.inner.kind.format_kind import FormatKind
from ooodev.format.inner.style_base import StyleMulti
from ooodev.units.unit_obj import UnitT
from ooodev.loader import lo as mLo
from ooodev.utils import props as mProps

# endregion Import

_TLineSpacing = TypeVar(name="_TLineSpacing", bound="LineSpacing")

[docs]class LineSpacing(StyleMulti): """ Paragraph Line Spacing Any properties starting with ``prop_`` set or get current instance values. .. seealso:: - :ref:`help_writer_format_direct_para_indent_spacing` """ # region init
[docs] def __init__( self, *, mode: ModeKind | None = None, value: int | float | UnitT = 0, ) -> None: """ Constructor Args: mode (ModeKind, optional): Determines the mode that is used to apply units. value (Real, UnitT, optional): Value of line spacing. Only applies when ``ModeKind`` is ``PROPORTIONAL``, ``AT_LEAST``, ``LEADING``, or ``FIXED``. Returns: None: Note: If ``ModeKind`` is ``SINGLE``, ``LINE_1_15``, ``LINE_1_5``, or ``DOUBLE`` then ``value`` is ignored. If ``ModeKind`` is ``AT_LEAST``, ``LEADING``, or ``FIXED`` then ``value`` is a float (``in mm units``) or :ref:`proto_unit_obj` If ``ModeKind`` is ``PROPORTIONAL`` then value is an int representing percentage. For example ``95`` equals ``95%``, ``130`` equals ``130%`` See Also: - :ref:`help_writer_format_direct_para_indent_spacing` """ # super().__init__() ls = None if mode is not None: ls = mLs.LineSpacingStruct( mode=mode, value=value, _cattribs=self._get_ls_cattribs(), # type: ignore ) if ls is not None: self._set_style("line_spacing", ls, *ls.get_attrs())
# endregion init # region Internal Methods def _get_ls_cattribs(self) -> dict: return { "_supported_services_values": self._supported_services(), "_property_name": "ParaLineSpacing", } # endregion Internal Methods # region Overrides def _supported_services(self) -> Tuple[str, ...]: try: return self._supported_services_values except AttributeError: self._supported_services_values = ( "", "", ) return self._supported_services_values def _on_modifying(self, source: Any, event: CancelEventArgs) -> None: if self._is_default_inst: raise ValueError("Modifying a default instance is not allowed") return super()._on_modifying(source, event) # region apply() @overload def apply(self, obj: Any) -> None: # type: ignore ...
[docs] def apply(self, obj: Any, **kwargs) -> None: """ Applies writing mode to ``obj`` Args: obj (object): UNO object that supports ```` service. Returns: None: """ try: super().apply(obj, **kwargs) except mEx.MultiError as e: mLo.Lo.print(f"{self.__class__.__name__}.apply(): Unable to set Property") for err in e.errors: mLo.Lo.print(f" {err}")
# endregion apply() # endregion Overrides # region static methods # region from_obj() @overload @classmethod def from_obj(cls: Type[_TLineSpacing], obj: Any) -> _TLineSpacing: ... @overload @classmethod def from_obj(cls: Type[_TLineSpacing], obj: Any, **kwargs) -> _TLineSpacing: ...
[docs] @classmethod def from_obj(cls: Type[_TLineSpacing], obj: Any, **kwargs) -> _TLineSpacing: """ Gets instance from object Args: obj (object): UNO object. Raises: NotSupportedError: If ``obj`` is not supported. Returns: LineSpacing: ``LineSpacing`` instance that represents ``obj`` line spacing. """ inst = cls(**kwargs) if not inst._is_valid_obj(obj): raise mEx.NotSupportedError(f'Object is not supported for conversion to "{cls.__name__}"') pls = cast(UnoLineSpacing, mProps.Props.get(obj, "ParaLineSpacing", None)) ls = mLs.LineSpacingStruct.from_uno_struct( pls, _cattribs={"_supported_services_values": inst._supported_services(), "_property_name": "ParaLineSpacing"}, ) if ls is not None: inst._set_style("line_spacing", ls, *ls.get_attrs()) return inst
# endregion from_obj() # endregion static methods # region properties @property def prop_format_kind(self) -> FormatKind: """Gets the kind of style""" try: return self._format_kind_prop except AttributeError: self._format_kind_prop = FormatKind.PARA | FormatKind.SHAPE return self._format_kind_prop @property def prop_mode(self) -> ModeKind | None: """Gets the mode that is used to apply units.""" return self.prop_inner.prop_mode @property def prop_value(self) -> int | float | None: """Gets the Value of line spacing.""" return self.prop_inner.prop_value @property def prop_inner(self) -> mLs.LineSpacingStruct: """Gets Line Spacing instance""" try: return self._direct_inner except AttributeError: self._direct_inner = cast(mLs.LineSpacingStruct, self._get_style_inst("line_spacing")) return self._direct_inner @property def default(self: _TLineSpacing) -> _TLineSpacing: """Gets ``LineSpacing`` default.""" try: return self._default_inst except AttributeError: self._default_inst = self.__class__(mode=ModeKind.SINGLE, _cattribs=self._get_internal_cattribs()) # type: ignore self._default_inst._is_default_inst = True return self._default_inst
# endregion properties