Source code for ooodev.format.inner.partial.calc.font.font_effects_partial

from __future__ import annotations
from typing import TYPE_CHECKING

from ooodev.format.inner.partial.font.font_effects_partial import FontEffectsPartial as StandardFontEffectsPartial


if TYPE_CHECKING:
    from ooo.dyn.awt.font_strikeout import FontStrikeoutEnum
    from ooo.dyn.style.case_map import CaseMapEnum
    from ooo.dyn.awt.font_relief import FontReliefEnum
    from ooodev.format.inner.direct.write.char.font.font_effects import FontLine
    from ooodev.utils.color import Color
    from ooodev.utils.data_type.intensity import Intensity
    from ooodev.format.proto.font.font_effects_t import FontEffectsT


[docs]class FontEffectsPartial(StandardFontEffectsPartial): # region StandardFontEffectsPartial Overrides
[docs] def style_font_effect( self, *, color: Color | None = None, transparency: Intensity | int | None = None, overline: FontLine | None = None, underline: FontLine | None = None, strike: FontStrikeoutEnum | None = None, word_mode: bool | None = None, case: CaseMapEnum | None = None, relief: FontReliefEnum | None = None, outline: bool | None = None, shadowed: bool | None = None, ) -> FontEffectsT | None: """ Style Font options. Args: color (:py:data:`~.utils.color.Color`, optional): The value of the text color. If value is ``-1`` the automatic color is applied. transparency (Intensity, int, optional): The transparency value from ``0`` to ``100`` for the font color. overline (FontLine, optional): Character overline values. underline (FontLine, optional): Character underline values. strike (FontStrikeoutEnum, optional): Determines the type of the strike out of the character. word_mode(bool, optional): If ``True``, the underline and strike-through properties are not applied to white spaces. case (CaseMapEnum, optional): Specifies the case of the font. relief (FontReliefEnum, optional): Specifies the relief of the font. outline (bool, optional): Specifies if the font is outlined. shadowed (bool, optional): Specifies if the characters are formatted and displayed with a shadow effect. Raises: CancelEventError: If the event ``before_style_font_effect`` is cancelled and not handled. Returns: FontEffectsT | None: Font Effects instance or ``None`` if cancelled. Hint: - ``CaseMapEnum`` can be imported from ``ooo.dyn.style.case_map`` - ``FontReliefEnum`` can be imported from ``ooo.dyn.awt.font_relief`` - ``FontStrikeoutEnum`` can be imported from ``ooo.dyn.awt.font_strikeout`` - ``FontLine`` can be imported from ``ooodev.format.inner.direct.write.char.font.font_effects`` - ``Intensity`` can be imported from ``ooodev.utils.data_type.intensity`` - ``FontUnderlineEnum`` can be imported from ``ooo.dyn.awt.font_underline`` """ # calc does not have a hidden property for font effects. kwargs = { "color": color, "transparency": transparency, "overline": overline, "underline": underline, "strike": strike, "word_mode": word_mode, "case": case, "relief": relief, "outline": outline, "shadowed": shadowed, } return super().style_font_effect(**kwargs)
# endregion StandardFontEffectsPartial Overrides