Source code for ooodev.draw.impress_pages

"""DrawPages class for Draw documents."""

from __future__ import annotations
from typing import TYPE_CHECKING, TypeVar, Generic
import contextlib

try:
    # python 3.12+
    from typing import override  # noqa # type: ignore
except ImportError:
    from typing_extensions import override  # noqa # type: ignore

from com.sun.star.drawing import XDrawPage

from ooodev.adapter.container.name_access_partial import NameAccessPartial
from ooodev.adapter.drawing.draw_pages_comp import DrawPagesComp
from ooodev.draw import impress_page as mImpressPage
from ooodev.exceptions import ex as mEx
from ooodev.loader import lo as mLo
from ooodev.office.partial.office_document_prop_partial import OfficeDocumentPropPartial
from ooodev.utils import gen_util as mGenUtil
from ooodev.utils import info as mInfo
from ooodev.utils.context.lo_context import LoContext
from ooodev.utils.partial.lo_inst_props_partial import LoInstPropsPartial
from ooodev.utils.partial.qi_partial import QiPartial
from ooodev.utils.partial.service_partial import ServicePartial
from ooodev.utils.partial.the_dictionary_partial import TheDictionaryPartial

if TYPE_CHECKING:
    from com.sun.star.drawing import XDrawPages
    from ooodev.proto.component_proto import ComponentT
    from ooodev.loader.inst.lo_inst import LoInst

_T = TypeVar("_T", bound="ComponentT")


[docs]class ImpressPages( LoInstPropsPartial, OfficeDocumentPropPartial, DrawPagesComp, NameAccessPartial["XDrawPage"], QiPartial, ServicePartial, TheDictionaryPartial, Generic[_T], ): """ Class for managing Draw Pages. """
[docs] def __init__(self, owner: _T, slides: XDrawPages, lo_inst: LoInst | None = None) -> None: """ Constructor Args: owner (_T): Owner Document slides (XDrawPages): Document Pages. lo_inst (LoInst, optional): Lo instance. Defaults to None. """ if lo_inst is None: lo_inst = mLo.Lo.current_lo self.__owner = owner LoInstPropsPartial.__init__(self, lo_inst=lo_inst) if not isinstance(owner, OfficeDocumentPropPartial): raise ValueError("owner must be an instance of OfficeDocumentPropPartial") OfficeDocumentPropPartial.__init__(self, owner.office_doc) DrawPagesComp.__init__(self, slides) # type: ignore # The API does not show that DrawPages implements XNameAccess, but it does. NameAccessPartial.__init__(self, component=slides, interface=None) # type: ignore QiPartial.__init__(self, component=slides, lo_inst=self.lo_inst) ServicePartial.__init__(self, component=slides, lo_inst=self.lo_inst) TheDictionaryPartial.__init__(self) self._current_index = 0
@override def __getitem__(self, _itm: int | str) -> mImpressPage.ImpressPage[_T]: # type: ignore if isinstance(_itm, str): return self.get_by_name(_itm) return self.get_by_index(idx=_itm) def __len__(self) -> int: return self.component.getCount() def __iter__(self): self._current_index = 0 return self @override def __next__(self) -> mImpressPage.ImpressPage[_T]: # type: ignore if self._current_index >= len(self): self._current_index = 0 raise StopIteration self._current_index += 1 return self[self._current_index - 1] def __delitem__(self, _item: int | str | mImpressPage.ImpressPage[_T] | XDrawPage) -> None: with LoContext(self.lo_inst): if mInfo.Info.is_instance(_item, int): self.delete_slide(_item) elif mInfo.Info.is_instance(_item, str): slide = super().get_by_name(_item) if slide is None: raise mEx.MissingNameError(f"Unable to find slide with name '{_item}'") super().remove(slide) elif mInfo.Info.is_instance(_item, mImpressPage.ImpressPage): super().remove(_item.component) elif mInfo.Info.is_instance(_item, XDrawPage): super().remove(_item) else: raise TypeError(f"Unsupported type: {type(_item)}")
[docs] def insert_slide(self, idx: int) -> mImpressPage.ImpressPage[_T]: """ Inserts a slide at the given position in the document Args: idx (int): Index, can be a negative value to insert from the end of the document. For example, -1 will insert at the end of the document. Raises: DrawPageMissingError: If unable to get pages. DrawPageError: If any other error occurs. Returns: ImpressPage: New slide that was inserted. """ index = mGenUtil.Util.get_index(idx, len(self), True) return mImpressPage.ImpressPage( owner=self.owner, component=self.component.insertNewByIndex(index), lo_inst=self.lo_inst )
[docs] def delete_slide(self, idx: int) -> bool: """ Deletes a slide Args: idx (int): Index. Can be a negative value to delete from the end of the document. For example, -1 will delete the last slide. Returns: bool: ``True`` on success; Otherwise, ``False`` """ index = mGenUtil.Util.get_index(idx, len(self)) with contextlib.suppress(Exception): # get the slide as UNO object and remove it result = super().get_by_index(index) if result is None: return False self.remove(result) return True return False
# region XNameAccess overrides
[docs] @override def get_by_name(self, name: str) -> mImpressPage.ImpressPage[_T]: # type: ignore """ Gets the element with the specified name. Args: name (str): The name of the element. Raises: MissingNameError: If unable to find slide with name. Returns: ImpressPage[_T]: The drawpage with the specified name. """ if not self.has_by_name(name): raise mEx.MissingNameError(f"Unable to find slide with name '{name}'") result = super().get_by_name(name) return mImpressPage.ImpressPage(owner=self.owner, component=result, lo_inst=self.lo_inst)
# endregion XNameAccess overrides # region XIndexAccess overrides
[docs] @override def get_by_index(self, idx: int) -> mImpressPage.ImpressPage[_T]: # type: ignore """ Gets the element with the specified index. Args: idx (int): The index of the element. Idx can be a negative value to get from the end of the document. For example, -1 will get the last slide. Raises: IndexError: If unable to find slide with index. Returns: ImpressPage[_T]: The drawpage with the specified index. """ index = mGenUtil.Util.get_index(idx, len(self)) result = super().get_by_index(index) return mImpressPage.ImpressPage(owner=self.owner, component=result, lo_inst=self.lo_inst)
# endregion XIndexAccess overrides # region XDrawPages overrides
[docs] @override def insert_new_by_index(self, idx: int) -> mImpressPage.ImpressPage[_T]: # type: ignore """ Creates and inserts a new DrawPage or MasterPage into this container. Args: idx (int): The index at which the new page will be inserted. ``idx`` can be a negative value to insert from the end of the document. For example, ``-1`` will insert at the end of the document. Returns: ImpressPage[_T]: The new page. """ index = mGenUtil.Util.get_index(idx, len(self), True) result = super().insert_new_by_index(index) return mImpressPage.ImpressPage(owner=self.owner, component=result, lo_inst=self.lo_inst)
# endregion XDrawPages overrides # region Properties @property def owner(self) -> _T: """ Returns: _T: Usually Impress document. """ return self.__owner
# endregion Properties