Compartilhar via


Word.List class

Contém uma coleção de Word. Objetos de parágrafo.

Extends

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// This example starts a new list with the second paragraph.
await Word.run(async (context) => {
  const paragraphs: Word.ParagraphCollection = context.document.body.paragraphs;
  paragraphs.load("$none");

  await context.sync();

  // Start new list using the second paragraph.
  const list: Word.List = paragraphs.items[1].startNewList();
  list.load("$none");

  await context.sync();

  // To add new items to the list, use Start or End on the insertLocation parameter.
  list.insertParagraph("New list item at the start of the list", "Start");
  const paragraph: Word.Paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");

  // Set up list level for the list item.
  paragraph.listItem.level = 4;

  // To add paragraphs outside the list, use Before or After.
  list.insertParagraph("New paragraph goes after (not part of the list)", "After");

  await context.sync();
});

Propriedades

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

id

Obtém o ID da lista.

levelExistences

Verifica se cada um dos 9 níveis existe na lista. Um valor true indica que o nível existe, o que significa que há pelo menos um item de lista nesse nível.

levelTypes

Obtém todos os tipos de nível 9 na lista. Cada tipo pode ser "Bullet", "Number" ou "Picture".

paragraphs

Obtém parágrafos na lista.

Métodos

getLevelParagraphs(level)

Obtém os parágrafos que ocorrem no nível especificado na lista.

getLevelString(level)

Obtém a marca, número ou imagem no nível especificado como uma cadeia.

insertParagraph(paragraphText, insertLocation)

Insere um parágrafo no local especificado.

load(options)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

setLevelAlignment(level, alignment)

Define o alinhamento da marca, número ou imagem no nível especificado na lista.

setLevelAlignment(level, alignmentString)

Define o alinhamento da marca, número ou imagem no nível especificado na lista.

setLevelBullet(level, listBullet, charCode, fontName)

Define o formato de marcador no nível especificado na lista. Se o marcador é 'Custom', o charCode é necessário.

setLevelBullet(level, listBulletString, charCode, fontName)

Define o formato de marcador no nível especificado na lista. Se o marcador é 'Custom', o charCode é necessário.

setLevelIndents(level, textIndent, bulletNumberPictureIndent)

Define os dois recuos do nível especificado na lista.

setLevelNumbering(level, listNumbering, formatString)

Define o formato de numeração no nível especificado na lista.

setLevelNumbering(level, listNumberingString, formatString)

Define o formato de numeração no nível especificado na lista.

setLevelStartingNumber(level, startingNumber)

Define o número inicial no nível especificado na lista. O valor padrão é 1.

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Word.List é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.ListData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

Detalhes da propriedade

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

id

Obtém o ID da lista.

readonly id: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApi 1.3 ]

levelExistences

Verifica se cada um dos 9 níveis existe na lista. Um valor true indica que o nível existe, o que significa que há pelo menos um item de lista nesse nível.

readonly levelExistences: boolean[];

Valor da propriedade

boolean[]

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// Gets information about the first list in the document.
await Word.run(async (context) => {
  const lists: Word.ListCollection = context.document.body.lists;
  lists.load("items");

  await context.sync();

  if (lists.items.length === 0) {
    console.warn("There are no lists in this document.");
    return;
  }
  
  // Get the first list.
  const list: Word.List = lists.getFirst();
  list.load("levelTypes,levelExistences");

  await context.sync();

  const levelTypes  = list.levelTypes;
  console.log("Level types of the first list:");
  for (let i = 0; i < levelTypes.length; i++) {
    console.log(`- Level ${i + 1} (index ${i}): ${levelTypes[i]}`);
  }

  const levelExistences = list.levelExistences;
  console.log("Level existences of the first list:");
  for (let i = 0; i < levelExistences.length; i++) {
    console.log(`- Level ${i + 1} (index ${i}): ${levelExistences[i]}`);
  }
});

levelTypes

Obtém todos os tipos de nível 9 na lista. Cada tipo pode ser "Bullet", "Number" ou "Picture".

readonly levelTypes: Word.ListLevelType[];

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// Gets information about the first list in the document.
await Word.run(async (context) => {
  const lists: Word.ListCollection = context.document.body.lists;
  lists.load("items");

  await context.sync();

  if (lists.items.length === 0) {
    console.warn("There are no lists in this document.");
    return;
  }
  
  // Get the first list.
  const list: Word.List = lists.getFirst();
  list.load("levelTypes,levelExistences");

  await context.sync();

  const levelTypes  = list.levelTypes;
  console.log("Level types of the first list:");
  for (let i = 0; i < levelTypes.length; i++) {
    console.log(`- Level ${i + 1} (index ${i}): ${levelTypes[i]}`);
  }

  const levelExistences = list.levelExistences;
  console.log("Level existences of the first list:");
  for (let i = 0; i < levelExistences.length; i++) {
    console.log(`- Level ${i + 1} (index ${i}): ${levelExistences[i]}`);
  }
});

