priority property

Style.priority property

Gets/sets the integer value that represents the priority for sorting the styles in the Styles task pane.

@property
def priority(self) -> int:
    ...

@priority.setter
def priority(self, value: int):
    ...

Examples

Shows how to prioritize and hide a style.

doc = aw.Document()
style_title = doc.styles.get_by_style_identifier(aw.StyleIdentifier.SUBTITLE)

if style_title.priority == 9:
    style_title.priority = 10

if not style_title.unhide_when_used:
    style_title.unhide_when_used = True

if style_title.semi_hidden:
    style_title.semi_hidden = True

doc.save(file_name=ARTIFACTS_DIR + "Styles.StylePriority.docx")

See Also

Style.paragraph_format property Style.semi_hidden property