PowerPoint.SlideBackgroundFill class

Пакет:: powerpoint

Представляет форматирование заливки объекта фона слайда.

Extends: OfficeExtension.ClientObject

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Gets the background fill type of the first selected slide.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  const fill: PowerPoint.SlideBackgroundFill = slide.background.fill;
  fill.load("type");
  await context.sync();

  const fillType = fill.type as PowerPoint.SlideBackgroundFillType;
  console.log(`Background fill type: ${fillType}`);
});

Свойства

context	Контекст запроса, связанный с объектом. Это соединяет процесс надстройки с процессом основного приложения Office.
type	Возвращает тип заливки фона слайда. Дополнительные сведения см. в разделе PowerPoint.SlideBackgroundFillType .

Методы

getGradientFillOrNullObject()	Получает свойства градиентной заливки. Если тип заливки не `gradient`является , возвращается объект со свойством, установленным `isNullObject` в значение.`true` Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getPatternFillOrNullObject()	Получает свойства заливки с рисунком. Если тип заливки не `pattern`является , возвращается объект со свойством, установленным `isNullObject` в значение.`true` Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getPictureOrTextureFillOrNullObject()	Получает свойства заливки рисунка или текстуры. Если тип заливки не `pictureOrTexture`является , возвращается объект со свойством, установленным `isNullObject` в значение.`true` Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getSolidFillOrNullObject()	Получает свойства сплошной заливки. Если тип заливки не `solid`является , возвращается объект со свойством, установленным `isNullObject` в значение.`true` Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
load(options)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод `context.sync()`.
load(propertyNames)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод `context.sync()`.
load(propertyNamesAndPaths)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод `context.sync()`.
setGradientFill(options)	Градиентная заливка фона слайда. При этом тип заливки будет изменен на `gradient`.
setPatternFill(options)	Задает форматирование заливки фона слайда с узором. При этом тип заливки будет изменен на `pattern`.
setPictureOrTextureFill(options)	Задает форматирование заливки фона слайда на заливку рисунка или текстуры. При этом тип заливки будет изменен на `pictureOrTexture`.
setSolidFill(options)	Сплошная заливка фона слайда. При этом тип заливки будет изменен на `solid`.
toJSON()	Переопределяет метод JavaScript `toJSON()` , чтобы обеспечить более полезные выходные данные при передаче объекта API в `JSON.stringify()`. (`JSON.stringify`, в свою очередь, вызывает `toJSON` метод переданного ему объекта.) В то время как исходный `PowerPoint.SlideBackgroundFill` объект является объектом API, `toJSON` метод возвращает простой объект JavaScript (типизированный как `PowerPoint.Interfaces.SlideBackgroundFillData`), который содержит неглубокие копии любых загруженных дочерних свойств исходного объекта.

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

context

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

context: RequestContext;

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

PowerPoint.RequestContext

type

Возвращает тип заливки фона слайда. Дополнительные сведения см. в разделе PowerPoint.SlideBackgroundFillType .

readonly type: PowerPoint.SlideBackgroundFillType | "Unsupported" | "Solid" | "Gradient" | "PictureOrTexture" | "Pattern";

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

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

getGradientFillOrNullObject()

Получает свойства градиентной заливки. Если тип заливки не gradientявляется , возвращается объект со свойством, установленным isNullObject в значение.true Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getGradientFillOrNullObject(): PowerPoint.SlideBackgroundGradientFill;

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

PowerPoint.SlideBackgroundGradientFill

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Gets the gradient fill properties of the first selected slide's background.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  const fill: PowerPoint.SlideBackgroundFill = slide.background.fill;
  fill.load("type");
  await context.sync();

  if (fill.type !== PowerPoint.SlideBackgroundFillType.gradient) {
    console.warn("The slide background isn't a gradient fill.");
    return;
  }

  const gradientFill: PowerPoint.SlideBackgroundGradientFill = slide.background.fill.getGradientFillOrNullObject();
  gradientFill.load("type");
  await context.sync();

  if (gradientFill.isNullObject) {
    console.warn("The slide background isn't a gradient fill.");
  } else {
    console.log("Gradient fill:", `- type: ${gradientFill.type}`);
  }
});

