changeParagraphStyle

This function modifies the visual style of the specified paragraph.

Prompts

• Change the style of paragraph 2 to Heading 1

Function registration

let func = new RegisteredFunction({
    name: "changeParagraphStyle",
    description: "Modifies the visual style of the specified paragraph.",
    parameters: {
        type: "object",
        properties: {
            parNumber: {
                type: "number",
                description: "The paragraph number to apply style changes to.",
            },
            style: {
                type: "string",
                description:
                    "The style name to apply to the paragraph (e.g., 'Heading 1').",
            },
        },
        required: ["parNumber", "style"],
    },
    examples: [
        {
            prompt: "Change the style of paragraph 3 to Heading 1",
            arguments: { parNumber: 3, style: "Heading 1" },
        },
        {
            prompt: "Change the style of paragraph 2 to Heading 1",
            arguments: { parNumber: 2, style: "Heading 1" },
        },
    ],
});

Parameters

Name	Type	Example	Description
parNumber	number	3	The number of the paragraph to apply style changes to.
style	string	"Heading 1"	The style name to apply to the paragraph.

Function execution

func.call = async function (params) {
        Asc.scope.parNumber = params.parNumber;
        Asc.scope.styleName = params.style;
        await Asc.Editor.callCommand(function () {
            let doc = Api.GetDocument();
            let par = doc.GetElement(Asc.scope.parNumber - 1);
            if (!par) return;

            let style = doc.GetStyle(Asc.scope.styleName);
            par.SetStyle(style);
    });
};

Methods used: GetDocument, GetElement, GetStyle, SetStyle, Asc.scope object

Result