paragraphs

Obtém parágrafos na lista.

readonly paragraphs: Word.ParagraphCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

Detalhes do método

getLevelParagraphs(level)

Obtém os parágrafos que ocorrem no nível especificado na lista.

getLevelParagraphs(level: number): Word.ParagraphCollection;

Parâmetros

level

number

Obrigatório. O nível na lista.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getLevelString(level)

Obtém a marca, número ou imagem no nível especificado como uma cadeia.

getLevelString(level: number): OfficeExtension.ClientResult<string>;

Parâmetros

level

number

Obrigatório. O nível na lista.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

insertParagraph(paragraphText, insertLocation)

Insere um parágrafo no local especificado.

insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After"): Word.Paragraph;

Parâmetros

paragraphText

string

Obrigatório. O texto do parágrafo a ser inserido.

insertLocation

start | end | before | after | "Start" | "End" | "Before" | "After"

Obrigatório. O valor tem de ser "Iniciar", "Terminar", "Antes" ou "Depois".

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// This example starts a new list with the second paragraph.
await Word.run(async (context) => {
  const paragraphs: Word.ParagraphCollection = context.document.body.paragraphs;
  paragraphs.load("$none");

  await context.sync();

  // Start new list using the second paragraph.
  const list: Word.List = paragraphs.items[1].startNewList();
  list.load("$none");

  await context.sync();

  // To add new items to the list, use Start or End on the insertLocation parameter.
  list.insertParagraph("New list item at the start of the list", "Start");
  const paragraph: Word.Paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");

  // Set up list level for the list item.
  paragraph.listItem.level = 4;

  // To add paragraphs outside the list, use Before or After.
  list.insertParagraph("New paragraph goes after (not part of the list)", "After");

  await context.sync();
});

load(options)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: Word.Interfaces.ListLoadOptions): Word.List;

Parâmetros

options
Word.Interfaces.ListLoadOptions

Fornece opções para as propriedades do objeto a carregar.

Retornos

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

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

Parâmetros

propertyNames

string | string[]

Uma cadeia delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.

Retornos

load(propertyNamesAndPaths)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

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

Parâmetros

propertyNamesAndPaths

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

propertyNamesAndPaths.select é uma cadeia delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.

Retornos

setLevelAlignment(level, alignment)

Define o alinhamento da marca, número ou imagem no nível especificado na lista.

setLevelAlignment(level: number, alignment: Word.Alignment): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

alignment
Word.Alignment

Obrigatório. O alinhamento de nível que tem de ser "Esquerda", "Centrado" ou "Direita".

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setLevelAlignment(level, alignmentString)

Define o alinhamento da marca, número ou imagem no nível especificado na lista.

