Поделиться через

Word.Style class

  • Ссылка
Пакет:
word

Представляет стиль в документе Word.

Extends
OfficeExtension.ClientObject

Комментарии

[ Набор API: WordApi 1.3 ]

Примеры

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

// Applies the specified style to a paragraph.
await Word.run(async (context) => {
  const styleName = $("#style-name-to-use").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to apply.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else if (style.type != Word.StyleType.paragraph) {
    console.log(`The '${styleName}' style isn't a paragraph style.`);
  } else {
    const body: Word.Body = context.document.body;
    body.clear();
    body.insertParagraph(
      "Do you want to create a solution that extends the functionality of Word? You can use the Office Add-ins platform to extend Word clients running on the web, on a Windows desktop, or on a Mac.",
      "Start"
    );
    const paragraph: Word.Paragraph = body.paragraphs.getFirst();
    paragraph.style = style.nameLocal;
    console.log(`'${styleName}' style applied to first paragraph.`);
  }
});

Свойства

baseStyle

Указывает имя существующего стиля, используемого в качестве базового форматирования другого стиля.
borders

Указывает объект BorderCollection, представляющий все границы для указанного стиля.
builtIn

Возвращает значение, указывающее, является ли указанный стиль встроенным.
context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.
description

Возвращает описание указанного стиля.
font

Возвращает объект шрифта, представляющий форматирование символов указанного стиля.
inUse

Возвращает значение, указывающее, является ли указанный стиль встроенным стилем, который был изменен или применен в документе, или новым стилем, созданным в документе.
linked

Возвращает значение, указывающее, является ли стиль связанным стилем, который можно использовать как для форматирования абзаца, так и для символов.
listTemplate

Возвращает объект ListTemplate, представляющий форматирование списка для указанного объекта Style.
nameLocal

Возвращает имя стиля на языке пользователя.
nextParagraphStyle

Задает имя стиля, который будет автоматически применен к новому абзацу, который вставляется после абзаца, отформатированного с указанным стилем.
paragraphFormat

Возвращает объект ParagraphFormat, представляющий параметры абзаца для указанного стиля.
priority

Указывает приоритет.
quickStyle

Указывает, соответствует ли стиль доступному быстрому стилю.
shading

Возвращает объект shading, представляющий затенение для указанного стиля. Неприменимо к стилю списка.
tableStyle

Возвращает объект TableStyle, представляющий свойства Style, которые можно применить к таблице.
type

Возвращает тип стиля.
unhideWhenUsed

Указывает, будет ли указанный стиль отображаться в качестве рекомендуемого стиля в области стилей и задач Стили в Microsoft Word после его использования в документе.
visibility

Указывает, отображается ли указанный стиль в качестве рекомендуемого стиля в коллекции Стили и в области задач Стили.

Методы

delete()

Удаляет стиль.
load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.
set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.
toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.Style объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Word.Interfaces.StyleData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.
track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта. Если этот объект является частью коллекции, следует также отслеживать родительскую коллекцию.
untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

Сведения о свойстве

baseStyle

Указывает имя существующего стиля, используемого в качестве базового форматирования другого стиля.

baseStyle: string;

Значение свойства

string

Комментарии

[ Набор API: WordApi 1.5 ]

Примечание. Возможность установки baseStyle появилась в WordApi 1.6.

borders

Указывает объект BorderCollection, представляющий все границы для указанного стиля.

readonly borders: Word.BorderCollection;

Значение свойства

Word.BorderCollection

Комментарии

[ Набор API: WordApiDesktop 1.1 ]

Примеры

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

// Updates border properties (e.g., type, width, color) of the specified style.
await Word.run(async (context) => {
  const styleName = $("#style-name").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to update border properties.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else {
    const borders: Word.BorderCollection = style.borders;
    borders.load("items");
    await context.sync();

    borders.outsideBorderType = Word.BorderType.dashed;
    borders.outsideBorderWidth = Word.BorderWidth.pt025;
    borders.outsideBorderColor = "green";
    console.log("Updated outside borders.");
  }
});

builtIn

Возвращает значение, указывающее, является ли указанный стиль встроенным.

readonly builtIn: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.

