ExcelScript.DocumentProperties interface

Pacote:

ExcelScript

Representa as propriedades do livro.

Comentários

Exemplos

/**
 * This script creates a new worksheet that displays some of the document properties.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the document properties.
    const properties: ExcelScript.DocumentProperties = workbook.getProperties();

    // Create a new worksheet called "Metadata".
    const newWorksheet = workbook.addWorksheet("Metadata");
    
    // Create an array to store the string values of properties to save.
    let values: string[][] = [];
    values.push(["Creation Date", properties.getCreationDate().toString()]);
    values.push(["Author", properties.getAuthor()]);
    values.push(["Last Edited By", properties.getLastAuthor()]);
    
    // Set the property values to a range on the new worksheet.
    newWorksheet.getRange("A1:B3").setValues(values);
}

Métodos

addCustomProperty(key, value)	Cria uma nova propriedade personalizada ou define uma existente.
deleteAllCustomProperties()	Exclui todas as propriedades personalizadas nesta coleção.
getAuthor()	O autor do livro.
getCategory()	A categoria do livro.
getComments()	Os comentários do livro.
getCompany()	A empresa do livro.
getCreationDate()	Obtém a data de criação da pasta de trabalho.
getCustom()	Obtém a coleção de propriedades personalizadas da pasta de trabalho.
getCustomProperty(key)	Obtém um objeto de propriedade personalizada por sua chave, que diferencia maiúsculas de minúsculas. Se a propriedade personalizada não existir, este método devolve undefined.
getKeywords()	As palavras-chave do livro.
getLastAuthor()	Obtém o último autor da pasta de trabalho.
getManager()	O gestor do livro.
getRevisionNumber()	Obtém o número de revisão da pasta de trabalho.
getSubject()	O assunto do livro.
getTitle()	O título do livro.
setAuthor(author)	O autor do livro.
setCategory(category)	A categoria do livro.
setComments(comments)	Os comentários do livro.
setCompany(company)	A empresa do livro.
setKeywords(keywords)	As palavras-chave do livro.
setManager(manager)	O gestor do livro.
setRevisionNumber(revisionNumber)	Obtém o número de revisão da pasta de trabalho.
setSubject(subject)	O assunto do livro.
setTitle(title)	O título do livro.

Detalhes do método

addCustomProperty(key, value)

Cria uma nova propriedade personalizada ou define uma existente.

addCustomProperty(key: string, value: any): CustomProperty;

Parâmetros

key

string

Obrigatório. A chave da propriedade personalizada, que não é sensível a maiúsculas e minúsculas. A chave está limitada a 255 carateres fora do Excel na Web (as teclas maiores são automaticamente cortadas para 255 carateres noutras plataformas).

value

any

Obrigatório. O valor da propriedade personalizada. O valor está limitado a 255 carateres fora de Excel na Web (os valores maiores são automaticamente reduzidos para 255 carateres noutras plataformas).

Retornos

ExcelScript.CustomProperty

Exemplos

/**
 * This script adds a workbook-level custom property.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the property collection.
  const properties = workbook.getProperties();

  // Add a new property called "Project" with the value "FA".
  properties.addCustomProperty("Project", "FA");
}

deleteAllCustomProperties()

Exclui todas as propriedades personalizadas nesta coleção.

deleteAllCustomProperties(): void;

Retornos

void

getAuthor()

O autor do livro.

getAuthor(): string;

Retornos

string

getCategory()

A categoria do livro.

getCategory(): string;

Retornos

string

getComments()

Os comentários do livro.

getComments(): string;

Retornos

string

getCompany()

A empresa do livro.

getCompany(): string;

Retornos

string

getCreationDate()

Obtém a data de criação da pasta de trabalho.

getCreationDate(): Date;

Retornos

Date

getCustom()

Obtém a coleção de propriedades personalizadas da pasta de trabalho.

getCustom(): CustomProperty[];

Retornos

ExcelScript.CustomProperty[]

getCustomProperty(key)

Obtém um objeto de propriedade personalizada por sua chave, que diferencia maiúsculas de minúsculas. Se a propriedade personalizada não existir, este método devolve undefined.

getCustomProperty(key: string): CustomProperty | undefined;

Parâmetros

key

string

Obrigatório. A chave que identifica o objeto de propriedade personalizada.

Retornos

ExcelScript.CustomProperty | undefined

Exemplos

/**
 * This script gets a workbook-level custom property called "Project".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the property collection.
  const properties = workbook.getProperties();

  // Get the "Project" property.
  const project = properties.getCustomProperty("Project");

  // Show the property value in the console.
  console.log(project.getValue());
}

getKeywords()

As palavras-chave do livro.

getKeywords(): string;

Retornos

string

getLastAuthor()

Obtém o último autor da pasta de trabalho.

getLastAuthor(): string;

Retornos

string

getManager()

O gestor do livro.

getManager(): string;

Retornos

string

getRevisionNumber()

Obtém o número de revisão da pasta de trabalho.

getRevisionNumber(): number;

Retornos

number

getSubject()

O assunto do livro.

getSubject(): string;

Retornos

string

getTitle()

O título do livro.

getTitle(): string;

Retornos

string

setAuthor(author)

O autor do livro.

setAuthor(author: string): void;

Parâmetros

author

string

Retornos

void

setCategory(category)

A categoria do livro.

setCategory(category: string): void;

Parâmetros

category

string

Retornos

void

setComments(comments)

Os comentários do livro.

setComments(comments: string): void;

Parâmetros

comments

string

Retornos

void

setCompany(company)

A empresa do livro.

setCompany(company: string): void;

Parâmetros

company

string

Retornos

void

setKeywords(keywords)

As palavras-chave do livro.

setKeywords(keywords: string): void;

Parâmetros

keywords

string

Retornos

void

setManager(manager)

O gestor do livro.

setManager(manager: string): void;

Parâmetros

manager

string

Retornos

void

setRevisionNumber(revisionNumber)

Obtém o número de revisão da pasta de trabalho.

setRevisionNumber(revisionNumber: number): void;

Parâmetros

revisionNumber

number

Retornos

void

setSubject(subject)

O assunto do livro.

setSubject(subject: string): void;

Parâmetros

subject

string

Retornos

void

setTitle(title)

O título do livro.

setTitle(title: string): void;

Parâmetros

title

string

Retornos

void