getPatternFillOrNullObject()

Получает свойства заливки с рисунком. Если тип заливки не patternявляется , возвращается объект со свойством, установленным isNullObject в значение.true Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getPatternFillOrNullObject(): PowerPoint.SlideBackgroundPatternFill;

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

PowerPoint.SlideBackgroundPatternFill

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Gets the pattern fill properties of the first selected slide's background.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  const fill: PowerPoint.SlideBackgroundFill = slide.background.fill;
  fill.load("type");
  await context.sync();

  if (fill.type !== PowerPoint.SlideBackgroundFillType.pattern) {
    console.warn("The slide background isn't a pattern fill.");
    return;
  }

  const patternFill: PowerPoint.SlideBackgroundPatternFill = slide.background.fill.getPatternFillOrNullObject();
  patternFill.load(["foregroundColor", "backgroundColor", "pattern"]);
  await context.sync();

  if (patternFill.isNullObject) {
    console.warn("The slide background isn't a pattern fill.");
  } else {
    console.log(
      "Pattern fill:",
      `- foregroundColor: ${patternFill.foregroundColor}`,
      `- backgroundColor: ${patternFill.backgroundColor}`,
      `- pattern: ${patternFill.pattern}`,
    );
  }
});

getPictureOrTextureFillOrNullObject()

Получает свойства заливки рисунка или текстуры. Если тип заливки не pictureOrTextureявляется , возвращается объект со свойством, установленным isNullObject в значение.true Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getPictureOrTextureFillOrNullObject(): PowerPoint.SlideBackgroundPictureOrTextureFill;

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

PowerPoint.SlideBackgroundPictureOrTextureFill

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Gets the picture or texture fill properties of the first selected slide's background.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  const fill: PowerPoint.SlideBackgroundFill = slide.background.fill;
  fill.load("type");
  await context.sync();

  if (fill.type !== PowerPoint.SlideBackgroundFillType.pictureOrTexture) {
    console.warn("The slide background isn't a picture or texture fill.");
    return;
  }

  const pictureFill: PowerPoint.SlideBackgroundPictureOrTextureFill =
    slide.background.fill.getPictureOrTextureFillOrNullObject();
  pictureFill.load("transparency");
  await context.sync();

  if (pictureFill.isNullObject) {
    console.warn("The slide background isn't a picture or texture fill.");
  } else {
    console.log("Picture or texture fill:", `- transparency: ${pictureFill.transparency}`);
  }
});

getSolidFillOrNullObject()

Получает свойства сплошной заливки. Если тип заливки не solidявляется , возвращается объект со свойством, установленным isNullObject в значение.true Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getSolidFillOrNullObject(): PowerPoint.SlideBackgroundSolidFill;

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

PowerPoint.SlideBackgroundSolidFill

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Gets the solid fill properties of the first selected slide's background.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  const fill: PowerPoint.SlideBackgroundFill = slide.background.fill;
  fill.load("type");
  await context.sync();

  if (fill.type !== PowerPoint.SlideBackgroundFillType.solid) {
    console.warn("The slide background isn't a solid fill.");
    return;
  }

  const solidFill: PowerPoint.SlideBackgroundSolidFill = slide.background.fill.getSolidFillOrNullObject();
  solidFill.load(["color", "transparency"]);
  await context.sync();

  if (solidFill.isNullObject) {
    console.warn("The slide background isn't a solid fill.");
  } else {
    console.log("Solid fill:", `- color: ${solidFill.color}`, `- transparency: ${solidFill.transparency}`);
  }
});

load(options)

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

load(options?: PowerPoint.Interfaces.SlideBackgroundFillLoadOptions): PowerPoint.SlideBackgroundFill;

Параметры

options: PowerPoint.Interfaces.SlideBackgroundFillLoadOptions

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

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

PowerPoint.SlideBackgroundFill

load(propertyNames)

load(propertyNames?: string | string[]): PowerPoint.SlideBackgroundFill;

Параметры

propertyNames: string | string[]

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

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

PowerPoint.SlideBackgroundFill

load(propertyNamesAndPaths)

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.SlideBackgroundFill;

Параметры

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

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

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