context: RequestContext;

Значение свойства

Word.RequestContext

description

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Возвращает описание указанного стиля.

readonly description: string;

Значение свойства

string

Комментарии

[ Набор API: WordApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ) ]

font

Возвращает объект шрифта, представляющий форматирование символов указанного стиля.

readonly font: Word.Font;

Значение свойства

Word.Font

Комментарии

[ Набор API: WordApi 1.5 ]

Примеры

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

// Updates font properties (e.g., color, size) of the specified style.
await Word.run(async (context) => {
  const styleName = $("#style-name").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to update font properties.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else {
    const font: Word.Font = style.font;
    font.color = "#FF0000";
    font.size = 20;
    console.log(`Successfully updated font properties of the '${styleName}' style.`);
  }
});

inUse

Возвращает значение, указывающее, является ли указанный стиль встроенным стилем, который был изменен или применен в документе, или новым стилем, созданным в документе.

readonly inUse: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

linked

Возвращает значение, указывающее, является ли стиль связанным стилем, который можно использовать как для форматирования абзаца, так и для символов.

readonly linked: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

listTemplate

Возвращает объект ListTemplate, представляющий форматирование списка для указанного объекта Style.

readonly listTemplate: Word.ListTemplate;

Значение свойства

Word.ListTemplate

Комментарии

[ Набор API: WordApiDesktop 1.1 ]

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/manage-list-styles.yaml

// Gets the properties of the specified style.
await Word.run(async (context) => {
  const styleName = $("#style-name-to-use").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to get properties.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load("type");
  await context.sync();

  if (style.isNullObject || style.type != Word.StyleType.list) {
    console.warn(`There's no existing style with the name '${styleName}'. Or this isn't a list style.`);
  } else {
    // Load objects to log properties and their values in the console.
    style.load();
    style.listTemplate.load();
    await context.sync();

    console.log(`Properties of the '${styleName}' style:`, style);

    const listLevels = style.listTemplate.listLevels;
    listLevels.load("items");
    await context.sync();

    console.log(`List levels of the '${styleName}' style:`, listLevels);
  }
});

nameLocal

Возвращает имя стиля на языке пользователя.

readonly nameLocal: string;

Значение свойства

string

Комментарии

[ Набор API: WordApi 1.5 ]

Примеры

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

// Applies the specified style to a paragraph.
await Word.run(async (context) => {
  const styleName = $("#style-name-to-use").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to apply.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else if (style.type != Word.StyleType.paragraph) {
    console.log(`The '${styleName}' style isn't a paragraph style.`);
  } else {
    const body: Word.Body = context.document.body;
    body.clear();
    body.insertParagraph(
      "Do you want to create a solution that extends the functionality of Word? You can use the Office Add-ins platform to extend Word clients running on the web, on a Windows desktop, or on a Mac.",
      "Start"
    );
    const paragraph: Word.Paragraph = body.paragraphs.getFirst();
    paragraph.style = style.nameLocal;
    console.log(`'${styleName}' style applied to first paragraph.`);
  }
});

nextParagraphStyle

Задает имя стиля, который будет автоматически применен к новому абзацу, который вставляется после абзаца, отформатированного с указанным стилем.

nextParagraphStyle: string;

Значение свойства

string

Комментарии

[ Набор API: WordApi 1.5 ]

Примечание. Возможность установки nextParagraphStyle появилась в WordApi 1.6.

paragraphFormat

Возвращает объект ParagraphFormat, представляющий параметры абзаца для указанного стиля.

readonly paragraphFormat: Word.ParagraphFormat;

Значение свойства

Word.ParagraphFormat

Комментарии

[ Набор API: WordApi 1.5 ]

Примеры

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

// Sets certain aspects of the specified style's paragraph format e.g., the left indent size and the alignment.
await Word.run(async (context) => {
  const styleName = $("#style-name").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to update its paragraph format.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else {
    style.paragraphFormat.leftIndent = 30;
    style.paragraphFormat.alignment = Word.Alignment.centered;
    console.log(`Successfully the paragraph format of the '${styleName}' style.`);
  }
});

priority

Указывает приоритет.

priority: number;

Значение свойства

number

Комментарии

