Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Word.Critique interface

Package:
word

Critique that will be rendered as underline for the specified part of paragraph in the document.

Remarks

API set: WordApi 1.7

Used by

Examples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/50-document/manage-annotations.yaml

// Adds annotations to the selected paragraph.
await Word.run(async (context) => {
 const paragraph: Word.Paragraph = context.document.getSelection().paragraphs.getFirst();
 const options: Word.CritiquePopupOptions = {
 brandingTextResourceId: "PG.TabLabel",
 subtitleResourceId: "PG.HelpCommand.TipTitle",
 titleResourceId: "PG.HelpCommand.Label",
 suggestions: ["suggestion 1", "suggestion 2", "suggestion 3"]
 };
 const critique1: Word.Critique = {
 colorScheme: Word.CritiqueColorScheme.red,
 start: 1,
 length: 3,
 popupOptions: options
 };
 const critique2: Word.Critique = {
 colorScheme: Word.CritiqueColorScheme.green,
 start: 6,
 length: 1,
 popupOptions: options
 };
 const critique3: Word.Critique = {
 colorScheme: Word.CritiqueColorScheme.blue,
 start: 10,
 length: 3,
 popupOptions: options
 };
 const critique4: Word.Critique = {
 colorScheme: Word.CritiqueColorScheme.lavender,
 start: 14,
 length: 3,
 popupOptions: options
 };
 const critique5: Word.Critique = {
 colorScheme: Word.CritiqueColorScheme.berry,
 start: 18,
 length: 10,
 popupOptions: options
 };
 const annotationSet: Word.AnnotationSet = {
 critiques: [critique1, critique2, critique3, critique4, critique5]
 };

 const annotationIds = paragraph.insertAnnotations(annotationSet);

 await context.sync();

 console.log("Annotations inserted:", annotationIds.value);
});

Properties

colorScheme

Specifies the color scheme of the critique.

length

Specifies the length of the critique inside paragraph.

popupOptions

Specifies the behavior of the pop-up menu for the critique.

start

Specifies the start index of the critique inside paragraph.

Property Details

colorScheme

Specifies the color scheme of the critique.

colorScheme: Word.CritiqueColorScheme | "Red" | "Green" | "Blue" | "Lavender" | "Berry";

Property Value

Word.CritiqueColorScheme | "Red" | "Green" | "Blue" | "Lavender" | "Berry"

Remarks

API set: WordApi 1.7

length

Specifies the length of the critique inside paragraph.

length: number;

Property Value

number

Remarks

API set: WordApi 1.7

popupOptions

Specifies the behavior of the pop-up menu for the critique.

popupOptions?: Word.CritiquePopupOptions;

Property Value

Remarks

API set: WordApi 1.8

start

Specifies the start index of the critique inside paragraph.

start: number;

Property Value

number

Remarks

API set: WordApi 1.7


Feedback

Was this page helpful?