Compartilhar via

Office.SetSelectedDataOptions interface

Pacote:
office

Fornece opções para inserir dados na seleção.

Comentários

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/export-import-slide.yaml

async function addImageToCurrentSlide(
  imageBase64: string,
  options?: PowerPoint.ShapeAddOptions
): Promise<PowerPoint.Shape> {
  // Adds an image to the current slide.
  const setSelectedDataOptions: Office.SetSelectedDataOptions = {
    coercionType: Office.CoercionType.Image
  };
  if (options) {
    if (options.height) {
      setSelectedDataOptions.imageHeight = options.height;
    }
    if (options.left) {
      setSelectedDataOptions.imageLeft = options.left;
    }
    if (options.top) {
      setSelectedDataOptions.imageTop = options.top;
    }
    if (options.width) {
      setSelectedDataOptions.imageWidth = options.width;
    }
  }

  return new Promise((resolve, reject) => {
    Office.context.document.setSelectedDataAsync(
      imageBase64,
      setSelectedDataOptions,
      async (result: Office.AsyncResult<void>) => {
        if (result.error) {
          console.error(`ERROR in setSelectedDataAsync(): ${result.error}`);
          reject(result.error);
        } else {
          const shape = await PowerPoint.run(async (context) => {
            const slide = context.presentation.getSelectedSlides().getItemAt(0);
            slide.shapes.load();
            await context.sync();

            return slide.shapes.items[slide.shapes.items.length - 1];
          });
          resolve(shape);
        }
      }
    );
  });
}

Propriedades

asyncContext

Um item definido pelo utilizador de qualquer tipo que seja devolvido, inalterado, na propriedade asyncContext do objeto AsyncResult que é transmitido a uma chamada de retorno.
cellFormat

Utilize apenas com a tabela de tipo de enlace e quando for transmitido um objeto TableData para o parâmetro de dados. Uma matriz de objetos que especifica um intervalo de colunas, linhas ou células e especifica, como pares chave-valor, a formatação de célula a aplicar a esse intervalo.

Exemplo: [{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]
coercionType

Define explicitamente a forma do objeto de dados. Se não for fornecido, é inferido do tipo de dados.
imageHeight

Esta opção se aplica à inserção de imagens. Indica a altura da imagem. Se esta opção for fornecida sem o imageWidth, a imagem será dimensionada para corresponder ao valor da altura da imagem. Se forem fornecidas a largura e a altura da imagem, a imagem será redimensionada de acordo. Se nem a altura, nem a largura da imagem forem fornecidas, o tamanho da imagem e a taxa de proporção padrão serão usados. Este valor está em pontos.
imageLeft

Esta opção se aplica à inserção de imagens. Indica o local de inserção em relação ao lado esquerdo do slide do PowerPoint e sua relação com a célula atualmente selecionada no Excel. Este valor é ignorado para o Word. Este valor está em pontos.
imageTop

Esta opção se aplica à inserção de imagens. Indica a localização de inserção em relação à parte superior do diapositivo do PowerPoint e a respetiva relação com a célula atualmente selecionada no Excel. Este valor é ignorado para o Word. Este valor está em pontos.
imageWidth

Esta opção se aplica à inserção de imagens. Indica a largura da imagem. Se esta opção for fornecida sem o imageHeight, a imagem será dimensionada para corresponder ao valor da largura da imagem. Se forem fornecidas a largura e a altura da imagem, a imagem será redimensionada de acordo. Se nem a altura, nem a largura da imagem forem fornecidas, o tamanho da imagem e a taxa de proporção padrão serão usados. Este valor está em pontos.
tableOptions

Para uma tabela inserida, uma lista de pares chave-valor que especificam opções de formatação de tabela, como linha de cabeçalho, linha total e linhas listadas. Exemplo: {bandedRows: true, filterButton: false}

Detalhes da propriedade

asyncContext

Um item definido pelo utilizador de qualquer tipo que seja devolvido, inalterado, na propriedade asyncContext do objeto AsyncResult que é transmitido a uma chamada de retorno.

asyncContext?: any

Valor da propriedade

any

cellFormat

Utilize apenas com a tabela de tipo de enlace e quando for transmitido um objeto TableData para o parâmetro de dados. Uma matriz de objetos que especifica um intervalo de colunas, linhas ou células e especifica, como pares chave-valor, a formatação de célula a aplicar a esse intervalo.

Exemplo: [{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]

cellFormat?: RangeFormatConfiguration[]

Valor da propriedade

Office.RangeFormatConfiguration[]

coercionType

Define explicitamente a forma do objeto de dados. Se não for fornecido, é inferido do tipo de dados.

coercionType?: Office.CoercionType | string

Valor da propriedade

Office.CoercionType | string

imageHeight

Esta opção se aplica à inserção de imagens. Indica a altura da imagem. Se esta opção for fornecida sem o imageWidth, a imagem será dimensionada para corresponder ao valor da altura da imagem. Se forem fornecidas a largura e a altura da imagem, a imagem será redimensionada de acordo. Se nem a altura, nem a largura da imagem forem fornecidas, o tamanho da imagem e a taxa de proporção padrão serão usados. Este valor está em pontos.

imageHeight?: number

Valor da propriedade

number

imageLeft

Esta opção se aplica à inserção de imagens. Indica o local de inserção em relação ao lado esquerdo do slide do PowerPoint e sua relação com a célula atualmente selecionada no Excel. Este valor é ignorado para o Word. Este valor está em pontos.

imageLeft?: number

Valor da propriedade

number

imageTop

Esta opção se aplica à inserção de imagens. Indica a localização de inserção em relação à parte superior do diapositivo do PowerPoint e a respetiva relação com a célula atualmente selecionada no Excel. Este valor é ignorado para o Word. Este valor está em pontos.

imageTop?: number

Valor da propriedade

number

imageWidth

Esta opção se aplica à inserção de imagens. Indica a largura da imagem. Se esta opção for fornecida sem o imageHeight, a imagem será dimensionada para corresponder ao valor da largura da imagem. Se forem fornecidas a largura e a altura da imagem, a imagem será redimensionada de acordo. Se nem a altura, nem a largura da imagem forem fornecidas, o tamanho da imagem e a taxa de proporção padrão serão usados. Este valor está em pontos.

imageWidth?: number

Valor da propriedade

number

tableOptions

Para uma tabela inserida, uma lista de pares chave-valor que especificam opções de formatação de tabela, como linha de cabeçalho, linha total e linhas listadas. Exemplo: {bandedRows: true, filterButton: false}

tableOptions?: object

Valor da propriedade

object