[ Набор API: WordApi 1.5 ]

quickStyle

Указывает, соответствует ли стиль доступному быстрому стилю.

quickStyle: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

shading

Возвращает объект shading, представляющий затенение для указанного стиля. Неприменимо к стилю списка.

readonly shading: Word.Shading;

Значение свойства

Word.Shading

Комментарии

[ Набор API: WordApi 1.6 ]

Примеры

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

// Updates shading properties (e.g., texture, pattern colors) of the specified style.
await Word.run(async (context) => {
  const styleName = $("#style-name").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to update shading properties.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else {
    const shading: Word.Shading = style.shading;
    shading.load();
    await context.sync();

    shading.backgroundPatternColor = "blue";
    shading.foregroundPatternColor = "yellow";
    shading.texture = Word.ShadingTextureType.darkTrellis;

    console.log("Updated shading.");
  }
});

tableStyle

Возвращает объект TableStyle, представляющий свойства Style, которые можно применить к таблице.

readonly tableStyle: Word.TableStyle;

Значение свойства

Word.TableStyle

Комментарии

[ Набор API: WordApi 1.6 ]

type

Возвращает тип стиля.

readonly type: Word.StyleType | "Character" | "List" | "Paragraph" | "Table";

Значение свойства

Word.StyleType | "Character" | "List" | "Paragraph" | "Table"

Комментарии

[ Набор API: WordApi 1.5 ]

unhideWhenUsed

Указывает, будет ли указанный стиль отображаться в качестве рекомендуемого стиля в области стилей и задач Стили в Microsoft Word после его использования в документе.

unhideWhenUsed: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

visibility

Указывает, отображается ли указанный стиль в качестве рекомендуемого стиля в коллекции Стили и в области задач Стили.

visibility: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: WordApi 1.5 ]

Сведения о методе

delete()

Удаляет стиль.

delete(): void;

Возвращаемое значение

void

Комментарии

[ Набор API: WordApi 1.5 ]

Примеры

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

// Deletes the custom style.
await Word.run(async (context) => {
  const styleName = $("#style-name-to-delete").val() as string;
  if (styleName == "") {
    console.warn("Enter a style name to delete.");
    return;
  }

  const style: Word.Style = context.document.getStyles().getByNameOrNullObject(styleName);
  style.load();
  await context.sync();

  if (style.isNullObject) {
    console.warn(`There's no existing style with the name '${styleName}'.`);
  } else {
    style.delete();
    console.log(`Successfully deleted custom style '${styleName}'.`);
  }
});

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(options?: Word.Interfaces.StyleLoadOptions): Word.Style;

Параметры

options
Word.Interfaces.StyleLoadOptions

Предоставляет параметры свойств объекта для загрузки.

Возвращаемое значение

Word.Style

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames?: string | string[]): Word.Style;

Параметры

propertyNames

string | string[]

Строка с разделителями-запятыми или массив строк, указывающих свойства для загрузки.

Возвращаемое значение

Word.Style

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.Style;

Параметры

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и propertyNamesAndPaths.expand строка с разделителями-запятыми, указывающая загружаемые свойства навигации.

Возвращаемое значение

Word.Style

set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.

set(properties: Interfaces.StyleUpdateData, options?: OfficeExtension.UpdateOptions): void;

Параметры

properties
Word.Interfaces.StyleUpdateData

Объект JavaScript со свойствами, структурированными изоморфно по свойствам объекта, для которого вызывается метод .

options
OfficeExtension.UpdateOptions

Предоставляет возможность подавления ошибок, если объект свойств пытается задать какие-либо свойства, доступные только для чтения.

Возвращаемое значение

void

set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.

set(properties: Word.Style): void;

Параметры

properties
Word.Style

Возвращаемое значение

void

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.Style объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Word.Interfaces.StyleData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.

toJSON(): Word.Interfaces.StyleData;

Возвращаемое значение

Word.Interfaces.StyleData

track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта. Если этот объект является частью коллекции, следует также отслеживать родительскую коллекцию.

track(): Word.Style;

Возвращаемое значение

Word.Style

untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

untrack(): Word.Style;

Возвращаемое значение

Word.Style