Class CT_String

src/docx/oxml/shared.py:39–52

Used for `w:pStyle` and `w:tblStyle` elements and others. In those cases, it containing a style name in its `val` attribute.

class CT_String(BaseOxmlElement):
    """Used for `w:pStyle` and `w:tblStyle` elements and others.

    In those cases, it containing a style name in its `val` attribute.
    """

    val: str = RequiredAttribute("w:val", ST_String)  # pyright: ignore[reportAssignmentType]

    @classmethod
    def new(cls, nsptagname: str, val: str):
        """A new `CT_String`` element with tagname `nsptagname` and `val` attribute set to `val`."""
        elm = cast(CT_String, OxmlElement(nsptagname))
        elm.val = val
        return elm