PowerPoint.SlideBackgroundFill

setGradientFill(options)

Градиентная заливка фона слайда. При этом тип заливки будет изменен на gradient.

setGradientFill(options?: PowerPoint.SlideBackgroundGradientFillOptions): void;

Параметры

options: PowerPoint.SlideBackgroundGradientFillOptions

Параметры градиентной заливки.

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

void

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Sets the background of the first selected slide to a linear gradient fill.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  slide.background.fill.setGradientFill({
    type: PowerPoint.SlideBackgroundGradientFillType.linear,
  } as PowerPoint.SlideBackgroundGradientFillOptions);
  await context.sync();

  console.log("Background set to linear gradient fill.");
});

setPatternFill(options)

Задает форматирование заливки фона слайда с узором. При этом тип заливки будет изменен на pattern.

setPatternFill(options?: PowerPoint.SlideBackgroundPatternFillOptions): void;

Параметры

options: PowerPoint.SlideBackgroundPatternFillOptions

Параметры заливки с рисунком.

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

void

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Sets the background of the first selected slide to a diagonal cross pattern fill.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  slide.background.fill.setPatternFill({
    foregroundColor: "#1F3864",
    backgroundColor: "#D6E4F7",
    pattern: PowerPoint.SlideBackgroundPatternFillType.diagonalCross,
  } as PowerPoint.SlideBackgroundPatternFillOptions);
  await context.sync();

  console.log("Background set to diagonal cross pattern fill.");
});

setPictureOrTextureFill(options)

Задает форматирование заливки фона слайда на заливку рисунка или текстуры. При этом тип заливки будет изменен на pictureOrTexture.

setPictureOrTextureFill(options?: PowerPoint.SlideBackgroundPictureOrTextureFillOptions): void;

Параметры

options: PowerPoint.SlideBackgroundPictureOrTextureFillOptions

Параметры заливки рисунка или текстуры.

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

void

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Sets the background of the first selected slide to a picture fill at 60% transparency.
// Uses a sample image from a Base64-encoded string.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  slide.background.fill.setPictureOrTextureFill({
    imageBase64: getSampleImageAsBase64String(),
    transparency: 0.6,
  } as PowerPoint.SlideBackgroundPictureOrTextureFillOptions);
  await context.sync();

  console.log("Background set to picture fill (60% transparent).");
});

setSolidFill(options)

Сплошная заливка фона слайда. При этом тип заливки будет изменен на solid.

setSolidFill(options?: PowerPoint.SlideBackgroundSolidFillOptions): void;

Параметры

options: PowerPoint.SlideBackgroundSolidFillOptions

Параметры сплошной заливки.

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

void

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-background-fill.yaml

// Sets the background of the first selected slide to a solid orange fill at 20% transparency.
await PowerPoint.run(async (context) => {
  const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
  slide.background.fill.setSolidFill({
    color: "#FF8C00",
    transparency: 0.2,
  } as PowerPoint.SlideBackgroundSolidFillOptions);
  await context.sync();

  console.log("Background set to solid orange fill (20% transparent).");
});

toJSON()

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

toJSON(): PowerPoint.Interfaces.SlideBackgroundFillData;

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

PowerPoint.Interfaces.SlideBackgroundFillData

Обратная связь

Были ли сведения на этой странице полезными?

PowerPoint.SlideBackgroundFill class

Комментарии

Используется

Примеры

Свойства

Методы

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

context

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

type

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

Комментарии

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

getGradientFillOrNullObject()

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

Комментарии

Примеры

getPatternFillOrNullObject()

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

Комментарии

Примеры

getPictureOrTextureFillOrNullObject()

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

Комментарии

Примеры

getSolidFillOrNullObject()

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

Комментарии

Примеры

load(options)

Параметры

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

load(propertyNames)

Параметры

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

load(propertyNamesAndPaths)

Параметры

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

setGradientFill(options)

Параметры

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

Комментарии

Примеры

setPatternFill(options)

Параметры

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

Комментарии

Примеры

setPictureOrTextureFill(options)

Параметры

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

Комментарии

Примеры

setSolidFill(options)

Параметры

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

Комментарии

Примеры

toJSON()

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

Обратная связь