setLevelAlignment(level: number, alignmentString: "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

alignmentString

"Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"

Obrigatório. O alinhamento de nível que tem de ser "Esquerda", "Centrado" ou "Direita".

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setLevelBullet(level, listBullet, charCode, fontName)

Define o formato de marcador no nível especificado na lista. Se o marcador é 'Custom', o charCode é necessário.

setLevelBullet(level: number, listBullet: Word.ListBullet, charCode?: number, fontName?: string): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

listBullet
Word.ListBullet

Obrigatório. A bala.

charCode

number

Opcional. O valor de código do caráter de marca de lista. Utilizado apenas se a marca for "Personalizada".

fontName

string

Opcional. O nome do tipo de letra da marca. Utilizado apenas se a marca for "Personalizada".

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// Inserts a list starting with the first paragraph then set numbering and bullet types of the list items.
await Word.run(async (context) => {
  const paragraphs: Word.ParagraphCollection = context.document.body.paragraphs;
  paragraphs.load("$none");

  await context.sync();

  // Use the first paragraph to start a new list.
  const list: Word.List = paragraphs.items[0].startNewList();
  list.load("$none");

  await context.sync();

  // To add new items to the list, use Start or End on the insertLocation parameter.
  list.insertParagraph("New list item at the start of the list", "Start");
  const paragraph: Word.Paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");

  // Set numbering for list level 1.
  list.setLevelNumbering(0, Word.ListNumbering.arabic);

  // Set bullet type for list level 5.
  list.setLevelBullet(4, Word.ListBullet.arrow);

  // Set list level for the last item in this list.
  paragraph.listItem.level = 4;

  list.load("levelTypes");

  await context.sync();
});

setLevelBullet(level, listBulletString, charCode, fontName)

Define o formato de marcador no nível especificado na lista. Se o marcador é 'Custom', o charCode é necessário.

setLevelBullet(level: number, listBulletString: "Custom" | "Solid" | "Hollow" | "Square" | "Diamonds" | "Arrow" | "Checkmark", charCode?: number, fontName?: string): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

listBulletString

"Custom" | "Solid" | "Hollow" | "Square" | "Diamonds" | "Arrow" | "Checkmark"

Obrigatório. A bala.

charCode

number

Opcional. O valor de código do caráter de marca de lista. Utilizado apenas se a marca for "Personalizada".

fontName

string

Opcional. O nome do tipo de letra da marca. Utilizado apenas se a marca for "Personalizada".

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setLevelIndents(level, textIndent, bulletNumberPictureIndent)

Define os dois recuos do nível especificado na lista.

setLevelIndents(level: number, textIndent: number, bulletNumberPictureIndent: number): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

textIndent

number

Obrigatório. O avanço do texto em pontos. É o mesmo que o avanço do parágrafo à esquerda.

bulletNumberPictureIndent

number

Obrigatório. O avanço relativo, em pontos, da marca, número ou imagem. É igual ao avanço da primeira linha do parágrafo.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setLevelNumbering(level, listNumbering, formatString)

Define o formato de numeração no nível especificado na lista.

setLevelNumbering(level: number, listNumbering: Word.ListNumbering, formatString?: Array<string | number>): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

listNumbering
Word.ListNumbering

Obrigatório. O formato ordinal.

formatString

Array<string | number>

Opcional. O formato de cadeia de numeração definido como uma matriz de cadeias e/ou números inteiros. Cada número inteiro é um nível de tipo de número superior ou igual a este nível. Por exemplo, uma matriz de ["(", nível - 1, ".", nível, ")"] pode definir o formato de "(2.c)", em que 2 é o número do item principal e c é o número do item deste nível.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

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

// Inserts a list starting with the first paragraph then set numbering and bullet types of the list items.
await Word.run(async (context) => {
  const paragraphs: Word.ParagraphCollection = context.document.body.paragraphs;
  paragraphs.load("$none");

  await context.sync();

  // Use the first paragraph to start a new list.
  const list: Word.List = paragraphs.items[0].startNewList();
  list.load("$none");

  await context.sync();

  // To add new items to the list, use Start or End on the insertLocation parameter.
  list.insertParagraph("New list item at the start of the list", "Start");
  const paragraph: Word.Paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");

  // Set numbering for list level 1.
  list.setLevelNumbering(0, Word.ListNumbering.arabic);

  // Set bullet type for list level 5.
  list.setLevelBullet(4, Word.ListBullet.arrow);

  // Set list level for the last item in this list.
  paragraph.listItem.level = 4;

  list.load("levelTypes");

  await context.sync();
});

setLevelNumbering(level, listNumberingString, formatString)

Define o formato de numeração no nível especificado na lista.

setLevelNumbering(level: number, listNumberingString: "None" | "Arabic" | "UpperRoman" | "LowerRoman" | "UpperLetter" | "LowerLetter", formatString?: Array<string | number>): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

listNumberingString

"None" | "Arabic" | "UpperRoman" | "LowerRoman" | "UpperLetter" | "LowerLetter"

Obrigatório. O formato ordinal.

formatString

Array<string | number>

Opcional. O formato de cadeia de numeração definido como uma matriz de cadeias e/ou números inteiros. Cada número inteiro é um nível de tipo de número superior ou igual a este nível. Por exemplo, uma matriz de ["(", nível - 1, ".", nível, ")"] pode definir o formato de "(2.c)", em que 2 é o número do item principal e c é o número do item deste nível.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setLevelStartingNumber(level, startingNumber)

Define o número inicial no nível especificado na lista. O valor padrão é 1.

setLevelStartingNumber(level: number, startingNumber: number): void;

Parâmetros

level

number

Obrigatório. O nível na lista.

startingNumber

number

Obrigatório. O número com que começar.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Word.List é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.ListData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Word.Interfaces.ListData;

Retornos

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

track(): Word.List;

Retornos

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

untrack(): Word.List;

Retornos